@appica/ui-react 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (511) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/README.md +47 -5
  3. package/agent-rules.md +41 -0
  4. package/appica.css +7 -0
  5. package/dist/components/accordion/accordion.d.ts +24 -0
  6. package/dist/components/accordion/accordion.d.ts.map +1 -1
  7. package/dist/components/accordion/accordion.js +2 -1
  8. package/dist/components/accordion/accordion.js.map +1 -1
  9. package/dist/components/alert/alert.d.ts +30 -2
  10. package/dist/components/alert/alert.d.ts.map +1 -1
  11. package/dist/components/alert/alert.js +2 -1
  12. package/dist/components/alert/alert.js.map +1 -1
  13. package/dist/components/alert-dialog/alert-dialog.d.ts +12 -2
  14. package/dist/components/alert-dialog/alert-dialog.d.ts.map +1 -1
  15. package/dist/components/alert-dialog/alert-dialog.js +10 -5
  16. package/dist/components/alert-dialog/alert-dialog.js.map +1 -1
  17. package/dist/components/autocomplete/autocomplete.d.ts +21 -1
  18. package/dist/components/autocomplete/autocomplete.d.ts.map +1 -1
  19. package/dist/components/autocomplete/autocomplete.js +3 -2
  20. package/dist/components/autocomplete/autocomplete.js.map +1 -1
  21. package/dist/components/avatar/avatar.d.ts +17 -1
  22. package/dist/components/avatar/avatar.d.ts.map +1 -1
  23. package/dist/components/avatar/avatar.js +2 -1
  24. package/dist/components/avatar/avatar.js.map +1 -1
  25. package/dist/components/background-pattern/background-pattern-interactive.d.ts +2 -1
  26. package/dist/components/background-pattern/background-pattern-interactive.d.ts.map +1 -1
  27. package/dist/components/background-pattern/background-pattern-interactive.js +4 -2
  28. package/dist/components/background-pattern/background-pattern-interactive.js.map +1 -1
  29. package/dist/components/background-pattern/background-pattern-shared.d.ts +3 -2
  30. package/dist/components/background-pattern/background-pattern-shared.d.ts.map +1 -1
  31. package/dist/components/background-pattern/background-pattern-shared.js +48 -16
  32. package/dist/components/background-pattern/background-pattern-shared.js.map +1 -1
  33. package/dist/components/background-pattern/background-pattern.d.ts +13 -5
  34. package/dist/components/background-pattern/background-pattern.d.ts.map +1 -1
  35. package/dist/components/background-pattern/background-pattern.js +13 -4
  36. package/dist/components/background-pattern/background-pattern.js.map +1 -1
  37. package/dist/components/background-pattern/index.js +1 -0
  38. package/dist/components/background-pattern/index.js.map +1 -1
  39. package/dist/components/badge/badge.d.ts +13 -3
  40. package/dist/components/badge/badge.d.ts.map +1 -1
  41. package/dist/components/badge/badge.js +2 -1
  42. package/dist/components/badge/badge.js.map +1 -1
  43. package/dist/components/border-beam/border-beam.d.ts +52 -0
  44. package/dist/components/border-beam/border-beam.d.ts.map +1 -0
  45. package/dist/components/border-beam/border-beam.js +68 -0
  46. package/dist/components/border-beam/border-beam.js.map +1 -0
  47. package/dist/components/breadcrumb/breadcrumb.d.ts +8 -0
  48. package/dist/components/breadcrumb/breadcrumb.d.ts.map +1 -1
  49. package/dist/components/breadcrumb/breadcrumb.js +2 -1
  50. package/dist/components/breadcrumb/breadcrumb.js.map +1 -1
  51. package/dist/components/button/button-variants.d.ts +2 -2
  52. package/dist/components/button/button-variants.js +2 -1
  53. package/dist/components/button/button-variants.js.map +1 -1
  54. package/dist/components/button/button.d.ts +11 -1
  55. package/dist/components/button/button.d.ts.map +1 -1
  56. package/dist/components/button/button.js +2 -1
  57. package/dist/components/button/button.js.map +1 -1
  58. package/dist/components/button/index.js +1 -0
  59. package/dist/components/button/index.js.map +1 -1
  60. package/dist/components/button-group/button-group-context.js +1 -0
  61. package/dist/components/button-group/button-group-context.js.map +1 -1
  62. package/dist/components/button-group/button-group.d.ts +10 -0
  63. package/dist/components/button-group/button-group.d.ts.map +1 -1
  64. package/dist/components/button-group/button-group.js +2 -1
  65. package/dist/components/button-group/button-group.js.map +1 -1
  66. package/dist/components/calendar/calendar.d.ts +5 -0
  67. package/dist/components/calendar/calendar.d.ts.map +1 -1
  68. package/dist/components/calendar/calendar.js +2 -1
  69. package/dist/components/calendar/calendar.js.map +1 -1
  70. package/dist/components/card/card.d.ts +43 -0
  71. package/dist/components/card/card.d.ts.map +1 -0
  72. package/dist/components/card/card.js +104 -0
  73. package/dist/components/card/card.js.map +1 -0
  74. package/dist/components/carousel/carousel.d.ts +106 -6
  75. package/dist/components/carousel/carousel.d.ts.map +1 -1
  76. package/dist/components/carousel/carousel.js +180 -5
  77. package/dist/components/carousel/carousel.js.map +1 -1
  78. package/dist/components/checkbox/checkbox.js +2 -1
  79. package/dist/components/checkbox/checkbox.js.map +1 -1
  80. package/dist/components/checkbox-group/checkbox-group.d.ts +4 -0
  81. package/dist/components/checkbox-group/checkbox-group.d.ts.map +1 -1
  82. package/dist/components/checkbox-group/checkbox-group.js +2 -1
  83. package/dist/components/checkbox-group/checkbox-group.js.map +1 -1
  84. package/dist/components/chip/chip.d.ts +33 -1
  85. package/dist/components/chip/chip.d.ts.map +1 -1
  86. package/dist/components/chip/chip.js +2 -1
  87. package/dist/components/chip/chip.js.map +1 -1
  88. package/dist/components/collapsible/collapsible.js +2 -1
  89. package/dist/components/collapsible/collapsible.js.map +1 -1
  90. package/dist/components/color-area/color-area.d.ts +53 -0
  91. package/dist/components/color-area/color-area.d.ts.map +1 -0
  92. package/dist/components/color-area/color-area.js +246 -0
  93. package/dist/components/color-area/color-area.js.map +1 -0
  94. package/dist/components/color-picker/color-picker.d.ts +152 -0
  95. package/dist/components/color-picker/color-picker.d.ts.map +1 -0
  96. package/dist/components/color-picker/color-picker.js +328 -0
  97. package/dist/components/color-picker/color-picker.js.map +1 -0
  98. package/dist/components/color-slider/color-slider.d.ts +48 -0
  99. package/dist/components/color-slider/color-slider.d.ts.map +1 -0
  100. package/dist/components/color-slider/color-slider.js +217 -0
  101. package/dist/components/color-slider/color-slider.js.map +1 -0
  102. package/dist/components/color-swatch/color-swatch.d.ts +47 -0
  103. package/dist/components/color-swatch/color-swatch.d.ts.map +1 -0
  104. package/dist/components/color-swatch/color-swatch.js +67 -0
  105. package/dist/components/color-swatch/color-swatch.js.map +1 -0
  106. package/dist/components/color-swatch-picker/color-swatch-picker.d.ts +62 -0
  107. package/dist/components/color-swatch-picker/color-swatch-picker.d.ts.map +1 -0
  108. package/dist/components/color-swatch-picker/color-swatch-picker.js +203 -0
  109. package/dist/components/color-swatch-picker/color-swatch-picker.js.map +1 -0
  110. package/dist/components/combobox/combobox.d.ts +25 -1
  111. package/dist/components/combobox/combobox.d.ts.map +1 -1
  112. package/dist/components/combobox/combobox.js +3 -2
  113. package/dist/components/combobox/combobox.js.map +1 -1
  114. package/dist/components/context-menu/context-menu.d.ts +7 -1
  115. package/dist/components/context-menu/context-menu.d.ts.map +1 -1
  116. package/dist/components/context-menu/context-menu.js +11 -5
  117. package/dist/components/context-menu/context-menu.js.map +1 -1
  118. package/dist/components/copy-button/copy-button.d.ts +18 -1
  119. package/dist/components/copy-button/copy-button.d.ts.map +1 -1
  120. package/dist/components/copy-button/copy-button.js +6 -5
  121. package/dist/components/copy-button/copy-button.js.map +1 -1
  122. package/dist/components/countdown/countdown.d.ts +14 -0
  123. package/dist/components/countdown/countdown.d.ts.map +1 -1
  124. package/dist/components/countdown/countdown.js +2 -1
  125. package/dist/components/countdown/countdown.js.map +1 -1
  126. package/dist/components/date-field/date-field.d.ts +35 -0
  127. package/dist/components/date-field/date-field.d.ts.map +1 -1
  128. package/dist/components/date-field/date-field.js +2 -1
  129. package/dist/components/date-field/date-field.js.map +1 -1
  130. package/dist/components/date-picker/date-picker.d.ts +94 -0
  131. package/dist/components/date-picker/date-picker.d.ts.map +1 -1
  132. package/dist/components/date-picker/date-picker.js +2 -1
  133. package/dist/components/date-picker/date-picker.js.map +1 -1
  134. package/dist/components/dialog/dialog.d.ts +20 -2
  135. package/dist/components/dialog/dialog.d.ts.map +1 -1
  136. package/dist/components/dialog/dialog.js +9 -4
  137. package/dist/components/dialog/dialog.js.map +1 -1
  138. package/dist/components/drawer/drawer.d.ts +22 -2
  139. package/dist/components/drawer/drawer.d.ts.map +1 -1
  140. package/dist/components/drawer/drawer.js +14 -7
  141. package/dist/components/drawer/drawer.js.map +1 -1
  142. package/dist/components/dropdown-menu/dropdown-menu.d.ts +7 -1
  143. package/dist/components/dropdown-menu/dropdown-menu.d.ts.map +1 -1
  144. package/dist/components/dropdown-menu/dropdown-menu.js +11 -5
  145. package/dist/components/dropdown-menu/dropdown-menu.js.map +1 -1
  146. package/dist/components/field/field.js +2 -1
  147. package/dist/components/field/field.js.map +1 -1
  148. package/dist/components/fieldset/fieldset.js +2 -1
  149. package/dist/components/fieldset/fieldset.js.map +1 -1
  150. package/dist/components/form/form.js +1 -0
  151. package/dist/components/form/form.js.map +1 -1
  152. package/dist/components/gradient-glow/gradient-glow.d.ts +51 -1
  153. package/dist/components/gradient-glow/gradient-glow.d.ts.map +1 -1
  154. package/dist/components/gradient-glow/gradient-glow.js +5 -3
  155. package/dist/components/gradient-glow/gradient-glow.js.map +1 -1
  156. package/dist/components/input/index.js +1 -0
  157. package/dist/components/input/index.js.map +1 -1
  158. package/dist/components/input/input-variants.d.ts +1 -1
  159. package/dist/components/input/input-variants.js +2 -1
  160. package/dist/components/input/input-variants.js.map +1 -1
  161. package/dist/components/input/input.d.ts +21 -1
  162. package/dist/components/input/input.d.ts.map +1 -1
  163. package/dist/components/input/input.js +4 -3
  164. package/dist/components/input/input.js.map +1 -1
  165. package/dist/components/kbd/kbd.d.ts +8 -0
  166. package/dist/components/kbd/kbd.d.ts.map +1 -1
  167. package/dist/components/kbd/kbd.js +2 -1
  168. package/dist/components/kbd/kbd.js.map +1 -1
  169. package/dist/components/loader/loader.d.ts +8 -0
  170. package/dist/components/loader/loader.d.ts.map +1 -1
  171. package/dist/components/loader/loader.js +2 -1
  172. package/dist/components/loader/loader.js.map +1 -1
  173. package/dist/components/menubar/menubar.d.ts +8 -0
  174. package/dist/components/menubar/menubar.d.ts.map +1 -1
  175. package/dist/components/menubar/menubar.js +2 -1
  176. package/dist/components/menubar/menubar.js.map +1 -1
  177. package/dist/components/meter/meter.d.ts +4 -0
  178. package/dist/components/meter/meter.d.ts.map +1 -1
  179. package/dist/components/meter/meter.js +2 -1
  180. package/dist/components/meter/meter.js.map +1 -1
  181. package/dist/components/navigation/index.js +1 -0
  182. package/dist/components/navigation/index.js.map +1 -1
  183. package/dist/components/navigation/navigation-context.js +1 -0
  184. package/dist/components/navigation/navigation-context.js.map +1 -1
  185. package/dist/components/navigation/navigation-link-variants.d.ts +2 -2
  186. package/dist/components/navigation/navigation-link-variants.js +2 -1
  187. package/dist/components/navigation/navigation-link-variants.js.map +1 -1
  188. package/dist/components/navigation/navigation-link.d.ts +22 -0
  189. package/dist/components/navigation/navigation-link.d.ts.map +1 -1
  190. package/dist/components/navigation/navigation-link.js +2 -1
  191. package/dist/components/navigation/navigation-link.js.map +1 -1
  192. package/dist/components/navigation/navigation.d.ts +12 -0
  193. package/dist/components/navigation/navigation.d.ts.map +1 -1
  194. package/dist/components/navigation/navigation.js +2 -1
  195. package/dist/components/navigation/navigation.js.map +1 -1
  196. package/dist/components/navigation-menu/navigation-menu.d.ts +33 -0
  197. package/dist/components/navigation-menu/navigation-menu.d.ts.map +1 -1
  198. package/dist/components/navigation-menu/navigation-menu.js +2 -1
  199. package/dist/components/navigation-menu/navigation-menu.js.map +1 -1
  200. package/dist/components/number-field/number-field.d.ts +14 -0
  201. package/dist/components/number-field/number-field.d.ts.map +1 -1
  202. package/dist/components/number-field/number-field.js +2 -1
  203. package/dist/components/number-field/number-field.js.map +1 -1
  204. package/dist/components/otp-field/otp-field.d.ts +9 -0
  205. package/dist/components/otp-field/otp-field.d.ts.map +1 -1
  206. package/dist/components/otp-field/otp-field.js +2 -1
  207. package/dist/components/otp-field/otp-field.js.map +1 -1
  208. package/dist/components/pagination/pagination.d.ts +16 -0
  209. package/dist/components/pagination/pagination.d.ts.map +1 -1
  210. package/dist/components/pagination/pagination.js +2 -1
  211. package/dist/components/pagination/pagination.js.map +1 -1
  212. package/dist/components/popover/popover.d.ts +5 -1
  213. package/dist/components/popover/popover.d.ts.map +1 -1
  214. package/dist/components/popover/popover.js +3 -2
  215. package/dist/components/popover/popover.js.map +1 -1
  216. package/dist/components/preview-card/preview-card.d.ts +5 -1
  217. package/dist/components/preview-card/preview-card.d.ts.map +1 -1
  218. package/dist/components/preview-card/preview-card.js +3 -2
  219. package/dist/components/preview-card/preview-card.js.map +1 -1
  220. package/dist/components/progress/progress.d.ts +17 -0
  221. package/dist/components/progress/progress.d.ts.map +1 -1
  222. package/dist/components/progress/progress.js +2 -1
  223. package/dist/components/progress/progress.js.map +1 -1
  224. package/dist/components/radio/radio.js +2 -1
  225. package/dist/components/radio/radio.js.map +1 -1
  226. package/dist/components/radio-group/radio-group.d.ts +4 -0
  227. package/dist/components/radio-group/radio-group.d.ts.map +1 -1
  228. package/dist/components/radio-group/radio-group.js +2 -1
  229. package/dist/components/radio-group/radio-group.js.map +1 -1
  230. package/dist/components/rating/rating.d.ts +79 -0
  231. package/dist/components/rating/rating.d.ts.map +1 -0
  232. package/dist/components/rating/rating.js +302 -0
  233. package/dist/components/rating/rating.js.map +1 -0
  234. package/dist/components/scroll-area/scroll-area.d.ts +13 -0
  235. package/dist/components/scroll-area/scroll-area.d.ts.map +1 -1
  236. package/dist/components/scroll-area/scroll-area.js +2 -1
  237. package/dist/components/scroll-area/scroll-area.js.map +1 -1
  238. package/dist/components/select/select.d.ts +20 -1
  239. package/dist/components/select/select.d.ts.map +1 -1
  240. package/dist/components/select/select.js +3 -2
  241. package/dist/components/select/select.js.map +1 -1
  242. package/dist/components/separator/separator.d.ts +4 -0
  243. package/dist/components/separator/separator.d.ts.map +1 -1
  244. package/dist/components/separator/separator.js +2 -1
  245. package/dist/components/separator/separator.js.map +1 -1
  246. package/dist/components/skeleton/skeleton.d.ts +4 -0
  247. package/dist/components/skeleton/skeleton.d.ts.map +1 -1
  248. package/dist/components/skeleton/skeleton.js +2 -1
  249. package/dist/components/skeleton/skeleton.js.map +1 -1
  250. package/dist/components/slider/slider.d.ts +5 -0
  251. package/dist/components/slider/slider.d.ts.map +1 -1
  252. package/dist/components/slider/slider.js +2 -1
  253. package/dist/components/slider/slider.js.map +1 -1
  254. package/dist/components/sparkline/sparkline.d.ts +44 -0
  255. package/dist/components/sparkline/sparkline.d.ts.map +1 -1
  256. package/dist/components/sparkline/sparkline.js +2 -1
  257. package/dist/components/sparkline/sparkline.js.map +1 -1
  258. package/dist/components/spinner/spinner.d.ts +8 -0
  259. package/dist/components/spinner/spinner.d.ts.map +1 -1
  260. package/dist/components/spinner/spinner.js +2 -1
  261. package/dist/components/spinner/spinner.js.map +1 -1
  262. package/dist/components/switch/switch.d.ts +19 -15
  263. package/dist/components/switch/switch.d.ts.map +1 -1
  264. package/dist/components/switch/switch.js +2 -1
  265. package/dist/components/switch/switch.js.map +1 -1
  266. package/dist/components/table/table.d.ts +28 -0
  267. package/dist/components/table/table.d.ts.map +1 -1
  268. package/dist/components/table/table.js +2 -1
  269. package/dist/components/table/table.js.map +1 -1
  270. package/dist/components/tabs/tabs.d.ts +32 -2
  271. package/dist/components/tabs/tabs.d.ts.map +1 -1
  272. package/dist/components/tabs/tabs.js +2 -1
  273. package/dist/components/tabs/tabs.js.map +1 -1
  274. package/dist/components/text-animate/text-animate.d.ts +31 -0
  275. package/dist/components/text-animate/text-animate.d.ts.map +1 -1
  276. package/dist/components/text-animate/text-animate.js +27 -9
  277. package/dist/components/text-animate/text-animate.js.map +1 -1
  278. package/dist/components/textarea/textarea.d.ts +15 -0
  279. package/dist/components/textarea/textarea.d.ts.map +1 -1
  280. package/dist/components/textarea/textarea.js +2 -1
  281. package/dist/components/textarea/textarea.js.map +1 -1
  282. package/dist/components/thumbnail/thumbnail.d.ts +22 -2
  283. package/dist/components/thumbnail/thumbnail.d.ts.map +1 -1
  284. package/dist/components/thumbnail/thumbnail.js +2 -1
  285. package/dist/components/thumbnail/thumbnail.js.map +1 -1
  286. package/dist/components/time-field/time-field.d.ts +35 -0
  287. package/dist/components/time-field/time-field.d.ts.map +1 -1
  288. package/dist/components/time-field/time-field.js +2 -1
  289. package/dist/components/time-field/time-field.js.map +1 -1
  290. package/dist/components/toast/toast.d.ts +18 -0
  291. package/dist/components/toast/toast.d.ts.map +1 -1
  292. package/dist/components/toast/toast.js +2 -1
  293. package/dist/components/toast/toast.js.map +1 -1
  294. package/dist/components/toc/toc.d.ts +10 -0
  295. package/dist/components/toc/toc.d.ts.map +1 -1
  296. package/dist/components/toc/toc.js +2 -1
  297. package/dist/components/toc/toc.js.map +1 -1
  298. package/dist/components/toggle/toggle.js +1 -0
  299. package/dist/components/toggle/toggle.js.map +1 -1
  300. package/dist/components/toggle-group/toggle-group.js +2 -1
  301. package/dist/components/toggle-group/toggle-group.js.map +1 -1
  302. package/dist/components/toolbar/toolbar.js +2 -1
  303. package/dist/components/toolbar/toolbar.js.map +1 -1
  304. package/dist/components/tooltip/tooltip.d.ts +5 -1
  305. package/dist/components/tooltip/tooltip.d.ts.map +1 -1
  306. package/dist/components/tooltip/tooltip.js +3 -2
  307. package/dist/components/tooltip/tooltip.js.map +1 -1
  308. package/dist/hooks/use-direction.js +1 -0
  309. package/dist/hooks/use-direction.js.map +1 -1
  310. package/dist/hooks/use-dismissible.d.ts +4 -0
  311. package/dist/hooks/use-dismissible.d.ts.map +1 -1
  312. package/dist/hooks/use-dismissible.js +1 -0
  313. package/dist/hooks/use-dismissible.js.map +1 -1
  314. package/dist/hooks/use-local-storage.js +1 -0
  315. package/dist/hooks/use-local-storage.js.map +1 -1
  316. package/dist/hooks/use-media-query.js +1 -0
  317. package/dist/hooks/use-media-query.js.map +1 -1
  318. package/dist/hooks/use-reduced-motion.d.ts +1 -1
  319. package/dist/hooks/use-reduced-motion.js +1 -0
  320. package/dist/hooks/use-reduced-motion.js.map +1 -1
  321. package/dist/hooks/use-theme.d.ts +1 -1
  322. package/dist/hooks/use-theme.js +1 -0
  323. package/dist/hooks/use-theme.js.map +1 -1
  324. package/dist/index.d.ts +9 -0
  325. package/dist/index.d.ts.map +1 -1
  326. package/dist/index.js +11 -1
  327. package/dist/index.js.map +1 -1
  328. package/dist/internal/color-control.d.ts +75 -0
  329. package/dist/internal/color-control.d.ts.map +1 -0
  330. package/dist/internal/color-control.js +79 -0
  331. package/dist/internal/color-control.js.map +1 -0
  332. package/dist/internal/color-math.d.ts +9 -0
  333. package/dist/internal/color-math.d.ts.map +1 -0
  334. package/dist/internal/color-math.js +35 -0
  335. package/dist/internal/color-math.js.map +1 -0
  336. package/dist/internal/color-picker-context.d.ts +34 -0
  337. package/dist/internal/color-picker-context.d.ts.map +1 -0
  338. package/dist/internal/color-picker-context.js +42 -0
  339. package/dist/internal/color-picker-context.js.map +1 -0
  340. package/dist/{floating.d.ts → internal/floating.d.ts} +3 -3
  341. package/dist/internal/floating.d.ts.map +1 -0
  342. package/dist/{floating.js → internal/floating.js} +1 -0
  343. package/dist/internal/floating.js.map +1 -0
  344. package/dist/{modal.d.ts → internal/modal.d.ts} +2 -2
  345. package/dist/internal/modal.d.ts.map +1 -0
  346. package/dist/{modal.js → internal/modal.js} +1 -0
  347. package/dist/internal/modal.js.map +1 -0
  348. package/dist/{utils.d.ts → internal/utils.d.ts} +2 -2
  349. package/dist/internal/utils.d.ts.map +1 -0
  350. package/dist/{utils.js → internal/utils.js} +1 -0
  351. package/dist/internal/utils.js.map +1 -0
  352. package/dist/lib/color.d.ts +95 -0
  353. package/dist/lib/color.d.ts.map +1 -0
  354. package/dist/lib/color.js +329 -0
  355. package/dist/lib/color.js.map +1 -0
  356. package/dist/providers/direction-provider.d.ts +4 -4
  357. package/dist/providers/direction-provider.d.ts.map +1 -1
  358. package/dist/providers/direction-provider.js +1 -0
  359. package/dist/providers/direction-provider.js.map +1 -1
  360. package/dist/providers/reduced-motion-provider.d.ts +4 -8
  361. package/dist/providers/reduced-motion-provider.d.ts.map +1 -1
  362. package/dist/providers/reduced-motion-provider.js +1 -0
  363. package/dist/providers/reduced-motion-provider.js.map +1 -1
  364. package/dist/providers/theme-provider/index.js +1 -0
  365. package/dist/providers/theme-provider/index.js.map +1 -1
  366. package/dist/providers/theme-provider/theme-provider.d.ts +28 -12
  367. package/dist/providers/theme-provider/theme-provider.d.ts.map +1 -1
  368. package/dist/providers/theme-provider/theme-provider.js +1 -0
  369. package/dist/providers/theme-provider/theme-provider.js.map +1 -1
  370. package/dist/providers/theme-provider/theme-script.js +1 -0
  371. package/dist/providers/theme-provider/theme-script.js.map +1 -1
  372. package/package.json +91 -31
  373. package/src/components/accordion/accordion.tsx +25 -1
  374. package/src/components/alert/alert.tsx +30 -2
  375. package/src/components/alert-dialog/alert-dialog.test.tsx +34 -2
  376. package/src/components/alert-dialog/alert-dialog.tsx +21 -5
  377. package/src/components/autocomplete/autocomplete.test.tsx +1 -1
  378. package/src/components/autocomplete/autocomplete.tsx +22 -2
  379. package/src/components/avatar/avatar.test.tsx +2 -2
  380. package/src/components/avatar/avatar.tsx +17 -1
  381. package/src/components/background-pattern/background-pattern-interactive.tsx +4 -2
  382. package/src/components/background-pattern/background-pattern-shared.tsx +56 -19
  383. package/src/components/background-pattern/background-pattern.test.tsx +36 -1
  384. package/src/components/background-pattern/background-pattern.tsx +24 -9
  385. package/src/components/badge/badge.tsx +14 -2
  386. package/src/components/border-beam/border-beam.test.tsx +91 -0
  387. package/src/components/border-beam/border-beam.tsx +131 -0
  388. package/src/components/breadcrumb/breadcrumb.tsx +9 -1
  389. package/src/components/button/button-variants.ts +1 -1
  390. package/src/components/button/button.tsx +13 -2
  391. package/src/components/button-group/button-group.tsx +11 -1
  392. package/src/components/calendar/calendar.tsx +6 -1
  393. package/src/components/card/card.test.tsx +98 -0
  394. package/src/components/card/card.tsx +154 -0
  395. package/src/components/carousel/carousel.test.tsx +179 -0
  396. package/src/components/carousel/carousel.tsx +329 -6
  397. package/src/components/checkbox/checkbox.test.tsx +2 -2
  398. package/src/components/checkbox/checkbox.tsx +1 -1
  399. package/src/components/checkbox-group/checkbox-group.tsx +5 -1
  400. package/src/components/chip/chip.tsx +33 -1
  401. package/src/components/collapsible/collapsible.tsx +1 -1
  402. package/src/components/color-area/color-area.test.tsx +242 -0
  403. package/src/components/color-area/color-area.tsx +356 -0
  404. package/src/components/color-picker/color-picker.test.tsx +286 -0
  405. package/src/components/color-picker/color-picker.tsx +546 -0
  406. package/src/components/color-slider/color-slider.test.tsx +222 -0
  407. package/src/components/color-slider/color-slider.tsx +330 -0
  408. package/src/components/color-swatch/color-swatch.test.tsx +117 -0
  409. package/src/components/color-swatch/color-swatch.tsx +119 -0
  410. package/src/components/color-swatch-picker/color-swatch-picker.test.tsx +287 -0
  411. package/src/components/color-swatch-picker/color-swatch-picker.tsx +327 -0
  412. package/src/components/combobox/combobox.test.tsx +1 -1
  413. package/src/components/combobox/combobox.tsx +26 -2
  414. package/src/components/context-menu/context-menu.test.tsx +28 -0
  415. package/src/components/context-menu/context-menu.tsx +16 -5
  416. package/src/components/copy-button/copy-button.test.tsx +14 -1
  417. package/src/components/copy-button/copy-button.tsx +27 -6
  418. package/src/components/countdown/countdown.tsx +15 -1
  419. package/src/components/date-field/date-field.tsx +36 -1
  420. package/src/components/date-picker/date-picker.test.tsx +1 -1
  421. package/src/components/date-picker/date-picker.tsx +95 -1
  422. package/src/components/dialog/dialog.test.tsx +30 -1
  423. package/src/components/dialog/dialog.tsx +28 -6
  424. package/src/components/drawer/drawer.test.tsx +32 -1
  425. package/src/components/drawer/drawer.tsx +37 -7
  426. package/src/components/dropdown-menu/dropdown-menu.test.tsx +28 -0
  427. package/src/components/dropdown-menu/dropdown-menu.tsx +16 -5
  428. package/src/components/field/field.tsx +1 -1
  429. package/src/components/fieldset/fieldset.tsx +1 -1
  430. package/src/components/gradient-glow/gradient-glow.test.tsx +7 -1
  431. package/src/components/gradient-glow/gradient-glow.tsx +64 -11
  432. package/src/components/input/input-variants.ts +1 -1
  433. package/src/components/input/input.tsx +24 -4
  434. package/src/components/kbd/kbd.tsx +9 -1
  435. package/src/components/loader/loader.tsx +9 -1
  436. package/src/components/menubar/menubar.tsx +9 -1
  437. package/src/components/meter/meter.tsx +5 -1
  438. package/src/components/navigation/navigation-link-variants.ts +1 -1
  439. package/src/components/navigation/navigation-link.tsx +23 -1
  440. package/src/components/navigation/navigation.tsx +23 -3
  441. package/src/components/navigation-menu/navigation-menu.tsx +34 -1
  442. package/src/components/number-field/number-field.tsx +15 -1
  443. package/src/components/otp-field/otp-field.tsx +10 -1
  444. package/src/components/pagination/pagination.tsx +17 -1
  445. package/src/components/popover/popover.test.tsx +1 -1
  446. package/src/components/popover/popover.tsx +6 -2
  447. package/src/components/preview-card/preview-card.tsx +6 -2
  448. package/src/components/progress/progress.tsx +18 -1
  449. package/src/components/radio/radio.test.tsx +1 -1
  450. package/src/components/radio/radio.tsx +1 -1
  451. package/src/components/radio-group/radio-group.test.tsx +1 -1
  452. package/src/components/radio-group/radio-group.tsx +5 -1
  453. package/src/components/rating/rating.test.tsx +246 -0
  454. package/src/components/rating/rating.tsx +457 -0
  455. package/src/components/scroll-area/scroll-area.test.tsx +1 -1
  456. package/src/components/scroll-area/scroll-area.tsx +14 -1
  457. package/src/components/select/select.tsx +21 -2
  458. package/src/components/separator/separator.tsx +5 -1
  459. package/src/components/skeleton/skeleton.tsx +5 -1
  460. package/src/components/slider/slider.test.tsx +1 -1
  461. package/src/components/slider/slider.tsx +6 -1
  462. package/src/components/sparkline/sparkline.test.tsx +1 -1
  463. package/src/components/sparkline/sparkline.tsx +45 -1
  464. package/src/components/spinner/spinner.tsx +9 -1
  465. package/src/components/switch/switch.test.tsx +1 -1
  466. package/src/components/switch/switch.tsx +5 -1
  467. package/src/components/table/table.tsx +29 -1
  468. package/src/components/tabs/tabs.test.tsx +1 -1
  469. package/src/components/tabs/tabs.tsx +33 -2
  470. package/src/components/text-animate/text-animate.test.tsx +62 -0
  471. package/src/components/text-animate/text-animate.tsx +77 -9
  472. package/src/components/textarea/textarea.tsx +16 -1
  473. package/src/components/thumbnail/thumbnail.test.tsx +1 -1
  474. package/src/components/thumbnail/thumbnail.tsx +21 -1
  475. package/src/components/time-field/time-field.tsx +36 -1
  476. package/src/components/toast/toast.test.tsx +1 -1
  477. package/src/components/toast/toast.tsx +19 -1
  478. package/src/components/toc/toc.tsx +11 -1
  479. package/src/components/toggle/toggle.test.tsx +1 -1
  480. package/src/components/toggle-group/toggle-group.tsx +1 -1
  481. package/src/components/toolbar/toolbar.tsx +1 -1
  482. package/src/components/tooltip/tooltip.test.tsx +1 -1
  483. package/src/components/tooltip/tooltip.tsx +6 -2
  484. package/src/hooks/use-dismissible.ts +4 -0
  485. package/src/hooks/use-local-storage.ts +3 -3
  486. package/src/hooks/use-reduced-motion.ts +1 -1
  487. package/src/hooks/use-theme.ts +1 -1
  488. package/src/index.ts +11 -2
  489. package/src/internal/color-control.ts +178 -0
  490. package/src/internal/color-math.ts +44 -0
  491. package/src/internal/color-picker-context.ts +80 -0
  492. package/src/{floating.ts → internal/floating.ts} +3 -3
  493. package/src/{modal.ts → internal/modal.ts} +3 -3
  494. package/src/lib/color.test.ts +178 -0
  495. package/src/lib/color.ts +471 -0
  496. package/src/providers/direction-provider.tsx +4 -4
  497. package/src/providers/reduced-motion-provider.tsx +4 -8
  498. package/src/providers/theme-provider/theme-provider.tsx +28 -12
  499. package/src/providers/theme-provider/theme-script.tsx +2 -2
  500. package/src/test/setup.ts +1 -1
  501. package/styles.css +28 -4
  502. package/dist/floating.d.ts.map +0 -1
  503. package/dist/floating.js.map +0 -1
  504. package/dist/modal.d.ts.map +0 -1
  505. package/dist/modal.js.map +0 -1
  506. package/dist/utils.d.ts.map +0 -1
  507. package/dist/utils.js.map +0 -1
  508. /package/src/{floating.test.ts → internal/floating.test.ts} +0 -0
  509. /package/src/{modal.test.ts → internal/modal.test.ts} +0 -0
  510. /package/src/{utils.test.tsx → internal/utils.test.tsx} +0 -0
  511. /package/src/{utils.ts → internal/utils.ts} +0 -0
@@ -0,0 +1,457 @@
1
+ 'use client'
2
+
3
+ import * as React from 'react'
4
+ import { LazyMotion, animate, domAnimation, m, useMotionValue, useTransform } from 'motion/react'
5
+ import type { MotionValue } from 'motion/react'
6
+ import { cn } from '../../internal/utils'
7
+ import { useDirection } from '../../hooks/use-direction'
8
+ import { useReducedMotion } from '../../hooks/use-reduced-motion'
9
+
10
+ type RatingVariant = 'filled' | 'outline'
11
+ type RatingOrientation = 'horizontal' | 'vertical'
12
+
13
+ interface RatingIconPair {
14
+ /** Drawn under the fill when `variant="outline"`. */
15
+ empty: React.ReactNode
16
+ /** Drawn as the fill, and as the muted base when `variant="filled"`. */
17
+ filled: React.ReactNode
18
+ }
19
+
20
+ const STAR: RatingIconPair = {
21
+ empty: (
22
+ <svg
23
+ viewBox="0 0 24 24"
24
+ fill="none"
25
+ stroke="currentColor"
26
+ strokeWidth={1.5}
27
+ strokeLinecap="round"
28
+ strokeLinejoin="round"
29
+ aria-hidden="true"
30
+ >
31
+ <path d="M12.007 17.754 5.827 21l1.18-6.876L2 9.256l6.91-1L12 2l3.09 6.255 6.91 1-5.007 4.87L18.173 21z" />
32
+ </svg>
33
+ ),
34
+ filled: (
35
+ <svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
36
+ <path d="m8.33 7.439-6.242.903-.11.023a.98.98 0 0 0-.692 1.206 1 1 0 0 0 .26.438l4.524 4.393-1.067 6.206-.013.107a.975.975 0 0 0 .934 1.034 1 1 0 0 0 .499-.112l5.583-2.93 5.57 2.93.099.045a.98.98 0 0 0 1.275-.566 1 1 0 0 0 .048-.508l-1.068-6.206 4.525-4.394.076-.083a.975.975 0 0 0-.62-1.582L15.67 7.44l-2.79-5.644a.978.978 0 0 0-1.756 0z" />
37
+ </svg>
38
+ ),
39
+ }
40
+
41
+ const ZERO_TRANSITION = { duration: 0 } as const
42
+ const SETTLE_TRANSITION = { type: 'spring', stiffness: 380, damping: 34, mass: 0.5 } as const
43
+ const SCALE_TRANSITION = { type: 'spring', stiffness: 420, damping: 24, mass: 0.6 } as const
44
+ // Overdamped going down so the press reads as instant, underdamped coming back
45
+ // up so releasing overshoots slightly before settling.
46
+ const PRESS_TRANSITION = { type: 'spring', stiffness: 800, damping: 45, mass: 0.5 } as const
47
+ const RELEASE_TRANSITION = { type: 'spring', stiffness: 500, damping: 15, mass: 0.7 } as const
48
+
49
+ const PRESSED_SCALE = 0.9
50
+ const LIFTED_SCALE = 1.14
51
+
52
+ const clamp = (value: number, min: number, max: number) => Math.min(max, Math.max(min, value))
53
+ const round = (value: number) => Math.round(value * 1e4) / 1e4
54
+
55
+ function quantize(raw: number, step: number, count: number) {
56
+ return clamp(round(Math.ceil(round(raw / step)) * step), step, count)
57
+ }
58
+
59
+ function clipFor(fill: number, rtl: boolean, vertical: boolean) {
60
+ const inset = `${round((1 - fill) * 100)}%`
61
+ if (vertical) return `inset(0 0 ${inset} 0)`
62
+ return rtl ? `inset(0 0 0 ${inset})` : `inset(0 ${inset} 0 0)`
63
+ }
64
+
65
+ const iconLayerClasses = 'block size-(--rating-size) *:size-full'
66
+
67
+ // stroke-dasharray inherits into the SVG, where it resolves against the 24-unit
68
+ // viewBox - so the dash scales with --rating-size instead of staying fixed.
69
+ const DASHED = '[stroke-dasharray:2.5_2]'
70
+
71
+ interface RatingItemVisualProps {
72
+ index: number
73
+ progress: MotionValue<number>
74
+ icons: RatingIconPair
75
+ variant: RatingVariant
76
+ rtl: boolean
77
+ vertical: boolean
78
+ reduced: boolean
79
+ disabled: boolean
80
+ lifted: boolean
81
+ pressed: boolean
82
+ }
83
+
84
+ function RatingItemVisual({
85
+ index,
86
+ progress,
87
+ icons,
88
+ variant,
89
+ rtl,
90
+ vertical,
91
+ reduced,
92
+ disabled,
93
+ lifted,
94
+ pressed,
95
+ }: RatingItemVisualProps) {
96
+ const clipPath = useTransform(progress, (value) => clipFor(clamp(value - index, 0, 1), rtl, vertical))
97
+
98
+ // Reading the ref during render is what distinguishes a release (bounce back)
99
+ // from an ordinary hover change (no bounce); the effect commits it afterwards.
100
+ const wasPressed = React.useRef(false)
101
+ React.useEffect(() => {
102
+ wasPressed.current = pressed
103
+ }, [pressed])
104
+
105
+ return (
106
+ <m.span
107
+ className="relative block"
108
+ initial={false}
109
+ animate={{ scale: reduced ? 1 : pressed ? PRESSED_SCALE : lifted ? LIFTED_SCALE : 1 }}
110
+ transition={
111
+ reduced
112
+ ? ZERO_TRANSITION
113
+ : pressed
114
+ ? PRESS_TRANSITION
115
+ : wasPressed.current
116
+ ? RELEASE_TRANSITION
117
+ : SCALE_TRANSITION
118
+ }
119
+ >
120
+ <span className="relative block">
121
+ <span
122
+ data-slot="rating-item-base"
123
+ className={cn(
124
+ iconLayerClasses,
125
+ 'relative',
126
+ variant === 'filled' && (disabled ? 'text-background-muted' : 'text-border-strong'),
127
+ variant === 'outline' && disabled && DASHED,
128
+ )}
129
+ >
130
+ {variant === 'filled' ? icons.filled : icons.empty}
131
+ </span>
132
+ {variant === 'filled' && disabled ? (
133
+ <span aria-hidden="true" className={cn(iconLayerClasses, 'text-border-strong absolute inset-0', DASHED)}>
134
+ {icons.empty}
135
+ </span>
136
+ ) : null}
137
+ <m.span
138
+ data-slot="rating-item-fill"
139
+ aria-hidden="true"
140
+ className={cn(iconLayerClasses, 'absolute inset-0')}
141
+ style={{ clipPath }}
142
+ >
143
+ {icons.filled}
144
+ </m.span>
145
+ </span>
146
+ </m.span>
147
+ )
148
+ }
149
+
150
+ // The button padding is a sixth of the icon size (4px at the 24px default), so
151
+ // the hit area and the gap it creates both scale with `size`.
152
+ const ITEM_PADDING = 'p-[calc(var(--rating-size)/6)]'
153
+
154
+ const rootClasses = cn(
155
+ 'text-primary relative inline-flex w-fit items-center data-disabled:cursor-not-allowed data-disabled:opacity-disabled',
156
+ 'data-[orientation=vertical]:flex-col',
157
+ 'data-[orientation=horizontal]:mx-[calc(var(--rating-size)/-6)]',
158
+ 'data-[orientation=vertical]:my-[calc(var(--rating-size)/-6)]',
159
+ )
160
+
161
+ const itemClasses = cn(
162
+ 'outline-ring rounded-sm relative inline-flex cursor-pointer items-center justify-center disabled:pointer-events-none',
163
+ ITEM_PADDING,
164
+ )
165
+
166
+ const defaultItemAriaLabel = (value: number, count: number) => `${value} of ${count}`
167
+
168
+ interface RatingProps extends Omit<
169
+ React.ComponentProps<'div'>,
170
+ 'children' | 'defaultValue' | 'onChange' | 'role' | 'aria-readonly'
171
+ > {
172
+ /** Controlled rating. Pair with `onValueChange`. */
173
+ value?: number
174
+ /**
175
+ * Uncontrolled initial rating. `0` means unrated.
176
+ * @default 0
177
+ */
178
+ defaultValue?: number
179
+ /** Fires when the rating is committed by a click or a key press. */
180
+ onValueChange?: (value: number) => void
181
+ /** Fires with the `step`-snapped rating under the pointer, and with `null` when it leaves. */
182
+ onHoverChange?: (value: number | null) => void
183
+ /**
184
+ * How many items to render.
185
+ * @default 5
186
+ */
187
+ count?: number
188
+ /**
189
+ * Smallest selectable fraction of an item. Use `0.5` for half icons.
190
+ * @default 1
191
+ */
192
+ step?: number
193
+ /**
194
+ * Icon pair to render. Defaults to a built-in star; pass any 24x24 `currentColor` SVGs, e.g. a matching outline and solid icon from `@appica/icons-react`.
195
+ */
196
+ icon?: RatingIconPair
197
+ /**
198
+ * `'filled'` draws unrated items as muted solid icons, `'outline'` draws them as line icons.
199
+ * @default 'filled'
200
+ */
201
+ variant?: RatingVariant
202
+ /**
203
+ * Lay the items out in a row or a column. A vertical rating fills from the top down.
204
+ * @default 'horizontal'
205
+ */
206
+ orientation?: RatingOrientation
207
+ /**
208
+ * Icon size. A number is read as pixels; a string is used verbatim, so any CSS length works (`'2rem'`, `'1em'` to follow the surrounding text).
209
+ * @default 24
210
+ */
211
+ size?: number | string
212
+ /**
213
+ * Track the pointer with a continuous fill before the rating is committed. Clicking still selects at `step` precision either way.
214
+ * @default true
215
+ */
216
+ hoverable?: boolean
217
+ /**
218
+ * Selecting the current rating again resets it to `0`.
219
+ * @default false
220
+ */
221
+ clearable?: boolean
222
+ /**
223
+ * Blocks interaction and dims the control.
224
+ * @default false
225
+ */
226
+ disabled?: boolean
227
+ /**
228
+ * Renders a non-interactive display of `value`, exposed as a single labeled image.
229
+ * @default false
230
+ */
231
+ readOnly?: boolean
232
+ /** Field name submitted with a form, via a hidden input. */
233
+ name?: string
234
+ /** Accessible name for each item, describing the rating it selects. */
235
+ itemAriaLabel?: (value: number, count: number) => string
236
+ }
237
+
238
+ function Rating({
239
+ value,
240
+ defaultValue = 0,
241
+ onValueChange,
242
+ onHoverChange,
243
+ count = 5,
244
+ step = 1,
245
+ icon = STAR,
246
+ variant = 'filled',
247
+ orientation = 'horizontal',
248
+ size = 24,
249
+ hoverable = true,
250
+ clearable = false,
251
+ disabled = false,
252
+ readOnly = false,
253
+ name,
254
+ itemAriaLabel = defaultItemAriaLabel,
255
+ className,
256
+ style,
257
+ 'aria-label': ariaLabel,
258
+ ...props
259
+ }: RatingProps) {
260
+ const rtl = useDirection() === 'rtl'
261
+ const vertical = orientation === 'vertical'
262
+ const reduced = useReducedMotion()
263
+
264
+ const [uncontrolled, setUncontrolled] = React.useState(defaultValue)
265
+ const current = value ?? uncontrolled
266
+
267
+ const [hover, setHover] = React.useState<number | null>(null)
268
+ const hoverRef = React.useRef<number | null>(null)
269
+ const [pressedIndex, setPressedIndex] = React.useState<number | null>(null)
270
+ const itemsRef = React.useRef<Array<HTMLButtonElement | null>>([])
271
+
272
+ const progress = useMotionValue(current)
273
+ const settleRef = React.useRef<ReturnType<typeof animate> | null>(null)
274
+
275
+ const interactive = !disabled && !readOnly
276
+ const checkedIndex = current > 0 ? Math.ceil(current) - 1 : 0
277
+
278
+ const setProgress = React.useCallback(
279
+ (next: number) => {
280
+ settleRef.current?.stop()
281
+ settleRef.current = null
282
+ if (reduced) {
283
+ progress.set(next)
284
+ } else {
285
+ settleRef.current = animate(progress, next, SETTLE_TRANSITION)
286
+ }
287
+ },
288
+ [progress, reduced],
289
+ )
290
+
291
+ const previewing = hoverable && hover !== null
292
+
293
+ React.useEffect(() => {
294
+ if (!previewing) setProgress(current)
295
+ }, [current, previewing, setProgress])
296
+
297
+ const updateHover = (next: number | null) => {
298
+ if (hoverRef.current === next) return
299
+ hoverRef.current = next
300
+ if (hoverable) {
301
+ setHover(next)
302
+ if (next !== null) setProgress(next)
303
+ }
304
+ onHoverChange?.(next)
305
+ }
306
+
307
+ const trackPointer = (event: React.PointerEvent<HTMLDivElement>) => {
308
+ const rect = event.currentTarget.getBoundingClientRect()
309
+ const span = vertical ? rect.height : rect.width
310
+ if (span === 0) return
311
+ const offset = vertical ? event.clientY - rect.top : event.clientX - rect.left
312
+ const ratio = offset / span
313
+ const exact = clamp((!vertical && rtl ? 1 - ratio : ratio) * count, 0, count)
314
+ updateHover(quantize(exact, step, count))
315
+ }
316
+
317
+ const commit = (next: number) => {
318
+ const resolved = clamp(round(next), 0, count)
319
+ if (value === undefined) setUncontrolled(resolved)
320
+ if (resolved !== current) onValueChange?.(resolved)
321
+ }
322
+
323
+ const handleItemClick = (event: React.MouseEvent<HTMLButtonElement>, index: number) => {
324
+ const next = (event.detail === 0 ? null : hoverRef.current) ?? index + 1
325
+ commit(clearable && next === current ? 0 : next)
326
+ }
327
+
328
+ // Only the item that owns the press may end it: pressing another item blurs
329
+ // this one, and that blur lands after the new item's pointerdown.
330
+ const releasePress = (index: number) => setPressedIndex((cur) => (cur === index ? null : cur))
331
+
332
+ const pressProps = (index: number) => ({
333
+ onPointerDown: () => setPressedIndex(index),
334
+ onPointerUp: () => releasePress(index),
335
+ onPointerLeave: () => releasePress(index),
336
+ onPointerCancel: () => releasePress(index),
337
+ onBlur: () => releasePress(index),
338
+ onKeyDown: (event: React.KeyboardEvent) => {
339
+ if (event.key === ' ' || event.key === 'Enter') setPressedIndex(index)
340
+ },
341
+ onKeyUp: () => releasePress(index),
342
+ })
343
+
344
+ const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
345
+ if (!interactive) return
346
+ // Radio-group semantics: Down/Right step to the next item, Up/Left to the
347
+ // previous one. Only the horizontal pair mirrors in RTL.
348
+ let next: number
349
+ switch (event.key) {
350
+ case 'ArrowRight':
351
+ next = current + (rtl ? -step : step)
352
+ break
353
+ case 'ArrowLeft':
354
+ next = current + (rtl ? step : -step)
355
+ break
356
+ case 'ArrowDown':
357
+ next = current + step
358
+ break
359
+ case 'ArrowUp':
360
+ next = current - step
361
+ break
362
+ case 'Home':
363
+ next = step
364
+ break
365
+ case 'End':
366
+ next = count
367
+ break
368
+ default:
369
+ return
370
+ }
371
+ event.preventDefault()
372
+ updateHover(null)
373
+ const resolved = clamp(round(next), clearable ? 0 : step, count)
374
+ commit(resolved)
375
+ itemsRef.current[Math.max(0, Math.ceil(resolved) - 1)]?.focus()
376
+ }
377
+
378
+ const pointerProps = interactive
379
+ ? {
380
+ onPointerMove: trackPointer,
381
+ onPointerDown: trackPointer,
382
+ onPointerLeave: () => updateHover(null),
383
+ onPointerCancel: () => updateHover(null),
384
+ }
385
+ : {}
386
+
387
+ return (
388
+ <LazyMotion features={domAnimation} strict>
389
+ <div
390
+ data-slot="rating"
391
+ data-orientation={orientation}
392
+ role={readOnly ? 'img' : 'radiogroup'}
393
+ aria-label={ariaLabel ?? (readOnly ? `${current} out of ${count}` : undefined)}
394
+ aria-orientation={readOnly ? undefined : orientation}
395
+ {...(disabled ? { 'data-disabled': '' } : {})}
396
+ {...(readOnly ? { 'data-readonly': '' } : {})}
397
+ className={cn(rootClasses, className)}
398
+ style={{ '--rating-size': typeof size === 'number' ? `${size}px` : size, ...style } as React.CSSProperties}
399
+ onKeyDown={interactive ? handleKeyDown : undefined}
400
+ {...pointerProps}
401
+ {...props}
402
+ >
403
+ {Array.from({ length: count }, (_, index) => {
404
+ const visual = (
405
+ <RatingItemVisual
406
+ index={index}
407
+ progress={progress}
408
+ icons={icon}
409
+ variant={variant}
410
+ rtl={rtl}
411
+ vertical={vertical}
412
+ reduced={reduced}
413
+ disabled={disabled}
414
+ lifted={hover !== null && Math.ceil(hover) - 1 === index}
415
+ pressed={pressedIndex === index}
416
+ />
417
+ )
418
+
419
+ if (readOnly) {
420
+ return (
421
+ <span key={index} data-slot="rating-item" className={cn('inline-flex', ITEM_PADDING)}>
422
+ {visual}
423
+ </span>
424
+ )
425
+ }
426
+
427
+ const checked = Math.ceil(current) === index + 1
428
+ return (
429
+ <button
430
+ key={index}
431
+ type="button"
432
+ role="radio"
433
+ aria-checked={checked}
434
+ aria-label={itemAriaLabel(index + 1, count)}
435
+ tabIndex={index === checkedIndex ? 0 : -1}
436
+ disabled={disabled}
437
+ data-slot="rating-item"
438
+ {...(checked ? { 'data-checked': '' } : {})}
439
+ ref={(node) => {
440
+ itemsRef.current[index] = node
441
+ }}
442
+ className={itemClasses}
443
+ onClick={(event) => handleItemClick(event, index)}
444
+ {...pressProps(index)}
445
+ >
446
+ {visual}
447
+ </button>
448
+ )
449
+ })}
450
+ {name ? <input type="hidden" name={name} value={current} /> : null}
451
+ </div>
452
+ </LazyMotion>
453
+ )
454
+ }
455
+
456
+ export { Rating }
457
+ export type { RatingProps, RatingIconPair }
@@ -107,7 +107,7 @@ describe('ScrollArea', () => {
107
107
  )
108
108
  expect(container.querySelector('[data-slot="scroll-area-scrollbar"]')).toBeNull()
109
109
  expect(container.querySelector('[data-slot="scroll-area-corner"]')).toBeNull()
110
- // Viewport stays scrollable — it's still in the DOM.
110
+ // Viewport stays scrollable - it's still in the DOM.
111
111
  expect(container.querySelector('[data-slot="scroll-area-viewport"]')).not.toBeNull()
112
112
  })
113
113
 
@@ -1,6 +1,6 @@
1
1
  import * as React from 'react'
2
2
  import { ScrollArea as BaseScrollArea } from '@base-ui/react/scroll-area'
3
- import { cn } from '../../utils'
3
+ import { cn } from '../../internal/utils'
4
4
 
5
5
  type ScrollAreaOrientation = 'vertical' | 'horizontal' | 'both'
6
6
  type ScrollbarVisibility = 'always' | 'auto' | 'never'
@@ -18,9 +18,22 @@ const SCROLLBAR_AUTO_CLASSES = cn(
18
18
  )
19
19
 
20
20
  interface ScrollAreaProps extends React.ComponentProps<typeof BaseScrollArea.Root> {
21
+ /**
22
+ * Which axis (or axes) gets a scrollbar. `both` also renders the corner.
23
+ * @default 'vertical'
24
+ */
21
25
  orientation?: ScrollAreaOrientation
26
+ /**
27
+ * Fade the content at scrollable edges via a CSS mask.
28
+ * @default false
29
+ */
22
30
  scrollShadow?: boolean
31
+ /**
32
+ * `auto` reveals the bar on hover/scroll; `never` hides it while keeping content scrollable.
33
+ * @default 'always'
34
+ */
23
35
  scrollbarVisibility?: ScrollbarVisibility
36
+ /** Props forwarded to the inner scroll viewport - `ref`, `onScroll`, `className`, etc. */
24
37
  viewportProps?: Omit<React.ComponentProps<typeof BaseScrollArea.Viewport>, 'children'>
25
38
  }
26
39
 
@@ -3,8 +3,8 @@
3
3
  import * as React from 'react'
4
4
  import { Select as BaseSelect } from '@base-ui/react/select'
5
5
  import { useReducedMotion } from '../../hooks/use-reduced-motion'
6
- import { cn } from '../../utils'
7
- import { type FloatingContentProps, splitFloatingProps } from '../../floating'
6
+ import { cn } from '../../internal/utils'
7
+ import { type FloatingContentProps, splitFloatingProps } from '../../internal/floating'
8
8
  import { inputVariants } from '../input/input-variants'
9
9
 
10
10
  type SelectSize = 'sm' | 'md' | 'lg'
@@ -33,8 +33,20 @@ function useSelectContext() {
33
33
  type BaseSelectRootProps = React.ComponentProps<typeof BaseSelect.Root>
34
34
 
35
35
  interface SelectProps extends BaseSelectRootProps {
36
+ /**
37
+ * Trigger height, popup radius, and item sizing.
38
+ * @default 'md'
39
+ */
36
40
  size?: SelectSize
41
+ /**
42
+ * Trigger appearance - bordered or filled.
43
+ * @default 'outline'
44
+ */
37
45
  variant?: SelectVariant
46
+ /**
47
+ * Overlay the selected item over the trigger on open. **Set `false` when using a `startSlot`.**
48
+ * @default true
49
+ */
38
50
  alignItemWithTrigger?: boolean
39
51
  }
40
52
 
@@ -106,8 +118,14 @@ const ICON_SIZE: Record<SelectSize, string> = {
106
118
  }
107
119
 
108
120
  interface SelectTriggerProps extends React.ComponentProps<typeof BaseSelect.Trigger> {
121
+ /**
122
+ * Render a clear button inside the trigger when a value is present.
123
+ * @default false
124
+ */
109
125
  clearable?: boolean
126
+ /** Adornment before the value. Pair with `alignItemWithTrigger={false}`. */
110
127
  startSlot?: React.ReactNode
128
+ /** Adornment after the value, before the chevron. */
111
129
  endSlot?: React.ReactNode
112
130
  }
113
131
 
@@ -221,6 +239,7 @@ type SelectContentProps = React.ComponentProps<typeof BaseSelect.Popup> &
221
239
  React.ComponentProps<typeof BaseSelect.Positioner>,
222
240
  React.ComponentProps<typeof BaseSelect.Portal>
223
241
  > & {
242
+ /** Per-popup override of the root's alignment setting. */
224
243
  alignItemWithTrigger?: boolean
225
244
  }
226
245
 
@@ -1,6 +1,6 @@
1
1
  import * as React from 'react'
2
2
  import { Separator as BaseSeparator } from '@base-ui/react/separator'
3
- import { cn } from '../../utils'
3
+ import { cn } from '../../internal/utils'
4
4
 
5
5
  type SeparatorVariant = 'solid' | 'dashed' | 'dotted' | 'double' | 'gradient' | 'wave' | 'zigzag'
6
6
 
@@ -69,6 +69,10 @@ function DecorativePattern({ variant, horizontal }: { variant: SeparatorVariant;
69
69
  }
70
70
 
71
71
  type SeparatorProps = React.ComponentProps<typeof BaseSeparator> & {
72
+ /**
73
+ * Line style. `gradient`, `wave`, `zigzag`, and `dotted` are decorative.
74
+ * @default 'solid'
75
+ */
72
76
  variant?: SeparatorVariant
73
77
  }
74
78
 
@@ -1,9 +1,13 @@
1
1
  import * as React from 'react'
2
- import { cn } from '../../utils'
2
+ import { cn } from '../../internal/utils'
3
3
 
4
4
  type SkeletonEffect = 'shimmer' | 'pulse' | 'none'
5
5
 
6
6
  interface SkeletonProps extends React.ComponentProps<'div'> {
7
+ /**
8
+ * Animation played while the placeholder is visible. All effects honor `prefers-reduced-motion`.
9
+ * @default 'shimmer'
10
+ */
7
11
  effect?: SkeletonEffect
8
12
  }
9
13
 
@@ -70,7 +70,7 @@ describe('Slider', () => {
70
70
  await user.keyboard('{ArrowRight}')
71
71
 
72
72
  expect(onValueChange).toHaveBeenCalled()
73
- // Parent never updates — value stays at 30.
73
+ // Parent never updates - value stays at 30.
74
74
  expect(thumb).toHaveAttribute('aria-valuenow', '30')
75
75
  })
76
76
 
@@ -3,7 +3,7 @@
3
3
  import * as React from 'react'
4
4
  import { Slider as BaseSlider } from '@base-ui/react/slider'
5
5
  import { AnimatePresence, LazyMotion, domAnimation, m, useAnimate } from 'motion/react'
6
- import { cn } from '../../utils'
6
+ import { cn } from '../../internal/utils'
7
7
  import { useDirection } from '../../hooks/use-direction'
8
8
  import { useReducedMotion } from '../../hooks/use-reduced-motion'
9
9
 
@@ -165,7 +165,12 @@ const indicatorClasses =
165
165
  'bg-primary select-none data-[orientation=horizontal]:h-full data-[orientation=vertical]:w-full'
166
166
 
167
167
  interface SliderProps extends Omit<BaseSlider.Root.Props, 'children'> {
168
+ /**
169
+ * When the value tooltip shows - on interaction, always, or never.
170
+ * @default 'auto'
171
+ */
168
172
  tooltipVisibility?: SliderTooltipVisibility
173
+ /** Accessible name for each thumb. Use a function to name range ends. */
169
174
  thumbAriaLabel?: string | ((index: number) => string)
170
175
  }
171
176
 
@@ -179,7 +179,7 @@ describe('Sparkline', () => {
179
179
  const chart = screen.getByRole('img')
180
180
  stubRect(chart, 100)
181
181
 
182
- // A touch tap fires pointerdown without a preceding move — it must activate immediately.
182
+ // A touch tap fires pointerdown without a preceding move - it must activate immediately.
183
183
  fireEvent.pointerDown(chart, { clientX: 100, pointerType: 'touch' })
184
184
  expect(onActiveChange).toHaveBeenLastCalledWith({ index: 5, value: 12, label: undefined })
185
185