@codefast/ui 0.5.0-canary.9 → 0.6.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 (431) hide show
  1. package/CHANGELOG.md +76 -0
  2. package/README.md +24 -16
  3. package/dist/components/accordion.d.ts.map +1 -1
  4. package/dist/components/accordion.js +1 -3
  5. package/dist/components/accordion.js.map +1 -1
  6. package/dist/components/alert-dialog.d.ts.map +1 -1
  7. package/dist/components/alert-dialog.js +1 -3
  8. package/dist/components/alert-dialog.js.map +1 -1
  9. package/dist/components/alert.d.ts.map +1 -1
  10. package/dist/components/alert.js +1 -3
  11. package/dist/components/alert.js.map +1 -1
  12. package/dist/components/aspect-ratio.d.ts.map +1 -1
  13. package/dist/components/aspect-ratio.js +1 -3
  14. package/dist/components/aspect-ratio.js.map +1 -1
  15. package/dist/components/attachment.d.ts.map +1 -1
  16. package/dist/components/attachment.js +1 -3
  17. package/dist/components/attachment.js.map +1 -1
  18. package/dist/components/avatar.d.ts.map +1 -1
  19. package/dist/components/avatar.js +1 -3
  20. package/dist/components/avatar.js.map +1 -1
  21. package/dist/components/badge.d.ts.map +1 -1
  22. package/dist/components/badge.js +1 -3
  23. package/dist/components/badge.js.map +1 -1
  24. package/dist/components/breadcrumb.d.ts.map +1 -1
  25. package/dist/components/breadcrumb.js +1 -3
  26. package/dist/components/breadcrumb.js.map +1 -1
  27. package/dist/components/bubble.d.ts.map +1 -1
  28. package/dist/components/bubble.js +1 -3
  29. package/dist/components/bubble.js.map +1 -1
  30. package/dist/components/button-group.d.ts.map +1 -1
  31. package/dist/components/button-group.js +1 -3
  32. package/dist/components/button-group.js.map +1 -1
  33. package/dist/components/button.d.ts.map +1 -1
  34. package/dist/components/button.js +1 -3
  35. package/dist/components/button.js.map +1 -1
  36. package/dist/components/calendar.d.ts.map +1 -1
  37. package/dist/components/calendar.js +4 -12
  38. package/dist/components/calendar.js.map +1 -1
  39. package/dist/components/card.d.ts.map +1 -1
  40. package/dist/components/card.js +1 -3
  41. package/dist/components/card.js.map +1 -1
  42. package/dist/components/carousel.d.ts.map +1 -1
  43. package/dist/components/carousel.js +5 -15
  44. package/dist/components/carousel.js.map +1 -1
  45. package/dist/components/chart.d.ts.map +1 -1
  46. package/dist/components/chart.js +5 -15
  47. package/dist/components/chart.js.map +1 -1
  48. package/dist/components/checkbox-cards.d.ts.map +1 -1
  49. package/dist/components/checkbox-cards.js +1 -3
  50. package/dist/components/checkbox-cards.js.map +1 -1
  51. package/dist/components/checkbox-group.d.ts.map +1 -1
  52. package/dist/components/checkbox-group.js +1 -3
  53. package/dist/components/checkbox-group.js.map +1 -1
  54. package/dist/components/checkbox.d.ts.map +1 -1
  55. package/dist/components/checkbox.js +1 -3
  56. package/dist/components/checkbox.js.map +1 -1
  57. package/dist/components/collapsible.d.ts.map +1 -1
  58. package/dist/components/collapsible.js +1 -3
  59. package/dist/components/collapsible.js.map +1 -1
  60. package/dist/components/command.d.ts.map +1 -1
  61. package/dist/components/command.js +1 -3
  62. package/dist/components/command.js.map +1 -1
  63. package/dist/components/context-menu.d.ts.map +1 -1
  64. package/dist/components/context-menu.js +1 -3
  65. package/dist/components/context-menu.js.map +1 -1
  66. package/dist/components/dialog.d.ts.map +1 -1
  67. package/dist/components/dialog.js +1 -3
  68. package/dist/components/dialog.js.map +1 -1
  69. package/dist/components/direction.d.ts.map +1 -1
  70. package/dist/components/direction.js +1 -3
  71. package/dist/components/direction.js.map +1 -1
  72. package/dist/components/drawer.d.ts.map +1 -1
  73. package/dist/components/drawer.js +1 -3
  74. package/dist/components/drawer.js.map +1 -1
  75. package/dist/components/dropdown-menu.d.ts.map +1 -1
  76. package/dist/components/dropdown-menu.js +1 -3
  77. package/dist/components/dropdown-menu.js.map +1 -1
  78. package/dist/components/empty.d.ts.map +1 -1
  79. package/dist/components/empty.js +1 -3
  80. package/dist/components/empty.js.map +1 -1
  81. package/dist/components/field.d.ts.map +1 -1
  82. package/dist/components/field.js +1 -3
  83. package/dist/components/field.js.map +1 -1
  84. package/dist/components/form.d.ts.map +1 -1
  85. package/dist/components/form.js +5 -15
  86. package/dist/components/form.js.map +1 -1
  87. package/dist/components/hover-card.d.ts.map +1 -1
  88. package/dist/components/hover-card.js +1 -3
  89. package/dist/components/hover-card.js.map +1 -1
  90. package/dist/components/input-group.d.ts.map +1 -1
  91. package/dist/components/input-group.js +1 -3
  92. package/dist/components/input-group.js.map +1 -1
  93. package/dist/components/input-number.d.ts.map +1 -1
  94. package/dist/components/input-number.js +1 -3
  95. package/dist/components/input-number.js.map +1 -1
  96. package/dist/components/input-otp.d.ts.map +1 -1
  97. package/dist/components/input-otp.js +1 -3
  98. package/dist/components/input-otp.js.map +1 -1
  99. package/dist/components/input-password.d.ts.map +1 -1
  100. package/dist/components/input-password.js +1 -3
  101. package/dist/components/input-password.js.map +1 -1
  102. package/dist/components/input-search.d.ts.map +1 -1
  103. package/dist/components/input-search.js +1 -3
  104. package/dist/components/input-search.js.map +1 -1
  105. package/dist/components/input.d.ts.map +1 -1
  106. package/dist/components/input.js +1 -3
  107. package/dist/components/input.js.map +1 -1
  108. package/dist/components/item.d.ts.map +1 -1
  109. package/dist/components/item.js +1 -3
  110. package/dist/components/item.js.map +1 -1
  111. package/dist/components/kbd.d.ts.map +1 -1
  112. package/dist/components/kbd.js +1 -3
  113. package/dist/components/kbd.js.map +1 -1
  114. package/dist/components/label.d.ts.map +1 -1
  115. package/dist/components/label.js +1 -3
  116. package/dist/components/label.js.map +1 -1
  117. package/dist/components/marker.d.ts.map +1 -1
  118. package/dist/components/marker.js +1 -3
  119. package/dist/components/marker.js.map +1 -1
  120. package/dist/components/menubar.d.ts.map +1 -1
  121. package/dist/components/menubar.js +1 -3
  122. package/dist/components/menubar.js.map +1 -1
  123. package/dist/components/message-scroller.d.ts.map +1 -1
  124. package/dist/components/message-scroller.js +1 -3
  125. package/dist/components/message-scroller.js.map +1 -1
  126. package/dist/components/message.d.ts.map +1 -1
  127. package/dist/components/message.js +1 -3
  128. package/dist/components/message.js.map +1 -1
  129. package/dist/components/native-select.d.ts.map +1 -1
  130. package/dist/components/native-select.js +1 -3
  131. package/dist/components/native-select.js.map +1 -1
  132. package/dist/components/navigation-menu.d.ts.map +1 -1
  133. package/dist/components/navigation-menu.js +1 -3
  134. package/dist/components/navigation-menu.js.map +1 -1
  135. package/dist/components/pagination.d.ts.map +1 -1
  136. package/dist/components/pagination.js +1 -3
  137. package/dist/components/pagination.js.map +1 -1
  138. package/dist/components/popover.d.ts.map +1 -1
  139. package/dist/components/popover.js +1 -3
  140. package/dist/components/popover.js.map +1 -1
  141. package/dist/components/progress-circle.d.ts.map +1 -1
  142. package/dist/components/progress-circle.js +3 -7
  143. package/dist/components/progress-circle.js.map +1 -1
  144. package/dist/components/progress.d.ts.map +1 -1
  145. package/dist/components/progress.js +1 -3
  146. package/dist/components/progress.js.map +1 -1
  147. package/dist/components/radio-cards.d.ts.map +1 -1
  148. package/dist/components/radio-cards.js +1 -3
  149. package/dist/components/radio-cards.js.map +1 -1
  150. package/dist/components/radio-group.d.ts.map +1 -1
  151. package/dist/components/radio-group.js +1 -3
  152. package/dist/components/radio-group.js.map +1 -1
  153. package/dist/components/radio.d.ts.map +1 -1
  154. package/dist/components/radio.js +1 -3
  155. package/dist/components/radio.js.map +1 -1
  156. package/dist/components/resizable.d.ts.map +1 -1
  157. package/dist/components/resizable.js +1 -3
  158. package/dist/components/resizable.js.map +1 -1
  159. package/dist/components/scroll-area.d.ts.map +1 -1
  160. package/dist/components/scroll-area.js +2 -6
  161. package/dist/components/scroll-area.js.map +1 -1
  162. package/dist/components/select.d.ts.map +1 -1
  163. package/dist/components/select.js +1 -3
  164. package/dist/components/select.js.map +1 -1
  165. package/dist/components/separator.d.ts.map +1 -1
  166. package/dist/components/separator.js +1 -3
  167. package/dist/components/separator.js.map +1 -1
  168. package/dist/components/sheet.d.ts.map +1 -1
  169. package/dist/components/sheet.js +1 -3
  170. package/dist/components/sheet.js.map +1 -1
  171. package/dist/components/sidebar.d.ts +3 -0
  172. package/dist/components/sidebar.d.ts.map +1 -1
  173. package/dist/components/sidebar.js +9 -20
  174. package/dist/components/sidebar.js.map +1 -1
  175. package/dist/components/skeleton.d.ts.map +1 -1
  176. package/dist/components/skeleton.js +1 -3
  177. package/dist/components/skeleton.js.map +1 -1
  178. package/dist/components/slider.d.ts.map +1 -1
  179. package/dist/components/slider.js +1 -3
  180. package/dist/components/slider.js.map +1 -1
  181. package/dist/components/sonner.d.ts.map +1 -1
  182. package/dist/components/sonner.js +1 -3
  183. package/dist/components/sonner.js.map +1 -1
  184. package/dist/components/spinner.d.ts.map +1 -1
  185. package/dist/components/spinner.js +2 -6
  186. package/dist/components/spinner.js.map +1 -1
  187. package/dist/components/switch.d.ts.map +1 -1
  188. package/dist/components/switch.js +1 -3
  189. package/dist/components/switch.js.map +1 -1
  190. package/dist/components/table.d.ts.map +1 -1
  191. package/dist/components/table.js +1 -3
  192. package/dist/components/table.js.map +1 -1
  193. package/dist/components/tabs.d.ts.map +1 -1
  194. package/dist/components/tabs.js +1 -3
  195. package/dist/components/tabs.js.map +1 -1
  196. package/dist/components/textarea.d.ts.map +1 -1
  197. package/dist/components/textarea.js +1 -3
  198. package/dist/components/textarea.js.map +1 -1
  199. package/dist/components/toggle-group.d.ts.map +1 -1
  200. package/dist/components/toggle-group.js +3 -9
  201. package/dist/components/toggle-group.js.map +1 -1
  202. package/dist/components/toggle.d.ts.map +1 -1
  203. package/dist/components/toggle.js +1 -3
  204. package/dist/components/toggle.js.map +1 -1
  205. package/dist/components/tooltip.d.ts.map +1 -1
  206. package/dist/components/tooltip.js +1 -3
  207. package/dist/components/tooltip.js.map +1 -1
  208. package/dist/hooks/use-animated-value.d.ts +1 -1
  209. package/dist/hooks/use-animated-value.js +1 -1
  210. package/dist/hooks/use-copy-to-clipboard.d.ts +1 -1
  211. package/dist/hooks/use-copy-to-clipboard.js +1 -1
  212. package/dist/hooks/use-is-mobile.d.ts +1 -1
  213. package/dist/hooks/use-is-mobile.js +1 -1
  214. package/dist/hooks/use-media-query.js +1 -1
  215. package/dist/hooks/use-message-scroller-commands.d.ts +4 -0
  216. package/dist/hooks/use-message-scroller-commands.d.ts.map +1 -1
  217. package/dist/hooks/use-message-scroller-commands.js +4 -3
  218. package/dist/hooks/use-message-scroller-commands.js.map +1 -1
  219. package/dist/hooks/use-message-scroller-controller.d.ts +4 -0
  220. package/dist/hooks/use-message-scroller-controller.d.ts.map +1 -1
  221. package/dist/hooks/use-message-scroller-controller.js +4 -3
  222. package/dist/hooks/use-message-scroller-controller.js.map +1 -1
  223. package/dist/hooks/use-message-scroller-refs.d.ts +7 -0
  224. package/dist/hooks/use-message-scroller-refs.d.ts.map +1 -1
  225. package/dist/hooks/use-message-scroller-refs.js +3 -2
  226. package/dist/hooks/use-message-scroller-refs.js.map +1 -1
  227. package/dist/hooks/use-pagination.d.ts +1 -1
  228. package/dist/hooks/use-pagination.js +1 -1
  229. package/dist/lib/message-scroller/types.d.ts +66 -0
  230. package/dist/lib/message-scroller/types.d.ts.map +1 -1
  231. package/dist/lib/message-scroller/types.js +23 -14
  232. package/dist/lib/message-scroller/types.js.map +1 -1
  233. package/dist/lib/use-render.d.ts +1 -1
  234. package/dist/lib/use-render.js +1 -1
  235. package/dist/primitives/checkbox-group.d.ts.map +1 -1
  236. package/dist/primitives/checkbox-group.js +3 -9
  237. package/dist/primitives/checkbox-group.js.map +1 -1
  238. package/dist/primitives/input-number.d.ts.map +1 -1
  239. package/dist/primitives/input-number.js +5 -15
  240. package/dist/primitives/input-number.js.map +1 -1
  241. package/dist/primitives/input.d.ts.map +1 -1
  242. package/dist/primitives/input.js +3 -9
  243. package/dist/primitives/input.js.map +1 -1
  244. package/dist/primitives/progress-circle.d.ts.map +1 -1
  245. package/dist/primitives/progress-circle.js +7 -21
  246. package/dist/primitives/progress-circle.js.map +1 -1
  247. package/dist/variants/alert.d.ts.map +1 -1
  248. package/dist/variants/alert.js +2 -6
  249. package/dist/variants/alert.js.map +1 -1
  250. package/dist/variants/attachment.d.ts.map +1 -1
  251. package/dist/variants/attachment.js +3 -9
  252. package/dist/variants/attachment.js.map +1 -1
  253. package/dist/variants/badge.d.ts.map +1 -1
  254. package/dist/variants/badge.js +2 -6
  255. package/dist/variants/badge.js.map +1 -1
  256. package/dist/variants/bubble.d.ts.map +1 -1
  257. package/dist/variants/bubble.js +3 -9
  258. package/dist/variants/bubble.js.map +1 -1
  259. package/dist/variants/button-group.d.ts.map +1 -1
  260. package/dist/variants/button-group.js +2 -6
  261. package/dist/variants/button-group.js.map +1 -1
  262. package/dist/variants/button.d.ts.map +1 -1
  263. package/dist/variants/button.js +2 -6
  264. package/dist/variants/button.js.map +1 -1
  265. package/dist/variants/empty.d.ts.map +1 -1
  266. package/dist/variants/empty.js +2 -6
  267. package/dist/variants/empty.js.map +1 -1
  268. package/dist/variants/field.d.ts.map +1 -1
  269. package/dist/variants/field.js +2 -6
  270. package/dist/variants/field.js.map +1 -1
  271. package/dist/variants/input-group.d.ts.map +1 -1
  272. package/dist/variants/input-group.js +4 -12
  273. package/dist/variants/input-group.js.map +1 -1
  274. package/dist/variants/item.d.ts.map +1 -1
  275. package/dist/variants/item.js +3 -9
  276. package/dist/variants/item.js.map +1 -1
  277. package/dist/variants/marker.d.ts.map +1 -1
  278. package/dist/variants/marker.js +2 -6
  279. package/dist/variants/marker.js.map +1 -1
  280. package/dist/variants/navigation-menu.d.ts.map +1 -1
  281. package/dist/variants/navigation-menu.js +2 -6
  282. package/dist/variants/navigation-menu.js.map +1 -1
  283. package/dist/variants/progress-circle.d.ts.map +1 -1
  284. package/dist/variants/progress-circle.js +2 -6
  285. package/dist/variants/progress-circle.js.map +1 -1
  286. package/dist/variants/scroll-area.d.ts.map +1 -1
  287. package/dist/variants/scroll-area.js +2 -6
  288. package/dist/variants/scroll-area.js.map +1 -1
  289. package/dist/variants/separator.d.ts.map +1 -1
  290. package/dist/variants/separator.js +2 -6
  291. package/dist/variants/separator.js.map +1 -1
  292. package/dist/variants/sheet.d.ts.map +1 -1
  293. package/dist/variants/sheet.js +2 -6
  294. package/dist/variants/sheet.js.map +1 -1
  295. package/dist/variants/sidebar.d.ts.map +1 -1
  296. package/dist/variants/sidebar.js +2 -6
  297. package/dist/variants/sidebar.js.map +1 -1
  298. package/dist/variants/tabs.d.ts.map +1 -1
  299. package/dist/variants/tabs.js +2 -6
  300. package/dist/variants/tabs.js.map +1 -1
  301. package/dist/variants/toggle.d.ts.map +1 -1
  302. package/dist/variants/toggle.js +2 -6
  303. package/dist/variants/toggle.js.map +1 -1
  304. package/package.json +11 -10
  305. package/src/components/accordion.tsx +5 -15
  306. package/src/components/alert-dialog.tsx +12 -36
  307. package/src/components/alert.tsx +5 -15
  308. package/src/components/aspect-ratio.tsx +2 -6
  309. package/src/components/attachment.tsx +10 -30
  310. package/src/components/avatar.tsx +7 -21
  311. package/src/components/badge.tsx +2 -6
  312. package/src/components/breadcrumb.tsx +8 -24
  313. package/src/components/bubble.tsx +5 -15
  314. package/src/components/button-group.tsx +4 -12
  315. package/src/components/button.tsx +2 -6
  316. package/src/components/calendar.tsx +6 -18
  317. package/src/components/card.tsx +8 -24
  318. package/src/components/carousel.tsx +7 -21
  319. package/src/components/chart.tsx +11 -33
  320. package/src/components/checkbox-cards.tsx +3 -9
  321. package/src/components/checkbox-group.tsx +3 -9
  322. package/src/components/checkbox.tsx +2 -6
  323. package/src/components/collapsible.tsx +4 -12
  324. package/src/components/command.tsx +11 -33
  325. package/src/components/context-menu.tsx +16 -48
  326. package/src/components/dialog.tsx +10 -30
  327. package/src/components/direction.tsx +2 -6
  328. package/src/components/drawer.tsx +9 -27
  329. package/src/components/dropdown-menu.tsx +16 -48
  330. package/src/components/empty.tsx +7 -21
  331. package/src/components/field.tsx +11 -33
  332. package/src/components/form.tsx +10 -30
  333. package/src/components/hover-card.tsx +5 -15
  334. package/src/components/input-group.tsx +7 -21
  335. package/src/components/input-number.tsx +6 -18
  336. package/src/components/input-otp.tsx +5 -15
  337. package/src/components/input-password.tsx +2 -6
  338. package/src/components/input-search.tsx +2 -6
  339. package/src/components/input.tsx +2 -6
  340. package/src/components/item.tsx +11 -33
  341. package/src/components/kbd.tsx +2 -6
  342. package/src/components/label.tsx +2 -6
  343. package/src/components/marker.tsx +4 -12
  344. package/src/components/menubar.tsx +17 -51
  345. package/src/components/message-scroller.tsx +7 -21
  346. package/src/components/message.tsx +7 -21
  347. package/src/components/native-select.tsx +4 -12
  348. package/src/components/navigation-menu.tsx +9 -27
  349. package/src/components/pagination.tsx +8 -24
  350. package/src/components/popover.tsx +9 -27
  351. package/src/components/progress-circle.tsx +4 -10
  352. package/src/components/progress.tsx +2 -6
  353. package/src/components/radio-cards.tsx +3 -9
  354. package/src/components/radio-group.tsx +3 -9
  355. package/src/components/radio.tsx +2 -6
  356. package/src/components/resizable.tsx +4 -12
  357. package/src/components/scroll-area.tsx +4 -12
  358. package/src/components/select.tsx +11 -33
  359. package/src/components/separator.tsx +3 -9
  360. package/src/components/sheet.tsx +10 -30
  361. package/src/components/sidebar.tsx +28 -77
  362. package/src/components/skeleton.tsx +2 -6
  363. package/src/components/slider.tsx +2 -6
  364. package/src/components/sonner.tsx +2 -6
  365. package/src/components/spinner.tsx +2 -6
  366. package/src/components/switch.tsx +2 -6
  367. package/src/components/table.tsx +9 -27
  368. package/src/components/tabs.tsx +5 -15
  369. package/src/components/textarea.tsx +2 -6
  370. package/src/components/toggle-group.tsx +4 -12
  371. package/src/components/toggle.tsx +2 -6
  372. package/src/components/tooltip.tsx +6 -18
  373. package/src/css/foundation/base.css +3 -9
  374. package/src/css/foundation/motion.css +2 -6
  375. package/src/css/foundation/tokens.css +6 -18
  376. package/src/css/foundation/variants.css +3 -9
  377. package/src/css/themes/amber.css +4 -12
  378. package/src/css/themes/blue.css +4 -12
  379. package/src/css/themes/cyan.css +4 -12
  380. package/src/css/themes/emerald.css +4 -12
  381. package/src/css/themes/fuchsia.css +4 -12
  382. package/src/css/themes/gray.css +4 -12
  383. package/src/css/themes/green.css +4 -12
  384. package/src/css/themes/indigo.css +4 -12
  385. package/src/css/themes/lime.css +4 -12
  386. package/src/css/themes/neutral.css +4 -12
  387. package/src/css/themes/orange.css +4 -12
  388. package/src/css/themes/pink.css +4 -12
  389. package/src/css/themes/purple.css +4 -12
  390. package/src/css/themes/red.css +4 -12
  391. package/src/css/themes/rose.css +4 -12
  392. package/src/css/themes/sky.css +4 -12
  393. package/src/css/themes/slate.css +4 -12
  394. package/src/css/themes/stone.css +4 -12
  395. package/src/css/themes/teal.css +4 -12
  396. package/src/css/themes/violet.css +4 -12
  397. package/src/css/themes/yellow.css +4 -12
  398. package/src/css/themes/zinc.css +4 -12
  399. package/src/hooks/use-animated-value.ts +1 -1
  400. package/src/hooks/use-copy-to-clipboard.ts +1 -1
  401. package/src/hooks/use-is-mobile.ts +1 -1
  402. package/src/hooks/use-media-query.ts +1 -1
  403. package/src/hooks/use-message-scroller-commands.ts +4 -3
  404. package/src/hooks/use-message-scroller-controller.ts +4 -3
  405. package/src/hooks/use-message-scroller-refs.ts +7 -5
  406. package/src/hooks/use-pagination.ts +1 -1
  407. package/src/lib/message-scroller/types.ts +66 -39
  408. package/src/lib/use-render.ts +1 -1
  409. package/src/primitives/checkbox-group.tsx +5 -15
  410. package/src/primitives/input-number.tsx +8 -24
  411. package/src/primitives/input.tsx +3 -9
  412. package/src/primitives/progress-circle.tsx +9 -27
  413. package/src/variants/alert.ts +2 -6
  414. package/src/variants/attachment.ts +3 -9
  415. package/src/variants/badge.ts +2 -6
  416. package/src/variants/bubble.ts +3 -9
  417. package/src/variants/button-group.ts +2 -6
  418. package/src/variants/button.ts +2 -6
  419. package/src/variants/empty.ts +2 -6
  420. package/src/variants/field.ts +2 -6
  421. package/src/variants/input-group.ts +4 -12
  422. package/src/variants/item.ts +3 -9
  423. package/src/variants/marker.ts +2 -6
  424. package/src/variants/navigation-menu.ts +2 -6
  425. package/src/variants/progress-circle.ts +2 -6
  426. package/src/variants/scroll-area.ts +2 -6
  427. package/src/variants/separator.ts +2 -6
  428. package/src/variants/sheet.ts +2 -6
  429. package/src/variants/sidebar.ts +2 -6
  430. package/src/variants/tabs.ts +2 -6
  431. package/src/variants/toggle.ts +2 -6
@@ -15,10 +15,11 @@ import type {
15
15
  MessageScrollerVisibilityStore,
16
16
  } from "#/lib/message-scroller/types";
17
17
 
18
- // Shared mutable ref bag for one MessageScroller, closed over by both the
19
- // controller and the commands so writes are visible across them without prop
20
- // threading. stateStore and visibilityStore fan out via useSyncExternalStore.
21
18
  /**
19
+ * Shared mutable ref bag for one MessageScroller, closed over by both the
20
+ * controller and the commands so writes are visible across them without prop
21
+ * threading. stateStore and visibilityStore fan out via useSyncExternalStore.
22
+ *
22
23
  * @since 0.5.0-canary.3
23
24
  */
24
25
  type MessageScrollerRefs = {
@@ -59,9 +60,10 @@ type MessageScrollerRefs = {
59
60
  handledScrollAnchorsRef: RefObject<WeakSet<HTMLElement>>;
60
61
  };
61
62
 
62
- // Builds the per-instance ref bag: the two external stores constructed once, and
63
- // the latest prop values mirrored onto refs each render so callbacks stay stable.
64
63
  /**
64
+ * Builds the per-instance ref bag: the two external stores constructed once, and
65
+ * the latest prop values mirrored onto refs each render so callbacks stay stable.
66
+ *
65
67
  * @since 0.5.0-canary.3
66
68
  */
67
69
  function useMessageScrollerRefs({
@@ -44,7 +44,7 @@ const createRange = (start: number, end: number): Array<number> => {
44
44
  };
45
45
 
46
46
  /**
47
- * Compute a pagination structure for result sets.
47
+ * Computes a pagination structure for result sets.
48
48
  *
49
49
  * Returns a mixed array of page numbers and the `ELLIPSIS` marker representing
50
50
  * collapsed ranges. The shape adapts to the total pages and the requested
@@ -2,42 +2,48 @@ import type { ComponentProps, ReactNode, RefObject } from "react";
2
2
 
3
3
  import type { UseRenderComponentProps } from "#/lib/use-render";
4
4
 
5
- // Default scrollEdgeThreshold. Sub-pixel tolerance so edge detection does not
6
- // flicker across engines that round scrollTop differently.
7
5
  /**
6
+ * Default scrollEdgeThreshold. Sub-pixel tolerance so edge detection does not
7
+ * flicker across engines that round scrollTop differently.
8
+ *
8
9
  * @since 0.5.0-canary.3
9
10
  */
10
11
  const DEFAULT_SCROLL_EDGE_THRESHOLD = 8;
11
12
 
12
- // Default scrollPreviousItemPeek. Pixels of the previous item kept visible above
13
- // a newly anchored row.
14
13
  /**
14
+ * Default scrollPreviousItemPeek. Pixels of the previous item kept visible above
15
+ * a newly anchored row.
16
+ *
15
17
  * @since 0.5.0-canary.3
16
18
  */
17
19
  const DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK = 64;
18
20
 
19
- // Default scrollMargin for scrollToMessage and programmatic targets.
20
21
  /**
22
+ * Default scrollMargin for scrollToMessage and programmatic targets.
23
+ *
21
24
  * @since 0.5.0-canary.3
22
25
  */
23
26
  const DEFAULT_SCROLL_MARGIN = 0;
24
27
 
25
- // Two fractional scrollTop values within this range are treated as equal, to
26
- // absorb zoom and HiDPI rounding drift.
27
28
  /**
29
+ * Two fractional scrollTop values within this range are treated as equal, to
30
+ * absorb zoom and HiDPI rounding drift.
31
+ *
28
32
  * @since 0.5.0-canary.3
29
33
  */
30
34
  const SCROLL_POSITION_EPSILON = 0.5;
31
35
 
32
- // How long (ms) data-autoscrolling stays set during a programmatic smooth scroll
33
- // before clearing.
34
36
  /**
37
+ * How long (ms) data-autoscrolling stays set during a programmatic smooth scroll
38
+ * before clearing.
39
+ *
35
40
  * @since 0.5.0-canary.3
36
41
  */
37
42
  const AUTOSCROLLING_CLEAR_DELAY = 180;
38
43
 
39
- // Viewport keys that count as deliberate scroll intent and release follow-bottom.
40
44
  /**
45
+ * Viewport keys that count as deliberate scroll intent and release follow-bottom.
46
+ *
41
47
  * @since 0.5.0-canary.3
42
48
  */
43
49
  const USER_SCROLL_KEYS = new Set([
@@ -50,9 +56,10 @@ const USER_SCROLL_KEYS = new Set([
50
56
  " ", // Space key.
51
57
  ]);
52
58
 
53
- // Internal scroll mode. Derived from intent and commands; decides how the
54
- // viewport reacts to content and resize.
55
59
  /**
60
+ * Internal scroll mode. Derived from intent and commands; decides how the
61
+ * viewport reacts to content and resize.
62
+ *
56
63
  * @since 0.5.0-canary.3
57
64
  */
58
65
  type MessageScrollerMode =
@@ -61,26 +68,30 @@ type MessageScrollerMode =
61
68
  | "anchored-to-message" // holding a turn at the reading line while it streams.
62
69
  | "settling-jump"; // a programmatic jump is animating; intent detection suppressed until it settles.
63
70
 
64
- // Where a saved transcript opens on the first non-empty render.
65
71
  /**
72
+ * Where a saved transcript opens on the first non-empty render.
73
+ *
66
74
  * @since 0.5.0-canary.3
67
75
  */
68
76
  type MessageScrollerDefaultScrollPosition = "start" | "end" | "last-anchor";
69
77
 
70
- // Which transcript edge MessageScrollerButton scrolls toward.
71
78
  /**
79
+ * Which transcript edge MessageScrollerButton scrolls toward.
80
+ *
72
81
  * @since 0.5.0-canary.3
73
82
  */
74
83
  type MessageScrollerButtonDirection = "start" | "end";
75
84
 
76
- // Viewport alignment for scrollToMessage and programmatic jumps.
77
85
  /**
86
+ * Viewport alignment for scrollToMessage and programmatic jumps.
87
+ *
78
88
  * @since 0.5.0-canary.3
79
89
  */
80
90
  type MessageScrollerScrollAlign = "start" | "center" | "end" | "nearest";
81
91
 
82
- // Options for scrollToMessage, scrollToEnd, and scrollToStart.
83
92
  /**
93
+ * Options for scrollToMessage, scrollToEnd, and scrollToStart.
94
+ *
84
95
  * @since 0.5.0-canary.3
85
96
  */
86
97
  type MessageScrollerScrollOptions = {
@@ -92,9 +103,10 @@ type MessageScrollerScrollOptions = {
92
103
  scrollMargin?: number;
93
104
  };
94
105
 
95
- // Scroll snapshot from useMessageScrollerScrollable: which edges the viewport can
96
- // still scroll toward.
97
106
  /**
107
+ * Scroll snapshot from useMessageScrollerScrollable: which edges the viewport can
108
+ * still scroll toward.
109
+ *
98
110
  * @since 0.5.0-canary.3
99
111
  */
100
112
  type MessageScrollerScrollable = {
@@ -104,8 +116,9 @@ type MessageScrollerScrollable = {
104
116
  end: boolean;
105
117
  };
106
118
 
107
- // Visibility snapshot from useMessageScrollerVisibility.
108
119
  /**
120
+ * Visibility snapshot from useMessageScrollerVisibility.
121
+ *
109
122
  * @since 0.5.0-canary.3
110
123
  */
111
124
  type MessageScrollerVisibilityState = {
@@ -116,9 +129,10 @@ type MessageScrollerVisibilityState = {
116
129
  visibleMessageIds: Array<string>;
117
130
  };
118
131
 
119
- // Headless provider for a chat transcript scroller. Owns scroll behavior and
120
- // state; renders no DOM.
121
132
  /**
133
+ * Headless provider for a chat transcript scroller. Owns scroll behavior and
134
+ * state; renders no DOM.
135
+ *
122
136
  * @since 0.5.0-canary.3
123
137
  */
124
138
  type MessageScrollerProviderProps = {
@@ -135,15 +149,17 @@ type MessageScrollerProviderProps = {
135
149
  scrollMargin?: number;
136
150
  };
137
151
 
138
- // Frame container for a chat transcript scroller. Must render inside a
139
- // MessageScrollerProvider.
140
152
  /**
153
+ * Frame container for a chat transcript scroller. Must render inside a
154
+ * MessageScrollerProvider.
155
+ *
141
156
  * @since 0.5.0-canary.3
142
157
  */
143
158
  type MessageScrollerProps = ComponentProps<"div">;
144
159
 
145
- // Scrollable viewport. Owns native scroll events and prepend preservation.
146
160
  /**
161
+ * Scrollable viewport. Owns native scroll events and prepend preservation.
162
+ *
147
163
  * @since 0.5.0-canary.3
148
164
  */
149
165
  type MessageScrollerViewportProps = ComponentProps<"div"> & {
@@ -151,8 +167,9 @@ type MessageScrollerViewportProps = ComponentProps<"div"> & {
151
167
  preserveScrollOnPrepend?: boolean;
152
168
  };
153
169
 
154
- // Transcript row container. Every direct child should be a MessageScrollerItem.
155
170
  /**
171
+ * Transcript row container. Every direct child should be a MessageScrollerItem.
172
+ *
156
173
  * @since 0.5.0-canary.3
157
174
  */
158
175
  type MessageScrollerContentProps = ComponentProps<"div"> & {
@@ -160,8 +177,9 @@ type MessageScrollerContentProps = ComponentProps<"div"> & {
160
177
  spacerClassName?: string;
161
178
  };
162
179
 
163
- // One transcript row: a message, marker, typing row, separator, or load-more row.
164
180
  /**
181
+ * One transcript row: a message, marker, typing row, separator, or load-more row.
182
+ *
165
183
  * @since 0.5.0-canary.3
166
184
  */
167
185
  type MessageScrollerItemProps = ComponentProps<"div"> & {
@@ -171,8 +189,9 @@ type MessageScrollerItemProps = ComponentProps<"div"> & {
171
189
  isScrollAnchor?: boolean;
172
190
  };
173
191
 
174
- // State passed to MessageScrollerButton's render prop.
175
192
  /**
193
+ * State passed to MessageScrollerButton's render prop.
194
+ *
176
195
  * @since 0.5.0-canary.3
177
196
  */
178
197
  type MessageScrollerButtonRenderState = {
@@ -181,8 +200,9 @@ type MessageScrollerButtonRenderState = {
181
200
  direction: MessageScrollerButtonDirection;
182
201
  };
183
202
 
184
- // Scroll control for the start or end of the transcript.
185
203
  /**
204
+ * Scroll control for the start or end of the transcript.
205
+ *
186
206
  * @since 0.5.0-canary.3
187
207
  */
188
208
  type MessageScrollerButtonProps = UseRenderComponentProps<"button", MessageScrollerButtonRenderState> & {
@@ -192,9 +212,10 @@ type MessageScrollerButtonProps = UseRenderComponentProps<"button", MessageScrol
192
212
  direction?: MessageScrollerButtonDirection;
193
213
  };
194
214
 
195
- // Minimal external store backing useMessageScrollerScrollable, consumed via
196
- // useSyncExternalStore.
197
215
  /**
216
+ * Minimal external store backing useMessageScrollerScrollable, consumed via
217
+ * useSyncExternalStore.
218
+ *
198
219
  * @since 0.5.0-canary.3
199
220
  */
200
221
  type MessageScrollerStore<T> = {
@@ -203,9 +224,10 @@ type MessageScrollerStore<T> = {
203
224
  subscribe: (listener: () => void) => () => void;
204
225
  };
205
226
 
206
- // External store backing useMessageScrollerVisibility. Adds reference-counting so
207
- // tracking stays lazy.
208
227
  /**
228
+ * External store backing useMessageScrollerVisibility. Adds reference-counting so
229
+ * tracking stays lazy.
230
+ *
209
231
  * @since 0.5.0-canary.3
210
232
  */
211
233
  type MessageScrollerVisibilityStore = {
@@ -215,9 +237,10 @@ type MessageScrollerVisibilityStore = {
215
237
  subscribe: (listener: () => void, onFirstSubscribe: () => void, onLastUnsubscribe: () => void) => () => void;
216
238
  };
217
239
 
218
- // Registers (or, with removedElement, unregisters) a MessageScrollerItem node by
219
- // messageId.
220
240
  /**
241
+ * Registers (or, with removedElement, unregisters) a MessageScrollerItem node by
242
+ * messageId.
243
+ *
221
244
  * @since 0.5.0-canary.3
222
245
  */
223
246
  type MessageScrollerRegisterMessage = (
@@ -226,8 +249,9 @@ type MessageScrollerRegisterMessage = (
226
249
  removedElement?: HTMLElement | null,
227
250
  ) => void;
228
251
 
229
- // Internal context wiring the parts together. Not part of the public API.
230
252
  /**
253
+ * Internal context wiring the parts together. Not part of the public API.
254
+ *
231
255
  * @since 0.5.0-canary.3
232
256
  */
233
257
  type MessageScrollerContextValue = {
@@ -250,9 +274,10 @@ type MessageScrollerContextValue = {
250
274
  visibilityStore: MessageScrollerVisibilityStore;
251
275
  };
252
276
 
253
- // Initial MessageScrollerScrollable before measurement. Stable reference for the
254
- // server and first-render snapshot.
255
277
  /**
278
+ * Initial MessageScrollerScrollable before measurement. Stable reference for the
279
+ * server and first-render snapshot.
280
+ *
256
281
  * @since 0.5.0-canary.3
257
282
  */
258
283
  const EMPTY_MESSAGE_SCROLLER_SCROLLABLE: MessageScrollerScrollable = {
@@ -260,14 +285,16 @@ const EMPTY_MESSAGE_SCROLLER_SCROLLABLE: MessageScrollerScrollable = {
260
285
  end: false,
261
286
  };
262
287
 
263
- // Shared empty array so empty visibility snapshots stay referentially stable.
264
288
  /**
289
+ * Shared empty array so empty visibility snapshots stay referentially stable.
290
+ *
265
291
  * @since 0.5.0-canary.3
266
292
  */
267
293
  const EMPTY_VISIBLE_MESSAGE_IDS: Array<string> = [];
268
294
 
269
- // Initial MessageScrollerVisibilityState. Nothing tracked, no current anchor.
270
295
  /**
296
+ * Initial MessageScrollerVisibilityState. Nothing tracked, no current anchor.
297
+ *
271
298
  * @since 0.5.0-canary.3
272
299
  */
273
300
  const EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE: MessageScrollerVisibilityState = {
@@ -158,7 +158,7 @@ function getStateAttributes<TState extends RenderState>(
158
158
  }
159
159
 
160
160
  /**
161
- * Resolve a component's `render` prop: a default element, a render function, or
161
+ * Resolves a component's `render` prop: a default element, a render function, or
162
162
  * a cloned element, merging computed state attributes and props/refs/handlers.
163
163
  *
164
164
  * @since 0.5.0-canary.3
@@ -6,9 +6,7 @@ import { useControllableState } from "radix-ui/internal";
6
6
  import type { ComponentProps, JSX } from "react";
7
7
  import { useCallback } from "react";
8
8
 
9
- /* -----------------------------------------------------------------------------
10
- * Context: CheckboxGroup
11
- * --------------------------------------------------------------------------- */
9
+ // ── Context: CheckboxGroup ───────────────────────────────────────────────────────────────────────────────────────────
12
10
 
13
11
  const CHECKBOX_GROUP_NAME = "CheckboxGroup";
14
12
 
@@ -70,9 +68,7 @@ interface CheckboxGroupContextValue {
70
68
  const [CheckboxGroupContextProvider, useCheckboxGroupContext] =
71
69
  createCheckboxGroupContext<CheckboxGroupContextValue>(CHECKBOX_GROUP_NAME);
72
70
 
73
- /* -----------------------------------------------------------------------------
74
- * Component: CheckboxGroup
75
- * --------------------------------------------------------------------------- */
71
+ // ── Component: CheckboxGroup ─────────────────────────────────────────────────────────────────────────────────────────
76
72
 
77
73
  /**
78
74
  * Base props for the CheckboxGroup component
@@ -218,9 +214,7 @@ function CheckboxGroup({
218
214
  );
219
215
  }
220
216
 
221
- /* -----------------------------------------------------------------------------
222
- * Component: CheckboxGroupItem
223
- * --------------------------------------------------------------------------- */
217
+ // ── Component: CheckboxGroupItem ─────────────────────────────────────────────────────────────────────────────────────
224
218
  const ITEM_NAME = "CheckboxGroupItem";
225
219
 
226
220
  /**
@@ -300,9 +294,7 @@ function CheckboxGroupItem({
300
294
  );
301
295
  }
302
296
 
303
- /* -----------------------------------------------------------------------------
304
- * Component: CheckboxGroupIndicator
305
- * --------------------------------------------------------------------------- */
297
+ // ── Component: CheckboxGroupIndicator ────────────────────────────────────────────────────────────────────────────────
306
298
 
307
299
  /**
308
300
  * Props for the CheckboxGroupIndicator component
@@ -328,9 +320,7 @@ function CheckboxGroupIndicator({
328
320
  return <CheckboxPrimitive.Indicator {...checkboxScope} {...props} />;
329
321
  }
330
322
 
331
- /* -----------------------------------------------------------------------------
332
- * Exports
333
- * -------------------------------------------------------------------------- */
323
+ // ── Exports ──────────────────────────────────────────────────────────────────────────────────────────────────────────
334
324
 
335
325
  export {
336
326
  CheckboxGroup,
@@ -16,9 +16,7 @@ import { useCallback, useEffect, useMemo, useRef } from "react";
16
16
  import * as InputPrimitive from "#/primitives/input";
17
17
  import { createInputScope } from "#/primitives/input";
18
18
 
19
- /* -----------------------------------------------------------------------------
20
- * Context: InputNumber
21
- * -------------------------------------------------------------------------- */
19
+ // ── Context: InputNumber ─────────────────────────────────────────────────────────────────────────────────────────────
22
20
 
23
21
  /**
24
22
  * The name of the InputNumber component constant.
@@ -143,9 +141,7 @@ interface InputNumberContextValue {
143
141
  const [InputNumberContextProvider, useInputNumberContext] =
144
142
  createInputNumberContext<InputNumberContextValue>(NUMBER_INPUT_NAME);
145
143
 
146
- /* -----------------------------------------------------------------------------
147
- * Component: InputNumber
148
- * -------------------------------------------------------------------------- */
144
+ // ── Component: InputNumber ───────────────────────────────────────────────────────────────────────────────────────────
149
145
 
150
146
  /**
151
147
  * Props for the main InputNumber component.
@@ -386,9 +382,7 @@ function InputNumber(numberInputProps: ScopedProps<InputNumberProps>): JSX.Eleme
386
382
  );
387
383
  }
388
384
 
389
- /* -----------------------------------------------------------------------------
390
- * Component: InputNumberField
391
- * -------------------------------------------------------------------------- */
385
+ // ── Component: InputNumberField ──────────────────────────────────────────────────────────────────────────────────────
392
386
 
393
387
  /**
394
388
  * The name of the InputNumberField component constant.
@@ -711,9 +705,7 @@ function InputNumberField({
711
705
  );
712
706
  }
713
707
 
714
- /* -----------------------------------------------------------------------------
715
- * Component: NumberStepperButton
716
- * -------------------------------------------------------------------------- */
708
+ // ── Component: NumberStepperButton ───────────────────────────────────────────────────────────────────────────────────
717
709
 
718
710
  /**
719
711
  * The name of the NumberStepperButton component constant.
@@ -853,9 +845,7 @@ function NumberStepperButton({
853
845
  );
854
846
  }
855
847
 
856
- /* -----------------------------------------------------------------------------
857
- * Component: InputNumberIncrementButton
858
- * -------------------------------------------------------------------------- */
848
+ // ── Component: InputNumberIncrementButton ────────────────────────────────────────────────────────────────────────────
859
849
 
860
850
  /**
861
851
  * @since 0.3.16-canary.0
@@ -869,9 +859,7 @@ function InputNumberIncrementButton(props: InputNumberIncrementButtonProps): JSX
869
859
  return <NumberStepperButton operation="increment" {...props} />;
870
860
  }
871
861
 
872
- /* -----------------------------------------------------------------------------
873
- * Component: InputNumberDecrementButton
874
- * -------------------------------------------------------------------------- */
862
+ // ── Component: InputNumberDecrementButton ────────────────────────────────────────────────────────────────────────────
875
863
 
876
864
  /**
877
865
  * @since 0.3.16-canary.0
@@ -885,9 +873,7 @@ function InputNumberDecrementButton(props: InputNumberDecrementButtonProps): JSX
885
873
  return <NumberStepperButton operation="decrement" {...props} />;
886
874
  }
887
875
 
888
- /* -----------------------------------------------------------------------------
889
- * Utility Functions
890
- * -------------------------------------------------------------------------- */
876
+ // ── Utility Functions ────────────────────────────────────────────────────────────────────────────────────────────────
891
877
 
892
878
  /**
893
879
  * Chains multiple callbacks into a single function
@@ -1022,9 +1008,7 @@ function roundToStep(value: number, step: number): number {
1022
1008
  return Number(value.toFixed(fractionDigits));
1023
1009
  }
1024
1010
 
1025
- /* -----------------------------------------------------------------------------
1026
- * Exports
1027
- * -------------------------------------------------------------------------- */
1011
+ // ── Exports ──────────────────────────────────────────────────────────────────────────────────────────────────────────
1028
1012
 
1029
1013
  export {
1030
1014
  createInputNumberScope,
@@ -3,9 +3,7 @@ import { Context } from "radix-ui/internal";
3
3
  import type { ComponentProps, JSX, PointerEventHandler, PropsWithChildren, ReactNode, RefObject } from "react";
4
4
  import { useRef } from "react";
5
5
 
6
- /* -----------------------------------------------------------------------------
7
- * Component: Input
8
- * -------------------------------------------------------------------------- */
6
+ // ── Component: Input ─────────────────────────────────────────────────────────────────────────────────────────────────
9
7
 
10
8
  const INPUT_NAME = "Input";
11
9
 
@@ -188,9 +186,7 @@ function Input(inputProps: ScopedProps<InputProps>): JSX.Element {
188
186
  );
189
187
  }
190
188
 
191
- /* -----------------------------------------------------------------------------
192
- * Component: InputField
193
- * -------------------------------------------------------------------------- */
189
+ // ── Component: InputField ────────────────────────────────────────────────────────────────────────────────────────────
194
190
 
195
191
  const INPUT_FIELD_NAME = "InputField";
196
192
 
@@ -218,9 +214,7 @@ function InputField({ __scopeInput, ...props }: ScopedProps<InputFieldProps>): J
218
214
  return <input ref={composedInputRef} disabled={disabled} readOnly={readOnly} type="text" {...props} />;
219
215
  }
220
216
 
221
- /* -----------------------------------------------------------------------------
222
- * Exports
223
- * -------------------------------------------------------------------------- */
217
+ // ── Exports ──────────────────────────────────────────────────────────────────────────────────────────────────────────
224
218
 
225
219
  export { createInputScope, InputField as Field, Input, InputField, Input as Root };
226
220
 
@@ -2,9 +2,7 @@ import { Context } from "radix-ui/internal";
2
2
  import type { ComponentProps, ReactNode } from "react";
3
3
  import { useId, useMemo } from "react";
4
4
 
5
- /* -----------------------------------------------------------------------------
6
- * Context: ProgressCircleProvider
7
- * --------------------------------------------------------------------------- */
5
+ // ── Context: ProgressCircleProvider ──────────────────────────────────────────────────────────────────────────────────
8
6
 
9
7
  const PROGRESS_CIRCLE_PROVIDER_NAME = "ProgressCircleProvider";
10
8
 
@@ -111,9 +109,7 @@ const [createProgressCircleContext, createProgressCircleScope] =
111
109
  const [ProgressCircleContextProvider, useProgressCircleContext] =
112
110
  createProgressCircleContext<ProgressCircleContextValue>(PROGRESS_CIRCLE_PROVIDER_NAME);
113
111
 
114
- /* -----------------------------------------------------------------------------
115
- * Component: ProgressCircleProvider
116
- * --------------------------------------------------------------------------- */
112
+ // ── Component: ProgressCircleProvider ────────────────────────────────────────────────────────────────────────────────
117
113
 
118
114
  /**
119
115
  * @since 0.3.16-canary.0
@@ -287,9 +283,7 @@ function ProgressCircleProvider({
287
283
  );
288
284
  }
289
285
 
290
- /* -----------------------------------------------------------------------------
291
- * Component: ProgressCircle
292
- * --------------------------------------------------------------------------- */
286
+ // ── Component: ProgressCircle ────────────────────────────────────────────────────────────────────────────────────────
293
287
 
294
288
  /**
295
289
  * @since 0.3.16-canary.0
@@ -307,9 +301,7 @@ function ProgressCircle({ __scopeProgressCircle, ...props }: ScopedProps<Progres
307
301
  return <div {...props} />;
308
302
  }
309
303
 
310
- /* -----------------------------------------------------------------------------
311
- * Component: ProgressCircleSVG
312
- * --------------------------------------------------------------------------- */
304
+ // ── Component: ProgressCircleSVG ─────────────────────────────────────────────────────────────────────────────────────
313
305
 
314
306
  const PROGRESS_CIRCLE_SVG_NAME = "ProgressCircleSVG";
315
307
 
@@ -348,9 +340,7 @@ function ProgressCircleSVG({ __scopeProgressCircle, ...props }: ScopedProps<Prog
348
340
  );
349
341
  }
350
342
 
351
- /* -----------------------------------------------------------------------------
352
- * Component: ProgressCircleTrack
353
- * --------------------------------------------------------------------------- */
343
+ // ── Component: ProgressCircleTrack ───────────────────────────────────────────────────────────────────────────────────
354
344
 
355
345
  const PROGRESS_CIRCLE_TRACK_NAME = "ProgressCircleTrack";
356
346
 
@@ -385,9 +375,7 @@ function ProgressCircleTrack({ __scopeProgressCircle, ...props }: ScopedProps<Pr
385
375
  );
386
376
  }
387
377
 
388
- /* -----------------------------------------------------------------------------
389
- * Component: ProgressCircleIndicator
390
- * --------------------------------------------------------------------------- */
378
+ // ── Component: ProgressCircleIndicator ───────────────────────────────────────────────────────────────────────────────
391
379
 
392
380
  const PROGRESS_CIRCLE_INDICATOR_NAME = "ProgressCircleIndicator";
393
381
 
@@ -427,9 +415,7 @@ function ProgressCircleIndicator({
427
415
  );
428
416
  }
429
417
 
430
- /* -----------------------------------------------------------------------------
431
- * Component: ProgressCircleValue
432
- * --------------------------------------------------------------------------- */
418
+ // ── Component: ProgressCircleValue ───────────────────────────────────────────────────────────────────────────────────
433
419
 
434
420
  const PROGRESS_CIRCLE_VALUE_NAME = "ProgressCircleValue";
435
421
 
@@ -461,9 +447,7 @@ function ProgressCircleValue({
461
447
  return <div {...props}>{children ?? valueText}</div>;
462
448
  }
463
449
 
464
- /* -----------------------------------------------------------------------------
465
- * Helpers
466
- * -------------------------------------------------------------------------- */
450
+ // ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────
467
451
 
468
452
  /**
469
453
  * Clamps a value within a specified min/max range
@@ -477,9 +461,7 @@ function clamp(min: number, max: number, value: number): number {
477
461
  return Math.min(max, Math.max(min, value));
478
462
  }
479
463
 
480
- /* -----------------------------------------------------------------------------
481
- * Exports
482
- * -------------------------------------------------------------------------- */
464
+ // ── Exports ──────────────────────────────────────────────────────────────────────────────────────────────────────────
483
465
 
484
466
  export {
485
467
  createProgressCircleScope,
@@ -1,9 +1,7 @@
1
1
  import type { VariantProps } from "#/lib/utils";
2
2
  import { tv } from "#/lib/utils";
3
3
 
4
- /* -----------------------------------------------------------------------------
5
- * Variant: Alert
6
- * -------------------------------------------------------------------------- */
4
+ // ── Variant: Alert ───────────────────────────────────────────────────────────────────────────────────────────────────
7
5
 
8
6
  /**
9
7
  * @since 0.3.16-canary.0
@@ -26,9 +24,7 @@ const alertVariants = tv({
26
24
  */
27
25
  type AlertVariants = VariantProps<typeof alertVariants>;
28
26
 
29
- /* -----------------------------------------------------------------------------
30
- * Exports
31
- * -------------------------------------------------------------------------- */
27
+ // ── Exports ──────────────────────────────────────────────────────────────────────────────────────────────────────────
32
28
 
33
29
  export { alertVariants };
34
30
  export type { AlertVariants };
@@ -1,9 +1,7 @@
1
1
  import type { VariantProps } from "#/lib/utils";
2
2
  import { tv } from "#/lib/utils";
3
3
 
4
- /* -----------------------------------------------------------------------------
5
- * Variant: Attachment
6
- * -------------------------------------------------------------------------- */
4
+ // ── Variant: Attachment ──────────────────────────────────────────────────────────────────────────────────────────────
7
5
 
8
6
  /**
9
7
  * File/media attachment card. Size drives padding for the media and content
@@ -36,9 +34,7 @@ const attachmentVariants = tv({
36
34
  */
37
35
  type AttachmentVariants = VariantProps<typeof attachmentVariants>;
38
36
 
39
- /* -----------------------------------------------------------------------------
40
- * Variant: AttachmentMedia
41
- * -------------------------------------------------------------------------- */
37
+ // ── Variant: AttachmentMedia ─────────────────────────────────────────────────────────────────────────────────────────
42
38
 
43
39
  /**
44
40
  * Media thumbnail — an icon tile or a cover image that reacts to attachment
@@ -65,9 +61,7 @@ const attachmentMediaVariants = tv({
65
61
  */
66
62
  type AttachmentMediaVariants = VariantProps<typeof attachmentMediaVariants>;
67
63
 
68
- /* -----------------------------------------------------------------------------
69
- * Exports
70
- * -------------------------------------------------------------------------- */
64
+ // ── Exports ──────────────────────────────────────────────────────────────────────────────────────────────────────────
71
65
 
72
66
  export { attachmentMediaVariants, attachmentVariants };
73
67
  export type { AttachmentMediaVariants, AttachmentVariants };