@appica/ui-react 1.0.0 → 1.1.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 (473) hide show
  1. package/CHANGELOG.md +46 -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 +1 -1
  8. package/dist/components/accordion/accordion.js.map +1 -1
  9. package/dist/components/alert/alert.d.ts +29 -1
  10. package/dist/components/alert/alert.d.ts.map +1 -1
  11. package/dist/components/alert/alert.js +1 -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 +9 -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 +2 -2
  20. package/dist/components/autocomplete/autocomplete.js.map +1 -1
  21. package/dist/components/avatar/avatar.d.ts +16 -0
  22. package/dist/components/avatar/avatar.d.ts.map +1 -1
  23. package/dist/components/avatar/avatar.js +1 -1
  24. package/dist/components/avatar/avatar.js.map +1 -1
  25. package/dist/components/background-pattern/background-pattern-interactive.js +1 -1
  26. package/dist/components/background-pattern/background-pattern-interactive.js.map +1 -1
  27. package/dist/components/background-pattern/background-pattern-shared.js +1 -1
  28. package/dist/components/background-pattern/background-pattern-shared.js.map +1 -1
  29. package/dist/components/background-pattern/background-pattern.d.ts +13 -5
  30. package/dist/components/background-pattern/background-pattern.d.ts.map +1 -1
  31. package/dist/components/background-pattern/background-pattern.js +1 -1
  32. package/dist/components/background-pattern/background-pattern.js.map +1 -1
  33. package/dist/components/badge/badge.d.ts +11 -1
  34. package/dist/components/badge/badge.d.ts.map +1 -1
  35. package/dist/components/badge/badge.js +1 -1
  36. package/dist/components/badge/badge.js.map +1 -1
  37. package/dist/components/border-beam/border-beam.d.ts +52 -0
  38. package/dist/components/border-beam/border-beam.d.ts.map +1 -0
  39. package/dist/components/border-beam/border-beam.js +67 -0
  40. package/dist/components/border-beam/border-beam.js.map +1 -0
  41. package/dist/components/breadcrumb/breadcrumb.d.ts +8 -0
  42. package/dist/components/breadcrumb/breadcrumb.d.ts.map +1 -1
  43. package/dist/components/breadcrumb/breadcrumb.js +1 -1
  44. package/dist/components/breadcrumb/breadcrumb.js.map +1 -1
  45. package/dist/components/button/button-variants.js +1 -1
  46. package/dist/components/button/button-variants.js.map +1 -1
  47. package/dist/components/button/button.d.ts +11 -1
  48. package/dist/components/button/button.d.ts.map +1 -1
  49. package/dist/components/button/button.js +1 -1
  50. package/dist/components/button/button.js.map +1 -1
  51. package/dist/components/button-group/button-group.d.ts +10 -0
  52. package/dist/components/button-group/button-group.d.ts.map +1 -1
  53. package/dist/components/button-group/button-group.js +1 -1
  54. package/dist/components/button-group/button-group.js.map +1 -1
  55. package/dist/components/calendar/calendar.d.ts +5 -0
  56. package/dist/components/calendar/calendar.d.ts.map +1 -1
  57. package/dist/components/calendar/calendar.js +1 -1
  58. package/dist/components/calendar/calendar.js.map +1 -1
  59. package/dist/components/card/card.d.ts +43 -0
  60. package/dist/components/card/card.d.ts.map +1 -0
  61. package/dist/components/card/card.js +103 -0
  62. package/dist/components/card/card.js.map +1 -0
  63. package/dist/components/carousel/carousel.d.ts +105 -5
  64. package/dist/components/carousel/carousel.d.ts.map +1 -1
  65. package/dist/components/carousel/carousel.js +157 -5
  66. package/dist/components/carousel/carousel.js.map +1 -1
  67. package/dist/components/checkbox/checkbox.js +1 -1
  68. package/dist/components/checkbox/checkbox.js.map +1 -1
  69. package/dist/components/checkbox-group/checkbox-group.d.ts +4 -0
  70. package/dist/components/checkbox-group/checkbox-group.d.ts.map +1 -1
  71. package/dist/components/checkbox-group/checkbox-group.js +1 -1
  72. package/dist/components/checkbox-group/checkbox-group.js.map +1 -1
  73. package/dist/components/chip/chip.d.ts +32 -0
  74. package/dist/components/chip/chip.d.ts.map +1 -1
  75. package/dist/components/chip/chip.js +1 -1
  76. package/dist/components/chip/chip.js.map +1 -1
  77. package/dist/components/collapsible/collapsible.js +1 -1
  78. package/dist/components/collapsible/collapsible.js.map +1 -1
  79. package/dist/components/color-area/color-area.d.ts +53 -0
  80. package/dist/components/color-area/color-area.d.ts.map +1 -0
  81. package/dist/components/color-area/color-area.js +245 -0
  82. package/dist/components/color-area/color-area.js.map +1 -0
  83. package/dist/components/color-picker/color-picker.d.ts +152 -0
  84. package/dist/components/color-picker/color-picker.d.ts.map +1 -0
  85. package/dist/components/color-picker/color-picker.js +327 -0
  86. package/dist/components/color-picker/color-picker.js.map +1 -0
  87. package/dist/components/color-slider/color-slider.d.ts +48 -0
  88. package/dist/components/color-slider/color-slider.d.ts.map +1 -0
  89. package/dist/components/color-slider/color-slider.js +216 -0
  90. package/dist/components/color-slider/color-slider.js.map +1 -0
  91. package/dist/components/color-swatch/color-swatch.d.ts +47 -0
  92. package/dist/components/color-swatch/color-swatch.d.ts.map +1 -0
  93. package/dist/components/color-swatch/color-swatch.js +66 -0
  94. package/dist/components/color-swatch/color-swatch.js.map +1 -0
  95. package/dist/components/color-swatch-picker/color-swatch-picker.d.ts +62 -0
  96. package/dist/components/color-swatch-picker/color-swatch-picker.d.ts.map +1 -0
  97. package/dist/components/color-swatch-picker/color-swatch-picker.js +202 -0
  98. package/dist/components/color-swatch-picker/color-swatch-picker.js.map +1 -0
  99. package/dist/components/combobox/combobox.d.ts +25 -1
  100. package/dist/components/combobox/combobox.d.ts.map +1 -1
  101. package/dist/components/combobox/combobox.js +2 -2
  102. package/dist/components/combobox/combobox.js.map +1 -1
  103. package/dist/components/context-menu/context-menu.d.ts +7 -1
  104. package/dist/components/context-menu/context-menu.d.ts.map +1 -1
  105. package/dist/components/context-menu/context-menu.js +5 -5
  106. package/dist/components/context-menu/context-menu.js.map +1 -1
  107. package/dist/components/copy-button/copy-button.d.ts +15 -0
  108. package/dist/components/copy-button/copy-button.d.ts.map +1 -1
  109. package/dist/components/copy-button/copy-button.js +1 -1
  110. package/dist/components/copy-button/copy-button.js.map +1 -1
  111. package/dist/components/countdown/countdown.d.ts +14 -0
  112. package/dist/components/countdown/countdown.d.ts.map +1 -1
  113. package/dist/components/countdown/countdown.js +1 -1
  114. package/dist/components/countdown/countdown.js.map +1 -1
  115. package/dist/components/date-field/date-field.d.ts +35 -0
  116. package/dist/components/date-field/date-field.d.ts.map +1 -1
  117. package/dist/components/date-field/date-field.js +1 -1
  118. package/dist/components/date-field/date-field.js.map +1 -1
  119. package/dist/components/date-picker/date-picker.d.ts +94 -0
  120. package/dist/components/date-picker/date-picker.d.ts.map +1 -1
  121. package/dist/components/date-picker/date-picker.js +1 -1
  122. package/dist/components/date-picker/date-picker.js.map +1 -1
  123. package/dist/components/dialog/dialog.d.ts +20 -2
  124. package/dist/components/dialog/dialog.d.ts.map +1 -1
  125. package/dist/components/dialog/dialog.js +8 -4
  126. package/dist/components/dialog/dialog.js.map +1 -1
  127. package/dist/components/drawer/drawer.d.ts +22 -2
  128. package/dist/components/drawer/drawer.d.ts.map +1 -1
  129. package/dist/components/drawer/drawer.js +13 -7
  130. package/dist/components/drawer/drawer.js.map +1 -1
  131. package/dist/components/dropdown-menu/dropdown-menu.d.ts +7 -1
  132. package/dist/components/dropdown-menu/dropdown-menu.d.ts.map +1 -1
  133. package/dist/components/dropdown-menu/dropdown-menu.js +5 -5
  134. package/dist/components/dropdown-menu/dropdown-menu.js.map +1 -1
  135. package/dist/components/field/field.js +1 -1
  136. package/dist/components/field/field.js.map +1 -1
  137. package/dist/components/fieldset/fieldset.js +1 -1
  138. package/dist/components/fieldset/fieldset.js.map +1 -1
  139. package/dist/components/gradient-glow/gradient-glow.d.ts +45 -0
  140. package/dist/components/gradient-glow/gradient-glow.d.ts.map +1 -1
  141. package/dist/components/gradient-glow/gradient-glow.js +1 -1
  142. package/dist/components/gradient-glow/gradient-glow.js.map +1 -1
  143. package/dist/components/input/input-variants.js +1 -1
  144. package/dist/components/input/input-variants.js.map +1 -1
  145. package/dist/components/input/input.d.ts +21 -1
  146. package/dist/components/input/input.d.ts.map +1 -1
  147. package/dist/components/input/input.js +3 -3
  148. package/dist/components/input/input.js.map +1 -1
  149. package/dist/components/kbd/kbd.d.ts +8 -0
  150. package/dist/components/kbd/kbd.d.ts.map +1 -1
  151. package/dist/components/kbd/kbd.js +1 -1
  152. package/dist/components/kbd/kbd.js.map +1 -1
  153. package/dist/components/loader/loader.d.ts +8 -0
  154. package/dist/components/loader/loader.d.ts.map +1 -1
  155. package/dist/components/loader/loader.js +1 -1
  156. package/dist/components/loader/loader.js.map +1 -1
  157. package/dist/components/menubar/menubar.d.ts +8 -0
  158. package/dist/components/menubar/menubar.d.ts.map +1 -1
  159. package/dist/components/menubar/menubar.js +1 -1
  160. package/dist/components/menubar/menubar.js.map +1 -1
  161. package/dist/components/meter/meter.d.ts +4 -0
  162. package/dist/components/meter/meter.d.ts.map +1 -1
  163. package/dist/components/meter/meter.js +1 -1
  164. package/dist/components/meter/meter.js.map +1 -1
  165. package/dist/components/navigation/navigation-link-variants.d.ts +1 -1
  166. package/dist/components/navigation/navigation-link-variants.js +1 -1
  167. package/dist/components/navigation/navigation-link-variants.js.map +1 -1
  168. package/dist/components/navigation/navigation-link.d.ts +22 -0
  169. package/dist/components/navigation/navigation-link.d.ts.map +1 -1
  170. package/dist/components/navigation/navigation-link.js +1 -1
  171. package/dist/components/navigation/navigation-link.js.map +1 -1
  172. package/dist/components/navigation/navigation.d.ts +12 -0
  173. package/dist/components/navigation/navigation.d.ts.map +1 -1
  174. package/dist/components/navigation/navigation.js +1 -1
  175. package/dist/components/navigation/navigation.js.map +1 -1
  176. package/dist/components/navigation-menu/navigation-menu.d.ts +33 -0
  177. package/dist/components/navigation-menu/navigation-menu.d.ts.map +1 -1
  178. package/dist/components/navigation-menu/navigation-menu.js +1 -1
  179. package/dist/components/navigation-menu/navigation-menu.js.map +1 -1
  180. package/dist/components/number-field/number-field.d.ts +14 -0
  181. package/dist/components/number-field/number-field.d.ts.map +1 -1
  182. package/dist/components/number-field/number-field.js +1 -1
  183. package/dist/components/number-field/number-field.js.map +1 -1
  184. package/dist/components/otp-field/otp-field.d.ts +9 -0
  185. package/dist/components/otp-field/otp-field.d.ts.map +1 -1
  186. package/dist/components/otp-field/otp-field.js +1 -1
  187. package/dist/components/otp-field/otp-field.js.map +1 -1
  188. package/dist/components/pagination/pagination.d.ts +16 -0
  189. package/dist/components/pagination/pagination.d.ts.map +1 -1
  190. package/dist/components/pagination/pagination.js +1 -1
  191. package/dist/components/pagination/pagination.js.map +1 -1
  192. package/dist/components/popover/popover.d.ts +5 -1
  193. package/dist/components/popover/popover.d.ts.map +1 -1
  194. package/dist/components/popover/popover.js +2 -2
  195. package/dist/components/popover/popover.js.map +1 -1
  196. package/dist/components/preview-card/preview-card.d.ts +5 -1
  197. package/dist/components/preview-card/preview-card.d.ts.map +1 -1
  198. package/dist/components/preview-card/preview-card.js +2 -2
  199. package/dist/components/preview-card/preview-card.js.map +1 -1
  200. package/dist/components/progress/progress.d.ts +17 -0
  201. package/dist/components/progress/progress.d.ts.map +1 -1
  202. package/dist/components/progress/progress.js +1 -1
  203. package/dist/components/progress/progress.js.map +1 -1
  204. package/dist/components/radio/radio.js +1 -1
  205. package/dist/components/radio/radio.js.map +1 -1
  206. package/dist/components/radio-group/radio-group.d.ts +4 -0
  207. package/dist/components/radio-group/radio-group.d.ts.map +1 -1
  208. package/dist/components/radio-group/radio-group.js +1 -1
  209. package/dist/components/radio-group/radio-group.js.map +1 -1
  210. package/dist/components/rating/rating.d.ts +79 -0
  211. package/dist/components/rating/rating.d.ts.map +1 -0
  212. package/dist/components/rating/rating.js +301 -0
  213. package/dist/components/rating/rating.js.map +1 -0
  214. package/dist/components/scroll-area/scroll-area.d.ts +13 -0
  215. package/dist/components/scroll-area/scroll-area.d.ts.map +1 -1
  216. package/dist/components/scroll-area/scroll-area.js +1 -1
  217. package/dist/components/scroll-area/scroll-area.js.map +1 -1
  218. package/dist/components/select/select.d.ts +20 -1
  219. package/dist/components/select/select.d.ts.map +1 -1
  220. package/dist/components/select/select.js +2 -2
  221. package/dist/components/select/select.js.map +1 -1
  222. package/dist/components/separator/separator.d.ts +4 -0
  223. package/dist/components/separator/separator.d.ts.map +1 -1
  224. package/dist/components/separator/separator.js +1 -1
  225. package/dist/components/separator/separator.js.map +1 -1
  226. package/dist/components/skeleton/skeleton.d.ts +4 -0
  227. package/dist/components/skeleton/skeleton.d.ts.map +1 -1
  228. package/dist/components/skeleton/skeleton.js +1 -1
  229. package/dist/components/skeleton/skeleton.js.map +1 -1
  230. package/dist/components/slider/slider.d.ts +5 -0
  231. package/dist/components/slider/slider.d.ts.map +1 -1
  232. package/dist/components/slider/slider.js +1 -1
  233. package/dist/components/slider/slider.js.map +1 -1
  234. package/dist/components/sparkline/sparkline.d.ts +44 -0
  235. package/dist/components/sparkline/sparkline.d.ts.map +1 -1
  236. package/dist/components/sparkline/sparkline.js +1 -1
  237. package/dist/components/sparkline/sparkline.js.map +1 -1
  238. package/dist/components/spinner/spinner.d.ts +8 -0
  239. package/dist/components/spinner/spinner.d.ts.map +1 -1
  240. package/dist/components/spinner/spinner.js +1 -1
  241. package/dist/components/spinner/spinner.js.map +1 -1
  242. package/dist/components/switch/switch.d.ts +4 -0
  243. package/dist/components/switch/switch.d.ts.map +1 -1
  244. package/dist/components/switch/switch.js +1 -1
  245. package/dist/components/switch/switch.js.map +1 -1
  246. package/dist/components/table/table.d.ts +28 -0
  247. package/dist/components/table/table.d.ts.map +1 -1
  248. package/dist/components/table/table.js +1 -1
  249. package/dist/components/table/table.js.map +1 -1
  250. package/dist/components/tabs/tabs.d.ts +31 -1
  251. package/dist/components/tabs/tabs.d.ts.map +1 -1
  252. package/dist/components/tabs/tabs.js +1 -1
  253. package/dist/components/tabs/tabs.js.map +1 -1
  254. package/dist/components/text-animate/text-animate.d.ts +31 -0
  255. package/dist/components/text-animate/text-animate.d.ts.map +1 -1
  256. package/dist/components/text-animate/text-animate.js +26 -9
  257. package/dist/components/text-animate/text-animate.js.map +1 -1
  258. package/dist/components/textarea/textarea.d.ts +15 -0
  259. package/dist/components/textarea/textarea.d.ts.map +1 -1
  260. package/dist/components/textarea/textarea.js +1 -1
  261. package/dist/components/textarea/textarea.js.map +1 -1
  262. package/dist/components/thumbnail/thumbnail.d.ts +20 -0
  263. package/dist/components/thumbnail/thumbnail.d.ts.map +1 -1
  264. package/dist/components/thumbnail/thumbnail.js +1 -1
  265. package/dist/components/thumbnail/thumbnail.js.map +1 -1
  266. package/dist/components/time-field/time-field.d.ts +35 -0
  267. package/dist/components/time-field/time-field.d.ts.map +1 -1
  268. package/dist/components/time-field/time-field.js +1 -1
  269. package/dist/components/time-field/time-field.js.map +1 -1
  270. package/dist/components/toast/toast.d.ts +18 -0
  271. package/dist/components/toast/toast.d.ts.map +1 -1
  272. package/dist/components/toast/toast.js +1 -1
  273. package/dist/components/toast/toast.js.map +1 -1
  274. package/dist/components/toc/toc.d.ts +10 -0
  275. package/dist/components/toc/toc.d.ts.map +1 -1
  276. package/dist/components/toc/toc.js +1 -1
  277. package/dist/components/toc/toc.js.map +1 -1
  278. package/dist/components/toggle-group/toggle-group.js +1 -1
  279. package/dist/components/toggle-group/toggle-group.js.map +1 -1
  280. package/dist/components/toolbar/toolbar.js +1 -1
  281. package/dist/components/toolbar/toolbar.js.map +1 -1
  282. package/dist/components/tooltip/tooltip.d.ts +5 -1
  283. package/dist/components/tooltip/tooltip.d.ts.map +1 -1
  284. package/dist/components/tooltip/tooltip.js +2 -2
  285. package/dist/components/tooltip/tooltip.js.map +1 -1
  286. package/dist/hooks/use-dismissible.d.ts +4 -0
  287. package/dist/hooks/use-dismissible.d.ts.map +1 -1
  288. package/dist/hooks/use-dismissible.js.map +1 -1
  289. package/dist/hooks/use-local-storage.js.map +1 -1
  290. package/dist/hooks/use-reduced-motion.d.ts +1 -1
  291. package/dist/hooks/use-reduced-motion.js.map +1 -1
  292. package/dist/hooks/use-theme.d.ts +1 -1
  293. package/dist/hooks/use-theme.js.map +1 -1
  294. package/dist/index.d.ts +9 -0
  295. package/dist/index.d.ts.map +1 -1
  296. package/dist/index.js +10 -1
  297. package/dist/index.js.map +1 -1
  298. package/dist/internal/color-control.d.ts +75 -0
  299. package/dist/internal/color-control.d.ts.map +1 -0
  300. package/dist/internal/color-control.js +78 -0
  301. package/dist/internal/color-control.js.map +1 -0
  302. package/dist/internal/color-math.d.ts +9 -0
  303. package/dist/internal/color-math.d.ts.map +1 -0
  304. package/dist/internal/color-math.js +34 -0
  305. package/dist/internal/color-math.js.map +1 -0
  306. package/dist/internal/color-picker-context.d.ts +34 -0
  307. package/dist/internal/color-picker-context.d.ts.map +1 -0
  308. package/dist/internal/color-picker-context.js +41 -0
  309. package/dist/internal/color-picker-context.js.map +1 -0
  310. package/dist/{floating.d.ts → internal/floating.d.ts} +1 -1
  311. package/dist/internal/floating.d.ts.map +1 -0
  312. package/dist/internal/floating.js.map +1 -0
  313. package/dist/{modal.d.ts → internal/modal.d.ts} +1 -1
  314. package/dist/internal/modal.d.ts.map +1 -0
  315. package/dist/internal/modal.js.map +1 -0
  316. package/dist/internal/utils.d.ts.map +1 -0
  317. package/dist/internal/utils.js.map +1 -0
  318. package/dist/lib/color.d.ts +95 -0
  319. package/dist/lib/color.d.ts.map +1 -0
  320. package/dist/lib/color.js +328 -0
  321. package/dist/lib/color.js.map +1 -0
  322. package/dist/providers/direction-provider.d.ts +4 -4
  323. package/dist/providers/direction-provider.d.ts.map +1 -1
  324. package/dist/providers/direction-provider.js.map +1 -1
  325. package/dist/providers/reduced-motion-provider.d.ts +4 -8
  326. package/dist/providers/reduced-motion-provider.d.ts.map +1 -1
  327. package/dist/providers/reduced-motion-provider.js.map +1 -1
  328. package/dist/providers/theme-provider/theme-provider.d.ts +28 -12
  329. package/dist/providers/theme-provider/theme-provider.d.ts.map +1 -1
  330. package/dist/providers/theme-provider/theme-provider.js.map +1 -1
  331. package/dist/providers/theme-provider/theme-script.js.map +1 -1
  332. package/package.json +75 -17
  333. package/src/components/accordion/accordion.tsx +25 -1
  334. package/src/components/alert/alert.tsx +30 -2
  335. package/src/components/alert-dialog/alert-dialog.test.tsx +34 -2
  336. package/src/components/alert-dialog/alert-dialog.tsx +21 -5
  337. package/src/components/autocomplete/autocomplete.test.tsx +1 -1
  338. package/src/components/autocomplete/autocomplete.tsx +22 -2
  339. package/src/components/avatar/avatar.test.tsx +2 -2
  340. package/src/components/avatar/avatar.tsx +17 -1
  341. package/src/components/background-pattern/background-pattern-interactive.tsx +1 -1
  342. package/src/components/background-pattern/background-pattern-shared.tsx +1 -1
  343. package/src/components/background-pattern/background-pattern.test.tsx +1 -1
  344. package/src/components/background-pattern/background-pattern.tsx +14 -6
  345. package/src/components/badge/badge.tsx +14 -2
  346. package/src/components/border-beam/border-beam.test.tsx +91 -0
  347. package/src/components/border-beam/border-beam.tsx +131 -0
  348. package/src/components/breadcrumb/breadcrumb.tsx +9 -1
  349. package/src/components/button/button-variants.ts +1 -1
  350. package/src/components/button/button.tsx +13 -2
  351. package/src/components/button-group/button-group.tsx +11 -1
  352. package/src/components/calendar/calendar.tsx +6 -1
  353. package/src/components/card/card.test.tsx +98 -0
  354. package/src/components/card/card.tsx +154 -0
  355. package/src/components/carousel/carousel.test.tsx +155 -0
  356. package/src/components/carousel/carousel.tsx +305 -5
  357. package/src/components/checkbox/checkbox.test.tsx +2 -2
  358. package/src/components/checkbox/checkbox.tsx +1 -1
  359. package/src/components/checkbox-group/checkbox-group.tsx +5 -1
  360. package/src/components/chip/chip.tsx +33 -1
  361. package/src/components/collapsible/collapsible.tsx +1 -1
  362. package/src/components/color-area/color-area.test.tsx +242 -0
  363. package/src/components/color-area/color-area.tsx +356 -0
  364. package/src/components/color-picker/color-picker.test.tsx +286 -0
  365. package/src/components/color-picker/color-picker.tsx +546 -0
  366. package/src/components/color-slider/color-slider.test.tsx +222 -0
  367. package/src/components/color-slider/color-slider.tsx +330 -0
  368. package/src/components/color-swatch/color-swatch.test.tsx +117 -0
  369. package/src/components/color-swatch/color-swatch.tsx +119 -0
  370. package/src/components/color-swatch-picker/color-swatch-picker.test.tsx +287 -0
  371. package/src/components/color-swatch-picker/color-swatch-picker.tsx +327 -0
  372. package/src/components/combobox/combobox.test.tsx +1 -1
  373. package/src/components/combobox/combobox.tsx +26 -2
  374. package/src/components/context-menu/context-menu.tsx +11 -5
  375. package/src/components/copy-button/copy-button.test.tsx +1 -1
  376. package/src/components/copy-button/copy-button.tsx +16 -1
  377. package/src/components/countdown/countdown.tsx +15 -1
  378. package/src/components/date-field/date-field.tsx +36 -1
  379. package/src/components/date-picker/date-picker.test.tsx +1 -1
  380. package/src/components/date-picker/date-picker.tsx +95 -1
  381. package/src/components/dialog/dialog.test.tsx +30 -1
  382. package/src/components/dialog/dialog.tsx +28 -6
  383. package/src/components/drawer/drawer.test.tsx +32 -1
  384. package/src/components/drawer/drawer.tsx +37 -7
  385. package/src/components/dropdown-menu/dropdown-menu.tsx +11 -5
  386. package/src/components/field/field.tsx +1 -1
  387. package/src/components/fieldset/fieldset.tsx +1 -1
  388. package/src/components/gradient-glow/gradient-glow.test.tsx +1 -1
  389. package/src/components/gradient-glow/gradient-glow.tsx +46 -1
  390. package/src/components/input/input-variants.ts +1 -1
  391. package/src/components/input/input.tsx +24 -4
  392. package/src/components/kbd/kbd.tsx +9 -1
  393. package/src/components/loader/loader.tsx +9 -1
  394. package/src/components/menubar/menubar.tsx +9 -1
  395. package/src/components/meter/meter.tsx +5 -1
  396. package/src/components/navigation/navigation-link-variants.ts +1 -1
  397. package/src/components/navigation/navigation-link.tsx +23 -1
  398. package/src/components/navigation/navigation.tsx +23 -3
  399. package/src/components/navigation-menu/navigation-menu.tsx +34 -1
  400. package/src/components/number-field/number-field.tsx +15 -1
  401. package/src/components/otp-field/otp-field.tsx +10 -1
  402. package/src/components/pagination/pagination.tsx +17 -1
  403. package/src/components/popover/popover.test.tsx +1 -1
  404. package/src/components/popover/popover.tsx +6 -2
  405. package/src/components/preview-card/preview-card.tsx +6 -2
  406. package/src/components/progress/progress.tsx +18 -1
  407. package/src/components/radio/radio.test.tsx +1 -1
  408. package/src/components/radio/radio.tsx +1 -1
  409. package/src/components/radio-group/radio-group.test.tsx +1 -1
  410. package/src/components/radio-group/radio-group.tsx +5 -1
  411. package/src/components/rating/rating.test.tsx +246 -0
  412. package/src/components/rating/rating.tsx +457 -0
  413. package/src/components/scroll-area/scroll-area.test.tsx +1 -1
  414. package/src/components/scroll-area/scroll-area.tsx +14 -1
  415. package/src/components/select/select.tsx +21 -2
  416. package/src/components/separator/separator.tsx +5 -1
  417. package/src/components/skeleton/skeleton.tsx +5 -1
  418. package/src/components/slider/slider.test.tsx +1 -1
  419. package/src/components/slider/slider.tsx +6 -1
  420. package/src/components/sparkline/sparkline.test.tsx +1 -1
  421. package/src/components/sparkline/sparkline.tsx +45 -1
  422. package/src/components/spinner/spinner.tsx +9 -1
  423. package/src/components/switch/switch.test.tsx +1 -1
  424. package/src/components/switch/switch.tsx +5 -1
  425. package/src/components/table/table.tsx +29 -1
  426. package/src/components/tabs/tabs.test.tsx +1 -1
  427. package/src/components/tabs/tabs.tsx +33 -2
  428. package/src/components/text-animate/text-animate.test.tsx +62 -0
  429. package/src/components/text-animate/text-animate.tsx +77 -9
  430. package/src/components/textarea/textarea.tsx +16 -1
  431. package/src/components/thumbnail/thumbnail.test.tsx +1 -1
  432. package/src/components/thumbnail/thumbnail.tsx +21 -1
  433. package/src/components/time-field/time-field.tsx +36 -1
  434. package/src/components/toast/toast.test.tsx +1 -1
  435. package/src/components/toast/toast.tsx +19 -1
  436. package/src/components/toc/toc.tsx +11 -1
  437. package/src/components/toggle/toggle.test.tsx +1 -1
  438. package/src/components/toggle-group/toggle-group.tsx +1 -1
  439. package/src/components/toolbar/toolbar.tsx +1 -1
  440. package/src/components/tooltip/tooltip.test.tsx +1 -1
  441. package/src/components/tooltip/tooltip.tsx +6 -2
  442. package/src/hooks/use-dismissible.ts +4 -0
  443. package/src/hooks/use-local-storage.ts +3 -3
  444. package/src/hooks/use-reduced-motion.ts +1 -1
  445. package/src/hooks/use-theme.ts +1 -1
  446. package/src/index.ts +11 -2
  447. package/src/internal/color-control.ts +178 -0
  448. package/src/internal/color-math.ts +44 -0
  449. package/src/internal/color-picker-context.ts +80 -0
  450. package/src/{floating.ts → internal/floating.ts} +3 -3
  451. package/src/{modal.ts → internal/modal.ts} +3 -3
  452. package/src/lib/color.test.ts +178 -0
  453. package/src/lib/color.ts +471 -0
  454. package/src/providers/direction-provider.tsx +4 -4
  455. package/src/providers/reduced-motion-provider.tsx +4 -8
  456. package/src/providers/theme-provider/theme-provider.tsx +28 -12
  457. package/src/providers/theme-provider/theme-script.tsx +2 -2
  458. package/src/test/setup.ts +1 -1
  459. package/styles.css +28 -4
  460. package/dist/floating.d.ts.map +0 -1
  461. package/dist/floating.js.map +0 -1
  462. package/dist/modal.d.ts.map +0 -1
  463. package/dist/modal.js.map +0 -1
  464. package/dist/utils.d.ts.map +0 -1
  465. package/dist/utils.js.map +0 -1
  466. /package/dist/{floating.js → internal/floating.js} +0 -0
  467. /package/dist/{modal.js → internal/modal.js} +0 -0
  468. /package/dist/{utils.d.ts → internal/utils.d.ts} +0 -0
  469. /package/dist/{utils.js → internal/utils.js} +0 -0
  470. /package/src/{floating.test.ts → internal/floating.test.ts} +0 -0
  471. /package/src/{modal.test.ts → internal/modal.test.ts} +0 -0
  472. /package/src/{utils.test.tsx → internal/utils.test.tsx} +0 -0
  473. /package/src/{utils.ts → internal/utils.ts} +0 -0
@@ -0,0 +1,246 @@
1
+ import { fireEvent, render, screen, waitFor } from '@testing-library/react'
2
+ import userEvent from '@testing-library/user-event'
3
+ import { describe, it, expect, vi } from 'vitest'
4
+ import { axe } from 'vitest-axe'
5
+ import { DirectionProvider } from '../../providers/direction-provider'
6
+ import { Rating } from './rating'
7
+
8
+ describe('Rating', () => {
9
+ it('renders a radiogroup with one radio per item', () => {
10
+ render(<Rating aria-label="Rating" />)
11
+ expect(screen.getByRole('radiogroup', { name: 'Rating' })).toHaveAttribute('data-slot', 'rating')
12
+ expect(screen.getAllByRole('radio')).toHaveLength(5)
13
+ })
14
+
15
+ it('honors count and marks the item holding the value as checked', () => {
16
+ render(<Rating aria-label="Rating" count={3} defaultValue={2} />)
17
+ const radios = screen.getAllByRole('radio')
18
+ expect(radios).toHaveLength(3)
19
+ expect(radios[1]).toBeChecked()
20
+ expect(radios[0]).not.toBeChecked()
21
+ })
22
+
23
+ it('selects on click and reports the new value', async () => {
24
+ const user = userEvent.setup()
25
+ const onValueChange = vi.fn()
26
+ render(<Rating aria-label="Rating" onValueChange={onValueChange} />)
27
+
28
+ await user.click(screen.getAllByRole('radio')[3])
29
+
30
+ expect(onValueChange).toHaveBeenCalledWith(4)
31
+ expect(screen.getAllByRole('radio')[3]).toBeChecked()
32
+ })
33
+
34
+ it('stays on the controlled value until the consumer updates it', async () => {
35
+ const user = userEvent.setup()
36
+ const onValueChange = vi.fn()
37
+ render(<Rating aria-label="Rating" value={2} onValueChange={onValueChange} />)
38
+
39
+ await user.click(screen.getAllByRole('radio')[4])
40
+
41
+ expect(onValueChange).toHaveBeenCalledWith(5)
42
+ expect(screen.getAllByRole('radio')[1]).toBeChecked()
43
+ expect(screen.getAllByRole('radio')[4]).not.toBeChecked()
44
+ })
45
+
46
+ it('clears the rating when clearable and the current item is picked again', async () => {
47
+ const user = userEvent.setup()
48
+ const onValueChange = vi.fn()
49
+ render(<Rating aria-label="Rating" defaultValue={3} clearable onValueChange={onValueChange} />)
50
+
51
+ await user.click(screen.getAllByRole('radio')[2])
52
+
53
+ expect(onValueChange).toHaveBeenCalledWith(0)
54
+ expect(screen.getAllByRole('radio').some((radio) => radio.getAttribute('aria-checked') === 'true')).toBe(false)
55
+ })
56
+
57
+ it('moves the value by step with the arrow keys', async () => {
58
+ const user = userEvent.setup()
59
+ const onValueChange = vi.fn()
60
+ render(<Rating aria-label="Rating" defaultValue={2} step={0.5} onValueChange={onValueChange} />)
61
+
62
+ await user.tab()
63
+ await user.keyboard('{ArrowRight}')
64
+ expect(onValueChange).toHaveBeenLastCalledWith(2.5)
65
+
66
+ await user.keyboard('{ArrowLeft}{ArrowLeft}')
67
+ expect(onValueChange).toHaveBeenLastCalledWith(1.5)
68
+
69
+ await user.keyboard('{End}')
70
+ expect(onValueChange).toHaveBeenLastCalledWith(5)
71
+
72
+ await user.keyboard('{Home}')
73
+ expect(onValueChange).toHaveBeenLastCalledWith(0.5)
74
+ })
75
+
76
+ it('flips the horizontal arrow keys in RTL', async () => {
77
+ const user = userEvent.setup()
78
+ const onValueChange = vi.fn()
79
+ render(
80
+ <DirectionProvider dir="rtl">
81
+ <Rating aria-label="Rating" defaultValue={3} onValueChange={onValueChange} />
82
+ </DirectionProvider>,
83
+ )
84
+
85
+ await user.tab()
86
+ await user.keyboard('{ArrowRight}')
87
+
88
+ expect(onValueChange).toHaveBeenLastCalledWith(2)
89
+ })
90
+
91
+ it('steps to the next item with Down/Right and the previous with Up/Left', async () => {
92
+ const user = userEvent.setup()
93
+ const onValueChange = vi.fn()
94
+ render(<Rating aria-label="Rating" defaultValue={3} onValueChange={onValueChange} />)
95
+
96
+ await user.tab()
97
+ await user.keyboard('{ArrowDown}')
98
+ expect(onValueChange).toHaveBeenLastCalledWith(4)
99
+
100
+ await user.keyboard('{ArrowUp}{ArrowUp}')
101
+ expect(onValueChange).toHaveBeenLastCalledWith(2)
102
+ })
103
+
104
+ it('renders vertically and fills from the top', async () => {
105
+ const onValueChange = vi.fn()
106
+ const { container } = render(
107
+ <Rating aria-label="Rating" count={3} orientation="vertical" value={2} onValueChange={onValueChange} />,
108
+ )
109
+
110
+ const root = screen.getByRole('radiogroup')
111
+ expect(root).toHaveAttribute('data-orientation', 'vertical')
112
+ expect(root).toHaveAttribute('aria-orientation', 'vertical')
113
+
114
+ const clips = [...container.querySelectorAll<HTMLElement>('[data-slot=rating-item-fill]')].map(
115
+ (el) => el.style.clipPath,
116
+ )
117
+ expect(clips).toEqual(['inset(0 0 0% 0)', 'inset(0 0 0% 0)', 'inset(0 0 100% 0)'])
118
+
119
+ vi.spyOn(root, 'getBoundingClientRect').mockReturnValue({ top: 0, height: 300 } as DOMRect)
120
+ fireEvent.pointerMove(root, { clientY: 250 })
121
+ fireEvent.click(screen.getAllByRole('radio')[2], { detail: 1 })
122
+ expect(onValueChange).toHaveBeenCalledWith(3)
123
+ })
124
+
125
+ it('keeps a single tab stop on the checked item', async () => {
126
+ const user = userEvent.setup()
127
+ render(<Rating aria-label="Rating" defaultValue={4} />)
128
+
129
+ await user.tab()
130
+
131
+ expect(screen.getAllByRole('radio')[3]).toHaveFocus()
132
+ })
133
+
134
+ it('exposes a read-only rating as one labeled image', () => {
135
+ render(<Rating readOnly value={4.5} step={0.5} />)
136
+ expect(screen.getByRole('img', { name: '4.5 out of 5' })).toHaveAttribute('data-readonly', '')
137
+ expect(screen.queryAllByRole('radio')).toHaveLength(0)
138
+ })
139
+
140
+ it('blocks interaction when disabled', async () => {
141
+ const user = userEvent.setup()
142
+ const onValueChange = vi.fn()
143
+ render(<Rating aria-label="Rating" disabled onValueChange={onValueChange} />)
144
+
145
+ await user.click(screen.getAllByRole('radio')[2])
146
+
147
+ expect(onValueChange).not.toHaveBeenCalled()
148
+ expect(screen.getByRole('radiogroup')).toHaveAttribute('data-disabled', '')
149
+ })
150
+
151
+ it('submits the value through a hidden input', () => {
152
+ const { container } = render(<Rating aria-label="Rating" name="score" defaultValue={3} />)
153
+ expect(container.querySelector('input[name="score"]')).toHaveValue('3')
154
+ })
155
+
156
+ it('renders the built-in star by default and swaps in a custom icon pair', () => {
157
+ const { container, rerender } = render(<Rating aria-label="Rating" count={1} />)
158
+ expect(container.querySelectorAll('svg')).toHaveLength(2)
159
+
160
+ rerender(
161
+ <Rating
162
+ aria-label="Rating"
163
+ count={1}
164
+ icon={{ empty: <svg data-testid="empty" />, filled: <svg data-testid="filled" /> }}
165
+ variant="outline"
166
+ />,
167
+ )
168
+ expect(screen.getByTestId('empty')).toBeInTheDocument()
169
+ expect(screen.getByTestId('filled')).toBeInTheDocument()
170
+ })
171
+
172
+ it('still fills the selection when the hover preview is off', async () => {
173
+ const { container } = render(<Rating aria-label="Rating" count={3} hoverable={false} />)
174
+ const root = screen.getByRole('radiogroup')
175
+ vi.spyOn(root, 'getBoundingClientRect').mockReturnValue({ left: 0, width: 300 } as DOMRect)
176
+
177
+ fireEvent.pointerMove(root, { clientX: 150 })
178
+ fireEvent.click(screen.getAllByRole('radio')[1], { detail: 1 })
179
+
180
+ await waitFor(() => {
181
+ const clips = [...container.querySelectorAll<HTMLElement>('[data-slot=rating-item-fill]')].map(
182
+ (el) => el.style.clipPath,
183
+ )
184
+ expect(clips).toEqual(['inset(0 0% 0 0)', 'inset(0 0% 0 0)', 'inset(0 100% 0 0)'])
185
+ })
186
+ })
187
+
188
+ it('holds the pressed item scaled down until the pointer is released', async () => {
189
+ const { container } = render(<Rating aria-label="Rating" count={3} />)
190
+ const icon = () => container.querySelectorAll<HTMLElement>('[data-slot=rating-item] > span')[1]!
191
+ const scaleOf = (el: HTMLElement) => Number(/scale\(([\d.]+)\)/.exec(el.style.transform)?.[1] ?? 1)
192
+
193
+ fireEvent.pointerDown(screen.getAllByRole('radio')[1])
194
+ await waitFor(() => expect(scaleOf(icon())).toBeLessThan(1))
195
+
196
+ fireEvent.pointerUp(screen.getAllByRole('radio')[1])
197
+ await waitFor(() => expect(scaleOf(icon())).toBe(1))
198
+ })
199
+
200
+ it('presses an item even while another one holds focus', async () => {
201
+ const { container } = render(<Rating aria-label="Rating" count={3} />)
202
+ const radios = screen.getAllByRole('radio')
203
+ const icon = () => container.querySelectorAll<HTMLElement>('[data-slot=rating-item] > span')[0]!
204
+ const scaleOf = (el: HTMLElement) => Number(/scale\(([\d.]+)\)/.exec(el.style.transform)?.[1] ?? 1)
205
+
206
+ radios[2].focus()
207
+ fireEvent.pointerDown(radios[0])
208
+ fireEvent.blur(radios[2])
209
+
210
+ await waitFor(() => expect(scaleOf(icon())).toBeLessThan(1))
211
+ })
212
+
213
+ it('clips each item fill to the value it holds', () => {
214
+ const { container } = render(<Rating aria-label="Rating" value={2.4} step={0.2} count={3} />)
215
+ const clips = [...container.querySelectorAll<HTMLElement>('[data-slot=rating-item-fill]')].map(
216
+ (el) => el.style.clipPath,
217
+ )
218
+ expect(clips).toEqual(['inset(0 0% 0 0)', 'inset(0 0% 0 0)', 'inset(0 60% 0 0)'])
219
+ })
220
+
221
+ it('sizes the icons from a number of pixels or any CSS length', () => {
222
+ const { container, rerender } = render(<Rating aria-label="Rating" />)
223
+ const root = () => container.querySelector<HTMLElement>('[data-slot=rating]')!
224
+
225
+ expect(root().style.getPropertyValue('--rating-size')).toBe('24px')
226
+
227
+ rerender(<Rating aria-label="Rating" size={40} />)
228
+ expect(root().style.getPropertyValue('--rating-size')).toBe('40px')
229
+
230
+ rerender(<Rating aria-label="Rating" size="1.5em" style={{ opacity: 0.5 }} />)
231
+ expect(root().style.getPropertyValue('--rating-size')).toBe('1.5em')
232
+ expect(root().style.opacity).toBe('0.5')
233
+ })
234
+
235
+ it('merges className with the layout classes', () => {
236
+ render(<Rating aria-label="Rating" className="custom-class" />)
237
+ const root = screen.getByRole('radiogroup')
238
+ expect(root.className).toContain('custom-class')
239
+ expect(root.className).toContain('inline-flex')
240
+ })
241
+
242
+ it('has no accessibility violations', async () => {
243
+ const { container } = render(<Rating aria-label="Rating" defaultValue={3} />)
244
+ expect(await axe(container)).toHaveNoViolations()
245
+ })
246
+ })
@@ -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 }