@codefast/ui 0.5.0 → 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 +28 -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
@@ -7,9 +7,7 @@
7
7
  * ------------------------------------------------------------------------- */
8
8
 
9
9
  :root {
10
- /* ----------------------------------------------------------------------
11
- * Surfaces & semantic colors
12
- * ---------------------------------------------------------------------- */
10
+ /* ── Surfaces & semantic colors ────────────────────────────────────────────────────────────────────────────────── */
13
11
 
14
12
  --background: oklch(0.98 0 248); /* --color-slate-50 */
15
13
  --foreground: oklch(0.13 0.04 265); /* --color-slate-950 */
@@ -34,17 +32,13 @@
34
32
  --card: oklch(0.98 0 248); /* --color-slate-50 */
35
33
  --card-foreground: oklch(0.13 0.04 265); /* --color-slate-950 */
36
34
 
37
- /* ----------------------------------------------------------------------
38
- * Form & focus
39
- * ---------------------------------------------------------------------- */
35
+ /* ── Form & focus ──────────────────────────────────────────────────────────────────────────────────────────────── */
40
36
 
41
37
  --border: oklch(0.93 0.01 256); /* --color-slate-200 */
42
38
  --input: oklch(0.93 0.01 256); /* --color-slate-200 */
43
39
  --ring: oklch(0.71 0.04 257); /* --color-slate-400 */
44
40
 
45
- /* ----------------------------------------------------------------------
46
- * Sidebar
47
- * ---------------------------------------------------------------------- */
41
+ /* ── Sidebar ───────────────────────────────────────────────────────────────────────────────────────────────────── */
48
42
 
49
43
  --sidebar: oklch(0.98 0 248); /* --color-slate-50 */
50
44
  --sidebar-foreground: oklch(0.13 0.04 265); /* --color-slate-950 */
@@ -55,9 +49,7 @@
55
49
  --sidebar-border: oklch(0.93 0.01 256); /* --color-slate-200 */
56
50
  --sidebar-ring: oklch(0.71 0.04 257); /* --color-slate-400 */
57
51
 
58
- /* ----------------------------------------------------------------------
59
- * Charts
60
- * ---------------------------------------------------------------------- */
52
+ /* ── Charts ────────────────────────────────────────────────────────────────────────────────────────────────────── */
61
53
 
62
54
  --chart-1: oklch(0.646 0.222 41.116); /* --color-orange-600 */
63
55
  --chart-2: oklch(0.6 0.118 184.704); /* --color-teal-600 */
@@ -7,9 +7,7 @@
7
7
  * ------------------------------------------------------------------------- */
8
8
 
9
9
  :root {
10
- /* ----------------------------------------------------------------------
11
- * Surfaces & semantic colors
12
- * ---------------------------------------------------------------------- */
10
+ /* ── Surfaces & semantic colors ────────────────────────────────────────────────────────────────────────────────── */
13
11
 
14
12
  --background: oklch(1 0 0); /* --color-white */
15
13
  --foreground: oklch(0.147 0.004 49.25); /* --color-stone-950 */
@@ -34,17 +32,13 @@
34
32
  --card: oklch(1 0 0); /* --color-white */
35
33
  --card-foreground: oklch(0.147 0.004 49.25); /* --color-stone-950 */
36
34
 
37
- /* ----------------------------------------------------------------------
38
- * Form & focus
39
- * ---------------------------------------------------------------------- */
35
+ /* ── Form & focus ──────────────────────────────────────────────────────────────────────────────────────────────── */
40
36
 
41
37
  --border: oklch(0.923 0.003 48.717); /* --color-stone-200 */
42
38
  --input: oklch(0.923 0.003 48.717); /* --color-stone-200 */
43
39
  --ring: oklch(0.709 0.01 56.259); /* --color-stone-400 */
44
40
 
45
- /* ----------------------------------------------------------------------
46
- * Sidebar
47
- * ---------------------------------------------------------------------- */
41
+ /* ── Sidebar ───────────────────────────────────────────────────────────────────────────────────────────────────── */
48
42
 
49
43
  --sidebar: oklch(0.985 0.001 106.423); /* --color-stone-50 */
50
44
  --sidebar-foreground: oklch(0.147 0.004 49.25); /* --color-stone-950 */
@@ -55,9 +49,7 @@
55
49
  --sidebar-border: oklch(0.923 0.003 48.717); /* --color-stone-200 */
56
50
  --sidebar-ring: oklch(0.709 0.01 56.259); /* --color-stone-400 */
57
51
 
58
- /* ----------------------------------------------------------------------
59
- * Charts
60
- * ---------------------------------------------------------------------- */
52
+ /* ── Charts ────────────────────────────────────────────────────────────────────────────────────────────────────── */
61
53
 
62
54
  --chart-1: oklch(0.646 0.222 41.116); /* --color-orange-600 */
63
55
  --chart-2: oklch(0.6 0.118 184.704); /* --color-teal-600 */
@@ -7,9 +7,7 @@
7
7
  * ------------------------------------------------------------------------- */
8
8
 
9
9
  :root {
10
- /* ----------------------------------------------------------------------
11
- * Surfaces & semantic colors
12
- * ---------------------------------------------------------------------- */
10
+ /* ── Surfaces & semantic colors ────────────────────────────────────────────────────────────────────────────────── */
13
11
 
14
12
  --background: oklch(1 0 0); /* --color-zinc-50 */
15
13
  --foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -34,17 +32,13 @@
34
32
  --card: oklch(1 0 0); /* --color-zinc-50 */
35
33
  --card-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
36
34
 
37
- /* ----------------------------------------------------------------------
38
- * Form & focus
39
- * ---------------------------------------------------------------------- */
35
+ /* ── Form & focus ──────────────────────────────────────────────────────────────────────────────────────────────── */
40
36
 
41
37
  --border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
42
38
  --input: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
43
39
  --ring: oklch(0.78 0.13 182); /* --color-teal-400 */
44
40
 
45
- /* ----------------------------------------------------------------------
46
- * Sidebar
47
- * ---------------------------------------------------------------------- */
41
+ /* ── Sidebar ───────────────────────────────────────────────────────────────────────────────────────────────────── */
48
42
 
49
43
  --sidebar: oklch(0.985 0 0); /* --color-zinc-50 */
50
44
  --sidebar-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -55,9 +49,7 @@
55
49
  --sidebar-border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
56
50
  --sidebar-ring: oklch(0.78 0.13 182); /* --color-teal-400 */
57
51
 
58
- /* ----------------------------------------------------------------------
59
- * Charts
60
- * ---------------------------------------------------------------------- */
52
+ /* ── Charts ────────────────────────────────────────────────────────────────────────────────────────────────────── */
61
53
 
62
54
  --chart-1: oklch(0.85 0.13 181); /* --color-teal-300 */
63
55
  --chart-2: oklch(0.78 0.13 182); /* --color-teal-400 */
@@ -7,9 +7,7 @@
7
7
  * ------------------------------------------------------------------------- */
8
8
 
9
9
  :root {
10
- /* ----------------------------------------------------------------------
11
- * Surfaces & semantic colors
12
- * ---------------------------------------------------------------------- */
10
+ /* ── Surfaces & semantic colors ────────────────────────────────────────────────────────────────────────────────── */
13
11
 
14
12
  --background: oklch(1 0 0); /* --color-zinc-50 */
15
13
  --foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -34,17 +32,13 @@
34
32
  --card: oklch(1 0 0); /* --color-zinc-50 */
35
33
  --card-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
36
34
 
37
- /* ----------------------------------------------------------------------
38
- * Form & focus
39
- * ---------------------------------------------------------------------- */
35
+ /* ── Form & focus ──────────────────────────────────────────────────────────────────────────────────────────────── */
40
36
 
41
37
  --border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
42
38
  --input: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
43
39
  --ring: oklch(0.702 0.183 293.541); /* --color-violet-400 */
44
40
 
45
- /* ----------------------------------------------------------------------
46
- * Sidebar
47
- * ---------------------------------------------------------------------- */
41
+ /* ── Sidebar ───────────────────────────────────────────────────────────────────────────────────────────────────── */
48
42
 
49
43
  --sidebar: oklch(0.985 0 0); /* --color-zinc-50 */
50
44
  --sidebar-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -55,9 +49,7 @@
55
49
  --sidebar-border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
56
50
  --sidebar-ring: oklch(0.702 0.183 293.541); /* --color-violet-400 */
57
51
 
58
- /* ----------------------------------------------------------------------
59
- * Charts
60
- * ---------------------------------------------------------------------- */
52
+ /* ── Charts ────────────────────────────────────────────────────────────────────────────────────────────────────── */
61
53
 
62
54
  --chart-1: oklch(0.811 0.111 293.571); /* --color-violet-300 */
63
55
  --chart-2: oklch(0.606 0.25 292.717); /* --color-violet-500 */
@@ -7,9 +7,7 @@
7
7
  * ------------------------------------------------------------------------- */
8
8
 
9
9
  :root {
10
- /* ----------------------------------------------------------------------
11
- * Surfaces & semantic colors
12
- * ---------------------------------------------------------------------- */
10
+ /* ── Surfaces & semantic colors ────────────────────────────────────────────────────────────────────────────────── */
13
11
 
14
12
  --background: oklch(1 0 0); /* --color-zinc-50 */
15
13
  --foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -34,17 +32,13 @@
34
32
  --card: oklch(1 0 0); /* --color-zinc-50 */
35
33
  --card-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
36
34
 
37
- /* ----------------------------------------------------------------------
38
- * Form & focus
39
- * ---------------------------------------------------------------------- */
35
+ /* ── Form & focus ──────────────────────────────────────────────────────────────────────────────────────────────── */
40
36
 
41
37
  --border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
42
38
  --input: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
43
39
  --ring: oklch(0.852 0.199 91.936); /* --color-yellow-400 */
44
40
 
45
- /* ----------------------------------------------------------------------
46
- * Sidebar
47
- * ---------------------------------------------------------------------- */
41
+ /* ── Sidebar ───────────────────────────────────────────────────────────────────────────────────────────────────── */
48
42
 
49
43
  --sidebar: oklch(0.985 0 0); /* --color-zinc-50 */
50
44
  --sidebar-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -55,9 +49,7 @@
55
49
  --sidebar-border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
56
50
  --sidebar-ring: oklch(0.852 0.199 91.936); /* --color-yellow-400 */
57
51
 
58
- /* ----------------------------------------------------------------------
59
- * Charts
60
- * ---------------------------------------------------------------------- */
52
+ /* ── Charts ────────────────────────────────────────────────────────────────────────────────────────────────────── */
61
53
 
62
54
  --chart-1: oklch(0.905 0.182 98.111); /* --color-yellow-300 */
63
55
  --chart-2: oklch(0.795 0.184 86.047); /* --color-yellow-500 */
@@ -7,9 +7,7 @@
7
7
  * ------------------------------------------------------------------------- */
8
8
 
9
9
  :root {
10
- /* ----------------------------------------------------------------------
11
- * Surfaces & semantic colors
12
- * ---------------------------------------------------------------------- */
10
+ /* ── Surfaces & semantic colors ────────────────────────────────────────────────────────────────────────────────── */
13
11
 
14
12
  --background: oklch(1 0 0); /* --color-zinc-50 */
15
13
  --foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -34,17 +32,13 @@
34
32
  --card: oklch(1 0 0); /* --color-zinc-50 */
35
33
  --card-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
36
34
 
37
- /* ----------------------------------------------------------------------
38
- * Form & focus
39
- * ---------------------------------------------------------------------- */
35
+ /* ── Form & focus ──────────────────────────────────────────────────────────────────────────────────────────────── */
40
36
 
41
37
  --border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
42
38
  --input: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
43
39
  --ring: oklch(0.705 0.015 286.067); /* --color-zinc-400 */
44
40
 
45
- /* ----------------------------------------------------------------------
46
- * Sidebar
47
- * ---------------------------------------------------------------------- */
41
+ /* ── Sidebar ───────────────────────────────────────────────────────────────────────────────────────────────────── */
48
42
 
49
43
  --sidebar: oklch(0.985 0 0); /* --color-zinc-50 */
50
44
  --sidebar-foreground: oklch(0.141 0.005 285.823); /* --color-zinc-950 */
@@ -55,9 +49,7 @@
55
49
  --sidebar-border: oklch(0.92 0.004 286.32); /* --color-zinc-200 */
56
50
  --sidebar-ring: oklch(0.705 0.015 286.067); /* --color-zinc-400 */
57
51
 
58
- /* ----------------------------------------------------------------------
59
- * Charts
60
- * ---------------------------------------------------------------------- */
52
+ /* ── Charts ────────────────────────────────────────────────────────────────────────────────────────────────────── */
61
53
 
62
54
  --chart-1: oklch(0.646 0.222 41.116); /* --color-orange-600 */
63
55
  --chart-2: oklch(0.6 0.118 184.704); /* --color-teal-600 */
@@ -1,7 +1,7 @@
1
1
  import { useEffect, useRef, useState } from "react";
2
2
 
3
3
  /**
4
- * Produce a smoothly animated numeric value in response to changes.
4
+ * Produces a smoothly animated numeric value in response to changes.
5
5
  *
6
6
  * Applies a time-based easing (easeOutQuad) between the current and target values
7
7
  * over the specified duration. When disabled, the value updates immediately.
@@ -1,7 +1,7 @@
1
1
  import { useState } from "react";
2
2
 
3
3
  /**
4
- * Provide clipboard copy capability with a transient copied state.
4
+ * Provides clipboard copy capability with a transient copied state.
5
5
  *
6
6
  * Internally uses the Clipboard API when available and sets a temporary
7
7
  * `isCopied` flag for UI feedback. A custom callback may be invoked upon copy.
@@ -1,7 +1,7 @@
1
1
  import { useMediaQuery } from "#/hooks/use-media-query";
2
2
 
3
3
  /**
4
- * Determine whether the current viewport should be treated as mobile.
4
+ * Determines whether the current viewport should be treated as mobile.
5
5
  *
6
6
  * Uses {@link useMediaQuery} to evaluate a max-width media query derived from the
7
7
  * provided breakpoint. By default, widths below 768px are considered mobile.
@@ -58,7 +58,7 @@ export function useMediaQuery(query: string): boolean {
58
58
  mediaQueryList.addEventListener("change", onChange);
59
59
 
60
60
  /**
61
- * Remove the event listener on unmount or when the query changes.
61
+ * Removes the event listener on unmount or when the query changes.
62
62
  */
63
63
  return (): void => {
64
64
  mediaQueryList.removeEventListener("change", onChange);
@@ -12,10 +12,11 @@ import {
12
12
  import { AUTOSCROLLING_CLEAR_DELAY, SCROLL_POSITION_EPSILON } from "#/lib/message-scroller/types";
13
13
  import type { MessageScrollerScrollOptions } from "#/lib/message-scroller/types";
14
14
 
15
- // Imperative scroll primitives, split from the controller so the move mechanics
16
- // live apart from the policy that decides when to run them. Each command resolves
17
- // a target scrollTop and returns false when the viewport is not mounted yet.
18
15
  /**
16
+ * Imperative scroll primitives, split from the controller so the move mechanics
17
+ * live apart from the policy that decides when to run them. Each command resolves
18
+ * a target scrollTop and returns false when the viewport is not mounted yet.
19
+ *
19
20
  * @since 0.5.0-canary.3
20
21
  */
21
22
  function useMessageScrollerCommands({
@@ -48,10 +48,11 @@ function useElementRef(elementRef: RefObject<HTMLDivElement | null>, onMount: ()
48
48
  );
49
49
  }
50
50
 
51
- // Orchestrator hook. Decides when to scroll and delegates the moves to
52
- // useMessageScrollerCommands; state and visibility commits are coalesced on a
53
- // requestAnimationFrame and torn down on cleanup for StrictMode safety.
54
51
  /**
52
+ * Orchestrator hook. Decides when to scroll and delegates the moves to
53
+ * useMessageScrollerCommands; state and visibility commits are coalesced on a
54
+ * requestAnimationFrame and torn down on cleanup for StrictMode safety.
55
+ *
55
56
  * @since 0.5.0-canary.3
56
57
  */
57
58
  function useMessageScrollerController({
@@ -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