@appica/ui-react 1.0.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 (534) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +91 -0
  3. package/dist/components/accordion/accordion.d.ts +29 -0
  4. package/dist/components/accordion/accordion.d.ts.map +1 -0
  5. package/dist/components/accordion/accordion.js +210 -0
  6. package/dist/components/accordion/accordion.js.map +1 -0
  7. package/dist/components/alert/alert.d.ts +32 -0
  8. package/dist/components/alert/alert.d.ts.map +1 -0
  9. package/dist/components/alert/alert.js +203 -0
  10. package/dist/components/alert/alert.js.map +1 -0
  11. package/dist/components/alert-dialog/alert-dialog.d.ts +28 -0
  12. package/dist/components/alert-dialog/alert-dialog.d.ts.map +1 -0
  13. package/dist/components/alert-dialog/alert-dialog.js +127 -0
  14. package/dist/components/alert-dialog/alert-dialog.js.map +1 -0
  15. package/dist/components/autocomplete/autocomplete.d.ts +48 -0
  16. package/dist/components/autocomplete/autocomplete.d.ts.map +1 -0
  17. package/dist/components/autocomplete/autocomplete.js +299 -0
  18. package/dist/components/autocomplete/autocomplete.js.map +1 -0
  19. package/dist/components/avatar/avatar.d.ts +29 -0
  20. package/dist/components/avatar/avatar.d.ts.map +1 -0
  21. package/dist/components/avatar/avatar.js +115 -0
  22. package/dist/components/avatar/avatar.js.map +1 -0
  23. package/dist/components/background-pattern/background-pattern-interactive.d.ts +10 -0
  24. package/dist/components/background-pattern/background-pattern-interactive.d.ts.map +1 -0
  25. package/dist/components/background-pattern/background-pattern-interactive.js +72 -0
  26. package/dist/components/background-pattern/background-pattern-interactive.js.map +1 -0
  27. package/dist/components/background-pattern/background-pattern-shared.d.ts +12 -0
  28. package/dist/components/background-pattern/background-pattern-shared.d.ts.map +1 -0
  29. package/dist/components/background-pattern/background-pattern-shared.js +73 -0
  30. package/dist/components/background-pattern/background-pattern-shared.js.map +1 -0
  31. package/dist/components/background-pattern/background-pattern.d.ts +23 -0
  32. package/dist/components/background-pattern/background-pattern.d.ts.map +1 -0
  33. package/dist/components/background-pattern/background-pattern.js +49 -0
  34. package/dist/components/background-pattern/background-pattern.js.map +1 -0
  35. package/dist/components/background-pattern/index.d.ts +4 -0
  36. package/dist/components/background-pattern/index.d.ts.map +1 -0
  37. package/dist/components/background-pattern/index.js +3 -0
  38. package/dist/components/background-pattern/index.js.map +1 -0
  39. package/dist/components/badge/badge.d.ts +17 -0
  40. package/dist/components/badge/badge.d.ts.map +1 -0
  41. package/dist/components/badge/badge.js +134 -0
  42. package/dist/components/badge/badge.js.map +1 -0
  43. package/dist/components/breadcrumb/breadcrumb.d.ts +24 -0
  44. package/dist/components/breadcrumb/breadcrumb.d.ts.map +1 -0
  45. package/dist/components/breadcrumb/breadcrumb.js +106 -0
  46. package/dist/components/breadcrumb/breadcrumb.js.map +1 -0
  47. package/dist/components/button/button-variants.d.ts +6 -0
  48. package/dist/components/button/button-variants.d.ts.map +1 -0
  49. package/dist/components/button/button-variants.js +69 -0
  50. package/dist/components/button/button-variants.js.map +1 -0
  51. package/dist/components/button/button.d.ts +10 -0
  52. package/dist/components/button/button.d.ts.map +1 -0
  53. package/dist/components/button/button.js +26 -0
  54. package/dist/components/button/button.js.map +1 -0
  55. package/dist/components/button/index.d.ts +3 -0
  56. package/dist/components/button/index.d.ts.map +1 -0
  57. package/dist/components/button/index.js +3 -0
  58. package/dist/components/button/index.js.map +1 -0
  59. package/dist/components/button-group/button-group-context.d.ts +13 -0
  60. package/dist/components/button-group/button-group-context.d.ts.map +1 -0
  61. package/dist/components/button-group/button-group-context.js +7 -0
  62. package/dist/components/button-group/button-group-context.js.map +1 -0
  63. package/dist/components/button-group/button-group.d.ts +12 -0
  64. package/dist/components/button-group/button-group.d.ts.map +1 -0
  65. package/dist/components/button-group/button-group.js +45 -0
  66. package/dist/components/button-group/button-group.js.map +1 -0
  67. package/dist/components/calendar/calendar.d.ts +14 -0
  68. package/dist/components/calendar/calendar.d.ts.map +1 -0
  69. package/dist/components/calendar/calendar.js +228 -0
  70. package/dist/components/calendar/calendar.js.map +1 -0
  71. package/dist/components/carousel/carousel.d.ts +128 -0
  72. package/dist/components/carousel/carousel.d.ts.map +1 -0
  73. package/dist/components/carousel/carousel.js +795 -0
  74. package/dist/components/carousel/carousel.js.map +1 -0
  75. package/dist/components/checkbox/checkbox.d.ts +7 -0
  76. package/dist/components/checkbox/checkbox.d.ts.map +1 -0
  77. package/dist/components/checkbox/checkbox.js +128 -0
  78. package/dist/components/checkbox/checkbox.js.map +1 -0
  79. package/dist/components/checkbox-group/checkbox-group.d.ts +9 -0
  80. package/dist/components/checkbox-group/checkbox-group.d.ts.map +1 -0
  81. package/dist/components/checkbox-group/checkbox-group.js +18 -0
  82. package/dist/components/checkbox-group/checkbox-group.js.map +1 -0
  83. package/dist/components/chip/chip.d.ts +36 -0
  84. package/dist/components/chip/chip.d.ts.map +1 -0
  85. package/dist/components/chip/chip.js +159 -0
  86. package/dist/components/chip/chip.js.map +1 -0
  87. package/dist/components/collapsible/collapsible.d.ts +11 -0
  88. package/dist/components/collapsible/collapsible.d.ts.map +1 -0
  89. package/dist/components/collapsible/collapsible.js +41 -0
  90. package/dist/components/collapsible/collapsible.js.map +1 -0
  91. package/dist/components/combobox/combobox.d.ts +57 -0
  92. package/dist/components/combobox/combobox.d.ts.map +1 -0
  93. package/dist/components/combobox/combobox.js +456 -0
  94. package/dist/components/combobox/combobox.js.map +1 -0
  95. package/dist/components/context-menu/context-menu.d.ts +43 -0
  96. package/dist/components/context-menu/context-menu.d.ts.map +1 -0
  97. package/dist/components/context-menu/context-menu.js +243 -0
  98. package/dist/components/context-menu/context-menu.js.map +1 -0
  99. package/dist/components/copy-button/copy-button.d.ts +15 -0
  100. package/dist/components/copy-button/copy-button.d.ts.map +1 -0
  101. package/dist/components/copy-button/copy-button.js +126 -0
  102. package/dist/components/copy-button/copy-button.js.map +1 -0
  103. package/dist/components/countdown/countdown.d.ts +26 -0
  104. package/dist/components/countdown/countdown.d.ts.map +1 -0
  105. package/dist/components/countdown/countdown.js +111 -0
  106. package/dist/components/countdown/countdown.js.map +1 -0
  107. package/dist/components/date-field/date-field.d.ts +25 -0
  108. package/dist/components/date-field/date-field.d.ts.map +1 -0
  109. package/dist/components/date-field/date-field.js +403 -0
  110. package/dist/components/date-field/date-field.js.map +1 -0
  111. package/dist/components/date-picker/date-picker.d.ts +58 -0
  112. package/dist/components/date-picker/date-picker.d.ts.map +1 -0
  113. package/dist/components/date-picker/date-picker.js +449 -0
  114. package/dist/components/date-picker/date-picker.js.map +1 -0
  115. package/dist/components/dialog/dialog.d.ts +30 -0
  116. package/dist/components/dialog/dialog.d.ts.map +1 -0
  117. package/dist/components/dialog/dialog.js +138 -0
  118. package/dist/components/dialog/dialog.js.map +1 -0
  119. package/dist/components/drawer/drawer.d.ts +39 -0
  120. package/dist/components/drawer/drawer.d.ts.map +1 -0
  121. package/dist/components/drawer/drawer.js +270 -0
  122. package/dist/components/drawer/drawer.js.map +1 -0
  123. package/dist/components/dropdown-menu/dropdown-menu.d.ts +43 -0
  124. package/dist/components/dropdown-menu/dropdown-menu.d.ts.map +1 -0
  125. package/dist/components/dropdown-menu/dropdown-menu.js +235 -0
  126. package/dist/components/dropdown-menu/dropdown-menu.js.map +1 -0
  127. package/dist/components/field/field.d.ts +15 -0
  128. package/dist/components/field/field.d.ts.map +1 -0
  129. package/dist/components/field/field.js +62 -0
  130. package/dist/components/field/field.js.map +1 -0
  131. package/dist/components/fieldset/fieldset.d.ts +9 -0
  132. package/dist/components/fieldset/fieldset.d.ts.map +1 -0
  133. package/dist/components/fieldset/fieldset.js +20 -0
  134. package/dist/components/fieldset/fieldset.js.map +1 -0
  135. package/dist/components/form/form.d.ts +7 -0
  136. package/dist/components/form/form.d.ts.map +1 -0
  137. package/dist/components/form/form.js +9 -0
  138. package/dist/components/form/form.js.map +1 -0
  139. package/dist/components/gradient-glow/gradient-glow.d.ts +21 -0
  140. package/dist/components/gradient-glow/gradient-glow.d.ts.map +1 -0
  141. package/dist/components/gradient-glow/gradient-glow.js +99 -0
  142. package/dist/components/gradient-glow/gradient-glow.js.map +1 -0
  143. package/dist/components/input/index.d.ts +3 -0
  144. package/dist/components/input/index.d.ts.map +1 -0
  145. package/dist/components/input/index.js +3 -0
  146. package/dist/components/input/index.js.map +1 -0
  147. package/dist/components/input/input-variants.d.ts +7 -0
  148. package/dist/components/input/input-variants.d.ts.map +1 -0
  149. package/dist/components/input/input-variants.js +52 -0
  150. package/dist/components/input/input-variants.js.map +1 -0
  151. package/dist/components/input/input.d.ts +19 -0
  152. package/dist/components/input/input.d.ts.map +1 -0
  153. package/dist/components/input/input.js +96 -0
  154. package/dist/components/input/input.js.map +1 -0
  155. package/dist/components/kbd/kbd.d.ts +13 -0
  156. package/dist/components/kbd/kbd.d.ts.map +1 -0
  157. package/dist/components/kbd/kbd.js +34 -0
  158. package/dist/components/kbd/kbd.js.map +1 -0
  159. package/dist/components/loader/loader.d.ts +10 -0
  160. package/dist/components/loader/loader.d.ts.map +1 -0
  161. package/dist/components/loader/loader.js +137 -0
  162. package/dist/components/loader/loader.js.map +1 -0
  163. package/dist/components/menubar/menubar.d.ts +44 -0
  164. package/dist/components/menubar/menubar.d.ts.map +1 -0
  165. package/dist/components/menubar/menubar.js +114 -0
  166. package/dist/components/menubar/menubar.js.map +1 -0
  167. package/dist/components/meter/meter.d.ts +24 -0
  168. package/dist/components/meter/meter.d.ts.map +1 -0
  169. package/dist/components/meter/meter.js +105 -0
  170. package/dist/components/meter/meter.js.map +1 -0
  171. package/dist/components/navigation/index.d.ts +4 -0
  172. package/dist/components/navigation/index.d.ts.map +1 -0
  173. package/dist/components/navigation/index.js +4 -0
  174. package/dist/components/navigation/index.js.map +1 -0
  175. package/dist/components/navigation/navigation-context.d.ts +16 -0
  176. package/dist/components/navigation/navigation-context.d.ts.map +1 -0
  177. package/dist/components/navigation/navigation-context.js +10 -0
  178. package/dist/components/navigation/navigation-context.js.map +1 -0
  179. package/dist/components/navigation/navigation-link-variants.d.ts +9 -0
  180. package/dist/components/navigation/navigation-link-variants.d.ts.map +1 -0
  181. package/dist/components/navigation/navigation-link-variants.js +189 -0
  182. package/dist/components/navigation/navigation-link-variants.js.map +1 -0
  183. package/dist/components/navigation/navigation-link.d.ts +20 -0
  184. package/dist/components/navigation/navigation-link.d.ts.map +1 -0
  185. package/dist/components/navigation/navigation-link.js +54 -0
  186. package/dist/components/navigation/navigation-link.js.map +1 -0
  187. package/dist/components/navigation/navigation.d.ts +21 -0
  188. package/dist/components/navigation/navigation.d.ts.map +1 -0
  189. package/dist/components/navigation/navigation.js +41 -0
  190. package/dist/components/navigation/navigation.js.map +1 -0
  191. package/dist/components/navigation-menu/navigation-menu.d.ts +41 -0
  192. package/dist/components/navigation-menu/navigation-menu.d.ts.map +1 -0
  193. package/dist/components/navigation-menu/navigation-menu.js +329 -0
  194. package/dist/components/navigation-menu/navigation-menu.js.map +1 -0
  195. package/dist/components/number-field/number-field.d.ts +17 -0
  196. package/dist/components/number-field/number-field.d.ts.map +1 -0
  197. package/dist/components/number-field/number-field.js +270 -0
  198. package/dist/components/number-field/number-field.js.map +1 -0
  199. package/dist/components/otp-field/otp-field.d.ts +19 -0
  200. package/dist/components/otp-field/otp-field.d.ts.map +1 -0
  201. package/dist/components/otp-field/otp-field.js +66 -0
  202. package/dist/components/otp-field/otp-field.js.map +1 -0
  203. package/dist/components/pagination/pagination.d.ts +29 -0
  204. package/dist/components/pagination/pagination.d.ts.map +1 -0
  205. package/dist/components/pagination/pagination.js +92 -0
  206. package/dist/components/pagination/pagination.js.map +1 -0
  207. package/dist/components/popover/popover.d.ts +22 -0
  208. package/dist/components/popover/popover.d.ts.map +1 -0
  209. package/dist/components/popover/popover.js +108 -0
  210. package/dist/components/popover/popover.js.map +1 -0
  211. package/dist/components/preview-card/preview-card.d.ts +16 -0
  212. package/dist/components/preview-card/preview-card.d.ts.map +1 -0
  213. package/dist/components/preview-card/preview-card.js +92 -0
  214. package/dist/components/preview-card/preview-card.js.map +1 -0
  215. package/dist/components/progress/progress.d.ts +18 -0
  216. package/dist/components/progress/progress.d.ts.map +1 -0
  217. package/dist/components/progress/progress.js +134 -0
  218. package/dist/components/progress/progress.js.map +1 -0
  219. package/dist/components/radio/radio.d.ts +7 -0
  220. package/dist/components/radio/radio.d.ts.map +1 -0
  221. package/dist/components/radio/radio.js +73 -0
  222. package/dist/components/radio/radio.js.map +1 -0
  223. package/dist/components/radio-group/radio-group.d.ts +9 -0
  224. package/dist/components/radio-group/radio-group.d.ts.map +1 -0
  225. package/dist/components/radio-group/radio-group.js +19 -0
  226. package/dist/components/radio-group/radio-group.js.map +1 -0
  227. package/dist/components/scroll-area/scroll-area.d.ts +14 -0
  228. package/dist/components/scroll-area/scroll-area.d.ts.map +1 -0
  229. package/dist/components/scroll-area/scroll-area.js +87 -0
  230. package/dist/components/scroll-area/scroll-area.js.map +1 -0
  231. package/dist/components/select/select.d.ts +36 -0
  232. package/dist/components/select/select.d.ts.map +1 -0
  233. package/dist/components/select/select.js +345 -0
  234. package/dist/components/select/select.js.map +1 -0
  235. package/dist/components/separator/separator.d.ts +10 -0
  236. package/dist/components/separator/separator.d.ts.map +1 -0
  237. package/dist/components/separator/separator.js +81 -0
  238. package/dist/components/separator/separator.js.map +1 -0
  239. package/dist/components/skeleton/skeleton.d.ts +9 -0
  240. package/dist/components/skeleton/skeleton.d.ts.map +1 -0
  241. package/dist/components/skeleton/skeleton.js +27 -0
  242. package/dist/components/skeleton/skeleton.js.map +1 -0
  243. package/dist/components/slider/slider.d.ts +11 -0
  244. package/dist/components/slider/slider.d.ts.map +1 -0
  245. package/dist/components/slider/slider.js +187 -0
  246. package/dist/components/slider/slider.js.map +1 -0
  247. package/dist/components/sparkline/sparkline.d.ts +39 -0
  248. package/dist/components/sparkline/sparkline.d.ts.map +1 -0
  249. package/dist/components/sparkline/sparkline.js +356 -0
  250. package/dist/components/sparkline/sparkline.js.map +1 -0
  251. package/dist/components/spinner/spinner.d.ts +10 -0
  252. package/dist/components/spinner/spinner.d.ts.map +1 -0
  253. package/dist/components/spinner/spinner.js +179 -0
  254. package/dist/components/spinner/spinner.js.map +1 -0
  255. package/dist/components/switch/switch.d.ts +33 -0
  256. package/dist/components/switch/switch.d.ts.map +1 -0
  257. package/dist/components/switch/switch.js +137 -0
  258. package/dist/components/switch/switch.js.map +1 -0
  259. package/dist/components/table/table.d.ts +34 -0
  260. package/dist/components/table/table.d.ts.map +1 -0
  261. package/dist/components/table/table.js +108 -0
  262. package/dist/components/table/table.js.map +1 -0
  263. package/dist/components/tabs/tabs.d.ts +35 -0
  264. package/dist/components/tabs/tabs.d.ts.map +1 -0
  265. package/dist/components/tabs/tabs.js +192 -0
  266. package/dist/components/tabs/tabs.js.map +1 -0
  267. package/dist/components/text-animate/text-animate.d.ts +31 -0
  268. package/dist/components/text-animate/text-animate.d.ts.map +1 -0
  269. package/dist/components/text-animate/text-animate.js +230 -0
  270. package/dist/components/text-animate/text-animate.js.map +1 -0
  271. package/dist/components/textarea/textarea.d.ts +17 -0
  272. package/dist/components/textarea/textarea.d.ts.map +1 -0
  273. package/dist/components/textarea/textarea.js +117 -0
  274. package/dist/components/textarea/textarea.js.map +1 -0
  275. package/dist/components/thumbnail/thumbnail.d.ts +26 -0
  276. package/dist/components/thumbnail/thumbnail.d.ts.map +1 -0
  277. package/dist/components/thumbnail/thumbnail.js +116 -0
  278. package/dist/components/thumbnail/thumbnail.js.map +1 -0
  279. package/dist/components/time-field/time-field.d.ts +25 -0
  280. package/dist/components/time-field/time-field.d.ts.map +1 -0
  281. package/dist/components/time-field/time-field.js +488 -0
  282. package/dist/components/time-field/time-field.js.map +1 -0
  283. package/dist/components/toast/toast.d.ts +59 -0
  284. package/dist/components/toast/toast.d.ts.map +1 -0
  285. package/dist/components/toast/toast.js +239 -0
  286. package/dist/components/toast/toast.js.map +1 -0
  287. package/dist/components/toc/toc.d.ts +21 -0
  288. package/dist/components/toc/toc.d.ts.map +1 -0
  289. package/dist/components/toc/toc.js +185 -0
  290. package/dist/components/toc/toc.js.map +1 -0
  291. package/dist/components/toggle/toggle.d.ts +7 -0
  292. package/dist/components/toggle/toggle.d.ts.map +1 -0
  293. package/dist/components/toggle/toggle.js +9 -0
  294. package/dist/components/toggle/toggle.js.map +1 -0
  295. package/dist/components/toggle-group/toggle-group.d.ts +7 -0
  296. package/dist/components/toggle-group/toggle-group.d.ts.map +1 -0
  297. package/dist/components/toggle-group/toggle-group.js +21 -0
  298. package/dist/components/toggle-group/toggle-group.js.map +1 -0
  299. package/dist/components/toolbar/toolbar.d.ts +23 -0
  300. package/dist/components/toolbar/toolbar.d.ts.map +1 -0
  301. package/dist/components/toolbar/toolbar.js +56 -0
  302. package/dist/components/toolbar/toolbar.js.map +1 -0
  303. package/dist/components/tooltip/tooltip.d.ts +16 -0
  304. package/dist/components/tooltip/tooltip.d.ts.map +1 -0
  305. package/dist/components/tooltip/tooltip.js +64 -0
  306. package/dist/components/tooltip/tooltip.js.map +1 -0
  307. package/dist/floating.d.ts +47 -0
  308. package/dist/floating.d.ts.map +1 -0
  309. package/dist/floating.js +35 -0
  310. package/dist/floating.js.map +1 -0
  311. package/dist/hooks/use-direction.d.ts +2 -0
  312. package/dist/hooks/use-direction.d.ts.map +1 -0
  313. package/dist/hooks/use-direction.js +3 -0
  314. package/dist/hooks/use-direction.js.map +1 -0
  315. package/dist/hooks/use-dismissible.d.ts +16 -0
  316. package/dist/hooks/use-dismissible.d.ts.map +1 -0
  317. package/dist/hooks/use-dismissible.js +17 -0
  318. package/dist/hooks/use-dismissible.js.map +1 -0
  319. package/dist/hooks/use-local-storage.d.ts +24 -0
  320. package/dist/hooks/use-local-storage.d.ts.map +1 -0
  321. package/dist/hooks/use-local-storage.js +127 -0
  322. package/dist/hooks/use-local-storage.js.map +1 -0
  323. package/dist/hooks/use-media-query.d.ts +20 -0
  324. package/dist/hooks/use-media-query.d.ts.map +1 -0
  325. package/dist/hooks/use-media-query.js +19 -0
  326. package/dist/hooks/use-media-query.js.map +1 -0
  327. package/dist/hooks/use-reduced-motion.d.ts +7 -0
  328. package/dist/hooks/use-reduced-motion.d.ts.map +1 -0
  329. package/dist/hooks/use-reduced-motion.js +13 -0
  330. package/dist/hooks/use-reduced-motion.js.map +1 -0
  331. package/dist/hooks/use-theme.d.ts +11 -0
  332. package/dist/hooks/use-theme.d.ts.map +1 -0
  333. package/dist/hooks/use-theme.js +9 -0
  334. package/dist/hooks/use-theme.js.map +1 -0
  335. package/dist/index.d.ts +74 -0
  336. package/dist/index.d.ts.map +1 -0
  337. package/dist/index.js +80 -0
  338. package/dist/index.js.map +1 -0
  339. package/dist/modal.d.ts +42 -0
  340. package/dist/modal.d.ts.map +1 -0
  341. package/dist/modal.js +18 -0
  342. package/dist/modal.js.map +1 -0
  343. package/dist/providers/direction-provider.d.ts +21 -0
  344. package/dist/providers/direction-provider.d.ts.map +1 -0
  345. package/dist/providers/direction-provider.js +9 -0
  346. package/dist/providers/direction-provider.js.map +1 -0
  347. package/dist/providers/reduced-motion-provider.d.ts +30 -0
  348. package/dist/providers/reduced-motion-provider.d.ts.map +1 -0
  349. package/dist/providers/reduced-motion-provider.js +27 -0
  350. package/dist/providers/reduced-motion-provider.js.map +1 -0
  351. package/dist/providers/theme-provider/index.d.ts +5 -0
  352. package/dist/providers/theme-provider/index.d.ts.map +1 -0
  353. package/dist/providers/theme-provider/index.js +3 -0
  354. package/dist/providers/theme-provider/index.js.map +1 -0
  355. package/dist/providers/theme-provider/theme-provider.d.ts +39 -0
  356. package/dist/providers/theme-provider/theme-provider.d.ts.map +1 -0
  357. package/dist/providers/theme-provider/theme-provider.js +118 -0
  358. package/dist/providers/theme-provider/theme-provider.js.map +1 -0
  359. package/dist/providers/theme-provider/theme-script.d.ts +28 -0
  360. package/dist/providers/theme-provider/theme-script.d.ts.map +1 -0
  361. package/dist/providers/theme-provider/theme-script.js +59 -0
  362. package/dist/providers/theme-provider/theme-script.js.map +1 -0
  363. package/dist/utils.d.ts +17 -0
  364. package/dist/utils.d.ts.map +1 -0
  365. package/dist/utils.js +51 -0
  366. package/dist/utils.js.map +1 -0
  367. package/package.json +479 -0
  368. package/src/components/accordion/accordion.test.tsx +220 -0
  369. package/src/components/accordion/accordion.tsx +269 -0
  370. package/src/components/alert/alert.test.tsx +188 -0
  371. package/src/components/alert/alert.tsx +243 -0
  372. package/src/components/alert-dialog/alert-dialog.test.tsx +141 -0
  373. package/src/components/alert-dialog/alert-dialog.tsx +179 -0
  374. package/src/components/autocomplete/autocomplete.test.tsx +384 -0
  375. package/src/components/autocomplete/autocomplete.tsx +442 -0
  376. package/src/components/avatar/avatar.test.tsx +368 -0
  377. package/src/components/avatar/avatar.tsx +142 -0
  378. package/src/components/background-pattern/background-pattern-interactive.tsx +93 -0
  379. package/src/components/background-pattern/background-pattern-shared.tsx +96 -0
  380. package/src/components/background-pattern/background-pattern.test.tsx +97 -0
  381. package/src/components/background-pattern/background-pattern.tsx +67 -0
  382. package/src/components/background-pattern/index.ts +3 -0
  383. package/src/components/badge/badge.test.tsx +58 -0
  384. package/src/components/badge/badge.tsx +149 -0
  385. package/src/components/breadcrumb/breadcrumb.test.tsx +174 -0
  386. package/src/components/breadcrumb/breadcrumb.tsx +146 -0
  387. package/src/components/button/button-variants.ts +69 -0
  388. package/src/components/button/button.test.tsx +79 -0
  389. package/src/components/button/button.tsx +28 -0
  390. package/src/components/button/index.ts +2 -0
  391. package/src/components/button-group/button-group-context.ts +18 -0
  392. package/src/components/button-group/button-group.test.tsx +223 -0
  393. package/src/components/button-group/button-group.tsx +59 -0
  394. package/src/components/calendar/calendar.test.tsx +69 -0
  395. package/src/components/calendar/calendar.tsx +295 -0
  396. package/src/components/carousel/carousel.test.tsx +493 -0
  397. package/src/components/carousel/carousel.tsx +1003 -0
  398. package/src/components/checkbox/checkbox.test.tsx +100 -0
  399. package/src/components/checkbox/checkbox.tsx +154 -0
  400. package/src/components/checkbox-group/checkbox-group.test.tsx +86 -0
  401. package/src/components/checkbox-group/checkbox-group.tsx +21 -0
  402. package/src/components/chip/chip.test.tsx +242 -0
  403. package/src/components/chip/chip.tsx +234 -0
  404. package/src/components/collapsible/collapsible.test.tsx +126 -0
  405. package/src/components/collapsible/collapsible.tsx +47 -0
  406. package/src/components/combobox/combobox.test.tsx +410 -0
  407. package/src/components/combobox/combobox.tsx +598 -0
  408. package/src/components/context-menu/context-menu.test.tsx +226 -0
  409. package/src/components/context-menu/context-menu.tsx +345 -0
  410. package/src/components/copy-button/copy-button.test.tsx +147 -0
  411. package/src/components/copy-button/copy-button.tsx +141 -0
  412. package/src/components/countdown/countdown.test.tsx +130 -0
  413. package/src/components/countdown/countdown.tsx +170 -0
  414. package/src/components/date-field/date-field.test.tsx +373 -0
  415. package/src/components/date-field/date-field.tsx +512 -0
  416. package/src/components/date-picker/date-picker.test.tsx +291 -0
  417. package/src/components/date-picker/date-picker.tsx +572 -0
  418. package/src/components/dialog/dialog.test.tsx +173 -0
  419. package/src/components/dialog/dialog.tsx +190 -0
  420. package/src/components/drawer/drawer.test.tsx +191 -0
  421. package/src/components/drawer/drawer.tsx +365 -0
  422. package/src/components/dropdown-menu/dropdown-menu.test.tsx +227 -0
  423. package/src/components/dropdown-menu/dropdown-menu.tsx +341 -0
  424. package/src/components/field/field.test.tsx +84 -0
  425. package/src/components/field/field.tsx +71 -0
  426. package/src/components/fieldset/fieldset.test.tsx +62 -0
  427. package/src/components/fieldset/fieldset.tsx +24 -0
  428. package/src/components/form/form.test.tsx +61 -0
  429. package/src/components/form/form.tsx +11 -0
  430. package/src/components/gradient-glow/gradient-glow.test.tsx +110 -0
  431. package/src/components/gradient-glow/gradient-glow.tsx +132 -0
  432. package/src/components/input/index.ts +2 -0
  433. package/src/components/input/input-variants.ts +52 -0
  434. package/src/components/input/input.test.tsx +118 -0
  435. package/src/components/input/input.tsx +120 -0
  436. package/src/components/kbd/kbd.test.tsx +119 -0
  437. package/src/components/kbd/kbd.tsx +48 -0
  438. package/src/components/loader/loader.test.tsx +57 -0
  439. package/src/components/loader/loader.tsx +163 -0
  440. package/src/components/menubar/menubar.test.tsx +162 -0
  441. package/src/components/menubar/menubar.tsx +226 -0
  442. package/src/components/meter/meter.test.tsx +172 -0
  443. package/src/components/meter/meter.tsx +144 -0
  444. package/src/components/navigation/index.ts +3 -0
  445. package/src/components/navigation/navigation-context.ts +24 -0
  446. package/src/components/navigation/navigation-link-variants.ts +197 -0
  447. package/src/components/navigation/navigation-link.tsx +90 -0
  448. package/src/components/navigation/navigation.test.tsx +253 -0
  449. package/src/components/navigation/navigation.tsx +74 -0
  450. package/src/components/navigation-menu/navigation-menu.test.tsx +258 -0
  451. package/src/components/navigation-menu/navigation-menu.tsx +410 -0
  452. package/src/components/number-field/number-field.test.tsx +224 -0
  453. package/src/components/number-field/number-field.tsx +310 -0
  454. package/src/components/otp-field/otp-field.test.tsx +113 -0
  455. package/src/components/otp-field/otp-field.tsx +105 -0
  456. package/src/components/pagination/pagination.test.tsx +147 -0
  457. package/src/components/pagination/pagination.tsx +139 -0
  458. package/src/components/popover/popover.test.tsx +135 -0
  459. package/src/components/popover/popover.tsx +134 -0
  460. package/src/components/preview-card/preview-card.test.tsx +99 -0
  461. package/src/components/preview-card/preview-card.tsx +103 -0
  462. package/src/components/progress/progress.test.tsx +109 -0
  463. package/src/components/progress/progress.tsx +151 -0
  464. package/src/components/radio/radio.test.tsx +141 -0
  465. package/src/components/radio/radio.tsx +94 -0
  466. package/src/components/radio-group/radio-group.test.tsx +80 -0
  467. package/src/components/radio-group/radio-group.tsx +22 -0
  468. package/src/components/scroll-area/scroll-area.test.tsx +133 -0
  469. package/src/components/scroll-area/scroll-area.tsx +101 -0
  470. package/src/components/select/select.test.tsx +251 -0
  471. package/src/components/select/select.tsx +446 -0
  472. package/src/components/separator/separator.test.tsx +46 -0
  473. package/src/components/separator/separator.tsx +95 -0
  474. package/src/components/skeleton/skeleton.test.tsx +55 -0
  475. package/src/components/skeleton/skeleton.tsx +33 -0
  476. package/src/components/slider/slider.test.tsx +123 -0
  477. package/src/components/slider/slider.tsx +262 -0
  478. package/src/components/sparkline/sparkline.test.tsx +249 -0
  479. package/src/components/sparkline/sparkline.tsx +446 -0
  480. package/src/components/spinner/spinner.test.tsx +57 -0
  481. package/src/components/spinner/spinner.tsx +219 -0
  482. package/src/components/switch/switch.test.tsx +100 -0
  483. package/src/components/switch/switch.tsx +166 -0
  484. package/src/components/table/table.test.tsx +175 -0
  485. package/src/components/table/table.tsx +157 -0
  486. package/src/components/tabs/tabs.test.tsx +165 -0
  487. package/src/components/tabs/tabs.tsx +246 -0
  488. package/src/components/text-animate/text-animate.test.tsx +125 -0
  489. package/src/components/text-animate/text-animate.tsx +354 -0
  490. package/src/components/textarea/textarea.test.tsx +188 -0
  491. package/src/components/textarea/textarea.tsx +144 -0
  492. package/src/components/thumbnail/thumbnail.test.tsx +217 -0
  493. package/src/components/thumbnail/thumbnail.tsx +139 -0
  494. package/src/components/time-field/time-field.test.tsx +376 -0
  495. package/src/components/time-field/time-field.tsx +625 -0
  496. package/src/components/toast/toast.test.tsx +277 -0
  497. package/src/components/toast/toast.tsx +377 -0
  498. package/src/components/toc/toc.test.tsx +197 -0
  499. package/src/components/toc/toc.tsx +233 -0
  500. package/src/components/toggle/toggle.test.tsx +109 -0
  501. package/src/components/toggle/toggle.tsx +10 -0
  502. package/src/components/toggle-group/toggle-group.test.tsx +95 -0
  503. package/src/components/toggle-group/toggle-group.tsx +21 -0
  504. package/src/components/toolbar/toolbar.test.tsx +78 -0
  505. package/src/components/toolbar/toolbar.tsx +77 -0
  506. package/src/components/tooltip/tooltip.test.tsx +100 -0
  507. package/src/components/tooltip/tooltip.tsx +78 -0
  508. package/src/floating.test.ts +40 -0
  509. package/src/floating.ts +103 -0
  510. package/src/globals.d.ts +34 -0
  511. package/src/hooks/use-direction.ts +3 -0
  512. package/src/hooks/use-dismissible.ts +33 -0
  513. package/src/hooks/use-local-storage.test.tsx +63 -0
  514. package/src/hooks/use-local-storage.ts +190 -0
  515. package/src/hooks/use-media-query.test.tsx +65 -0
  516. package/src/hooks/use-media-query.ts +38 -0
  517. package/src/hooks/use-reduced-motion.ts +17 -0
  518. package/src/hooks/use-theme.ts +16 -0
  519. package/src/index.ts +76 -0
  520. package/src/modal.test.ts +34 -0
  521. package/src/modal.ts +80 -0
  522. package/src/providers/direction-provider.test.tsx +20 -0
  523. package/src/providers/direction-provider.tsx +26 -0
  524. package/src/providers/reduced-motion-provider.test.tsx +42 -0
  525. package/src/providers/reduced-motion-provider.tsx +58 -0
  526. package/src/providers/theme-provider/index.ts +4 -0
  527. package/src/providers/theme-provider/theme-provider.test.tsx +97 -0
  528. package/src/providers/theme-provider/theme-provider.tsx +169 -0
  529. package/src/providers/theme-provider/theme-script.tsx +108 -0
  530. package/src/test/setup.ts +27 -0
  531. package/src/test/vitest-axe.d.ts +7 -0
  532. package/src/utils.test.tsx +63 -0
  533. package/src/utils.ts +57 -0
  534. package/styles.css +523 -0
@@ -0,0 +1,97 @@
1
+ import { render, renderHook, screen } from '@testing-library/react'
2
+ import userEvent from '@testing-library/user-event'
3
+ import { type ReactNode } from 'react'
4
+ import { afterEach, describe, expect, it } from 'vitest'
5
+ import { ThemeProvider } from './theme-provider'
6
+ import { getThemeScript } from './theme-script'
7
+ import { useTheme } from '../../hooks/use-theme'
8
+
9
+ afterEach(() => {
10
+ document.documentElement.className = ''
11
+ document.documentElement.style.colorScheme = ''
12
+ localStorage.clear()
13
+ })
14
+
15
+ describe('getThemeScript', () => {
16
+ it('embeds the storage key and reads localStorage + system preference', () => {
17
+ const s = getThemeScript({ storageKey: 'appica-theme' })
18
+ expect(s).toContain('appica-theme')
19
+ expect(s).toContain('localStorage')
20
+ expect(s).toContain('prefers-color-scheme')
21
+ expect(s.startsWith('(')).toBe(true)
22
+ })
23
+
24
+ it('inlines a forced theme', () => {
25
+ expect(getThemeScript({ forcedTheme: 'dark' })).toContain('"dark"')
26
+ })
27
+ })
28
+
29
+ describe('ThemeProvider / useTheme', () => {
30
+ it('returns inert values without a provider', () => {
31
+ const { result } = renderHook(() => useTheme())
32
+ expect(result.current.theme).toBeUndefined()
33
+ expect(result.current.mounted).toBe(false)
34
+ })
35
+
36
+ it('exposes the default theme and reports mounted after hydration', () => {
37
+ const wrapper = ({ children }: { children: ReactNode }) => (
38
+ <ThemeProvider defaultTheme="light" enableSystem={false}>
39
+ {children}
40
+ </ThemeProvider>
41
+ )
42
+ const { result } = renderHook(() => useTheme(), { wrapper })
43
+ expect(result.current.theme).toBe('light')
44
+ expect(result.current.mounted).toBe(true)
45
+ })
46
+
47
+ it('resolves "system" to light/dark via the media query', () => {
48
+ // The test stub reports `prefers-color-scheme: dark` -> false, i.e. light.
49
+ const wrapper = ({ children }: { children: ReactNode }) => (
50
+ <ThemeProvider defaultTheme="system">{children}</ThemeProvider>
51
+ )
52
+ const { result } = renderHook(() => useTheme(), { wrapper })
53
+ expect(result.current.theme).toBe('system')
54
+ expect(result.current.resolvedTheme).toBe('light')
55
+ expect(result.current.systemTheme).toBe('light')
56
+ })
57
+
58
+ it('applies the theme class to <html> and persists as a raw string on change', async () => {
59
+ function Probe() {
60
+ const { theme, setTheme } = useTheme()
61
+ return <button onClick={() => setTheme('dark')}>{theme}</button>
62
+ }
63
+ const user = userEvent.setup()
64
+ render(
65
+ <ThemeProvider defaultTheme="light" enableSystem={false}>
66
+ <Probe />
67
+ </ThemeProvider>,
68
+ )
69
+ expect(document.documentElement.classList.contains('dark')).toBe(false)
70
+
71
+ await user.click(screen.getByRole('button'))
72
+
73
+ expect(document.documentElement.classList.contains('dark')).toBe(true)
74
+ expect(document.documentElement.classList.contains('light')).toBe(false)
75
+ expect(localStorage.getItem('theme')).toBe('dark')
76
+ })
77
+
78
+ it('forcedTheme overrides storage and system', () => {
79
+ localStorage.setItem('theme', 'light')
80
+ const wrapper = ({ children }: { children: ReactNode }) => (
81
+ <ThemeProvider forcedTheme="dark">{children}</ThemeProvider>
82
+ )
83
+ const { result } = renderHook(() => useTheme(), { wrapper })
84
+ expect(result.current.resolvedTheme).toBe('dark')
85
+ expect(result.current.forcedTheme).toBe('dark')
86
+ })
87
+
88
+ it('nested ThemeProvider is a passthrough (outer wins)', () => {
89
+ const wrapper = ({ children }: { children: ReactNode }) => (
90
+ <ThemeProvider forcedTheme="dark">
91
+ <ThemeProvider forcedTheme="light">{children}</ThemeProvider>
92
+ </ThemeProvider>
93
+ )
94
+ const { result } = renderHook(() => useTheme(), { wrapper })
95
+ expect(result.current.resolvedTheme).toBe('dark')
96
+ })
97
+ })
@@ -0,0 +1,169 @@
1
+ 'use client'
2
+
3
+ import * as React from 'react'
4
+ import { useLocalStorage } from '../../hooks/use-local-storage'
5
+ import { useMediaQuery } from '../../hooks/use-media-query'
6
+ import { ThemeScript } from './theme-script'
7
+
8
+ const MEDIA = '(prefers-color-scheme: dark)'
9
+ const SYSTEM_THEMES = ['light', 'dark']
10
+ const DEFAULT_THEMES = ['light', 'dark']
11
+ // Theme is stored as a raw string so the inline no-flash script can read it
12
+ // directly with `localStorage.getItem` (no JSON quotes).
13
+ const RAW_STRING = { serializer: (v: string) => v, deserializer: (v: string) => v }
14
+
15
+ export interface ThemeContextValue {
16
+ /** The chosen theme, possibly `'system'`. */
17
+ theme: string | undefined
18
+ setTheme: (value: string | ((prev: string) => string)) => void
19
+ /** The theme actually applied — `'system'` resolved to `'light'`/`'dark'`. */
20
+ resolvedTheme: string | undefined
21
+ systemTheme: 'light' | 'dark' | undefined
22
+ themes: string[]
23
+ forcedTheme: string | undefined
24
+ /** `false` until the client has mounted — guard theme-dependent UI with this. */
25
+ mounted: boolean
26
+ }
27
+
28
+ const ThemeContext = React.createContext<ThemeContextValue | undefined>(undefined)
29
+
30
+ const defaultContext: ThemeContextValue = {
31
+ theme: undefined,
32
+ setTheme: () => {},
33
+ resolvedTheme: undefined,
34
+ systemTheme: undefined,
35
+ themes: [],
36
+ forcedTheme: undefined,
37
+ mounted: false,
38
+ }
39
+
40
+ export function useThemeContext(): ThemeContextValue {
41
+ return React.useContext(ThemeContext) ?? defaultContext
42
+ }
43
+
44
+ export interface ThemeProviderProps {
45
+ children?: React.ReactNode
46
+ /** Available theme names. Default `['light', 'dark']`. */
47
+ themes?: string[]
48
+ /** Force a theme for the whole tree (e.g. a docs page); overrides storage + system. */
49
+ forcedTheme?: string
50
+ /** Respect the OS `prefers-color-scheme`. Default `true`. */
51
+ enableSystem?: boolean
52
+ /** Suppress CSS transitions during a theme change so colors don't animate. Default `false`. */
53
+ disableTransitionOnChange?: boolean
54
+ /** Set `color-scheme` on `<html>` so native UI (scrollbars, form controls) matches. Default `true`. */
55
+ enableColorScheme?: boolean
56
+ /** Storage key for the persisted choice. Default `'theme'`. */
57
+ storageKey?: string
58
+ /** Theme used before a choice is stored. Default `enableSystem ? 'system' : 'light'`. */
59
+ defaultTheme?: string
60
+ /** Map a theme name to a custom class applied on `<html>`. */
61
+ value?: Record<string, string>
62
+ /** CSP nonce forwarded to the inline no-flash script. */
63
+ nonce?: string
64
+ /** Extra props for the inline `<script>` element. */
65
+ scriptProps?: React.ScriptHTMLAttributes<HTMLScriptElement>
66
+ }
67
+
68
+ function disableAnimation(nonce?: string) {
69
+ const css = document.createElement('style')
70
+ if (nonce) css.setAttribute('nonce', nonce)
71
+ css.appendChild(
72
+ document.createTextNode(
73
+ '*,*::before,*::after{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;-ms-transition:none!important;transition:none!important}',
74
+ ),
75
+ )
76
+ document.head.appendChild(css)
77
+ return () => {
78
+ // Force a reflow so the "no transitions" rule applies before the class swap paints.
79
+ ;(() => window.getComputedStyle(document.body))()
80
+ setTimeout(() => {
81
+ document.head.removeChild(css)
82
+ }, 1)
83
+ }
84
+ }
85
+
86
+ export function ThemeProvider(props: ThemeProviderProps) {
87
+ // Nested providers are a no-op passthrough; only the outermost owns state.
88
+ const existing = React.useContext(ThemeContext)
89
+ if (existing) return <>{props.children}</>
90
+ return <Theme {...props} />
91
+ }
92
+
93
+ function Theme({
94
+ children,
95
+ themes = DEFAULT_THEMES,
96
+ forcedTheme,
97
+ enableSystem = true,
98
+ disableTransitionOnChange = false,
99
+ enableColorScheme = true,
100
+ storageKey = 'theme',
101
+ defaultTheme = enableSystem ? 'system' : 'light',
102
+ value,
103
+ nonce,
104
+ scriptProps,
105
+ }: ThemeProviderProps) {
106
+ const [theme, setTheme] = useLocalStorage<string>(storageKey, defaultTheme, RAW_STRING)
107
+ const systemDark = useMediaQuery(MEDIA)
108
+ const systemTheme = enableSystem ? (systemDark ? 'dark' : 'light') : undefined
109
+
110
+ const [mounted, setMounted] = React.useState(false)
111
+ React.useEffect(() => setMounted(true), [])
112
+
113
+ const resolvedTheme = forcedTheme ?? (theme === 'system' ? (systemDark ? 'dark' : 'light') : theme)
114
+
115
+ // Keep mutable config out of the apply effect's deps so it fires only on theme change.
116
+ const cfg = React.useRef({ themes, value, enableColorScheme, disableTransitionOnChange, nonce })
117
+ cfg.current = { themes, value, enableColorScheme, disableTransitionOnChange, nonce }
118
+
119
+ const firstRun = React.useRef(true)
120
+ React.useEffect(() => {
121
+ // The inline script already set the correct class for the first paint; skip
122
+ // re-applying on mount or we'd risk a flash from the hydration default.
123
+ if (firstRun.current) {
124
+ firstRun.current = false
125
+ return
126
+ }
127
+ if (!resolvedTheme) return
128
+ const c = cfg.current
129
+ const classFor = (t: string) => (c.value && c.value[t] ? c.value[t] : t)
130
+ const enable = c.disableTransitionOnChange ? disableAnimation(c.nonce) : null
131
+ const el = document.documentElement
132
+ el.classList.remove(...c.themes.map(classFor))
133
+ el.classList.add(classFor(resolvedTheme))
134
+ if (c.enableColorScheme && SYSTEM_THEMES.includes(resolvedTheme)) {
135
+ el.style.colorScheme = resolvedTheme
136
+ }
137
+ enable?.()
138
+ }, [resolvedTheme])
139
+
140
+ const ctx = React.useMemo<ThemeContextValue>(
141
+ () => ({
142
+ theme,
143
+ setTheme,
144
+ resolvedTheme,
145
+ systemTheme,
146
+ themes: enableSystem ? [...themes, 'system'] : themes,
147
+ forcedTheme,
148
+ mounted,
149
+ }),
150
+ [theme, setTheme, resolvedTheme, systemTheme, enableSystem, themes, forcedTheme, mounted],
151
+ )
152
+
153
+ return (
154
+ <ThemeContext value={ctx}>
155
+ <ThemeScript
156
+ storageKey={storageKey}
157
+ defaultTheme={defaultTheme}
158
+ forcedTheme={forcedTheme}
159
+ themes={themes}
160
+ value={value}
161
+ enableSystem={enableSystem}
162
+ enableColorScheme={enableColorScheme}
163
+ nonce={nonce}
164
+ scriptProps={scriptProps}
165
+ />
166
+ {children}
167
+ </ThemeContext>
168
+ )
169
+ }
@@ -0,0 +1,108 @@
1
+ // Server-safe: a pure inline-script generator plus a <script> component.
2
+ // No 'use client' — `getThemeScript` can be called in any environment (Vite
3
+ // main entry, Astro `is:inline`, etc.) and `ThemeScript` can render in a
4
+ // Server Component <head>.
5
+
6
+ import * as React from 'react'
7
+
8
+ export interface ThemeScriptOptions {
9
+ storageKey?: string
10
+ defaultTheme?: string
11
+ forcedTheme?: string
12
+ themes?: string[]
13
+ value?: Record<string, string>
14
+ enableSystem?: boolean
15
+ enableColorScheme?: boolean
16
+ }
17
+
18
+ // Serialized via `.toString()` and injected as an inline <script> that runs
19
+ // before hydration to set the theme class on <html> with no flash. It must be
20
+ // fully self-contained (no external references) so the stringified output is
21
+ // valid, runnable code.
22
+ function themeScript(
23
+ storageKey: string,
24
+ defaultTheme: string,
25
+ forcedTheme: string | null,
26
+ themes: string[],
27
+ value: Record<string, string> | null,
28
+ enableSystem: boolean,
29
+ enableColorScheme: boolean,
30
+ ) {
31
+ const el = document.documentElement
32
+ const system = ['light', 'dark']
33
+ const classFor = (t: string) => (value && value[t] ? value[t] : t)
34
+ const updateDOM = (theme: string) => {
35
+ el.classList.remove(...themes.map(classFor))
36
+ el.classList.add(classFor(theme))
37
+ if (enableColorScheme && system.indexOf(theme) !== -1) {
38
+ el.style.colorScheme = theme
39
+ }
40
+ }
41
+ if (forcedTheme) {
42
+ updateDOM(forcedTheme)
43
+ } else {
44
+ try {
45
+ const stored = localStorage.getItem(storageKey) || defaultTheme
46
+ const resolved =
47
+ enableSystem && stored === 'system'
48
+ ? window.matchMedia('(prefers-color-scheme: dark)').matches
49
+ ? 'dark'
50
+ : 'light'
51
+ : stored
52
+ updateDOM(resolved)
53
+ } catch (e) {
54
+ // storage unavailable — leave the default
55
+ }
56
+ }
57
+ }
58
+
59
+ /**
60
+ * Returns the inline no-flash script as a string, ready to drop into a
61
+ * `<script>` before hydration. Use this directly when your framework doesn't
62
+ * render React on the server (e.g. a Vite SPA `index.html`, or Astro
63
+ * `<script is:inline>`); otherwise prefer the `<ThemeScript />` component.
64
+ */
65
+ export function getThemeScript(options: ThemeScriptOptions = {}): string {
66
+ const {
67
+ storageKey = 'theme',
68
+ enableSystem = true,
69
+ defaultTheme = enableSystem ? 'system' : 'light',
70
+ forcedTheme,
71
+ themes = ['light', 'dark'],
72
+ value,
73
+ enableColorScheme = true,
74
+ } = options
75
+ // JSON.stringify turns `undefined` into `null` inside arrays, so slicing the
76
+ // brackets yields a valid argument list (unlike a manual comma-join).
77
+ const args = JSON.stringify([
78
+ storageKey,
79
+ defaultTheme,
80
+ forcedTheme ?? null,
81
+ themes,
82
+ value ?? null,
83
+ enableSystem,
84
+ enableColorScheme,
85
+ ]).slice(1, -1)
86
+ return `(${themeScript.toString()})(${args})`
87
+ }
88
+
89
+ export interface ThemeScriptProps extends ThemeScriptOptions {
90
+ nonce?: string
91
+ scriptProps?: React.ScriptHTMLAttributes<HTMLScriptElement>
92
+ }
93
+
94
+ /**
95
+ * Renders the inline no-flash script. The `<ThemeProvider>` mounts this for you;
96
+ * render it manually (e.g. in a Next.js `<head>`) only if you need to control its
97
+ * placement.
98
+ */
99
+ export function ThemeScript({ nonce, scriptProps, ...options }: ThemeScriptProps) {
100
+ return (
101
+ <script
102
+ {...scriptProps}
103
+ suppressHydrationWarning
104
+ nonce={typeof window === 'undefined' ? nonce : ''}
105
+ dangerouslySetInnerHTML={{ __html: getThemeScript(options) }}
106
+ />
107
+ )
108
+ }
@@ -0,0 +1,27 @@
1
+ import '@testing-library/jest-dom/vitest'
2
+ import { afterEach, expect } from 'vitest'
3
+ import { cleanup } from '@testing-library/react'
4
+ import * as matchers from 'vitest-axe/matchers'
5
+
6
+ expect.extend(matchers)
7
+
8
+ // jsdom doesn't implement window.matchMedia — stub it so hooks that read
9
+ // media preferences (e.g. useReducedMotion) work in tests. Default to
10
+ // "no match" so animations stay enabled; individual tests can override.
11
+ if (typeof window !== 'undefined' && !window.matchMedia) {
12
+ window.matchMedia = (query: string) =>
13
+ ({
14
+ matches: false,
15
+ media: query,
16
+ onchange: null,
17
+ addEventListener: () => {},
18
+ removeEventListener: () => {},
19
+ addListener: () => {},
20
+ removeListener: () => {},
21
+ dispatchEvent: () => false,
22
+ }) as unknown as MediaQueryList
23
+ }
24
+
25
+ afterEach(() => {
26
+ cleanup()
27
+ })
@@ -0,0 +1,7 @@
1
+ import 'vitest'
2
+ import type { AxeMatchers } from 'vitest-axe/matchers'
3
+
4
+ declare module 'vitest' {
5
+ interface Assertion<T = any> extends AxeMatchers {}
6
+ interface AsymmetricMatchersContaining extends AxeMatchers {}
7
+ }
@@ -0,0 +1,63 @@
1
+ import * as React from 'react'
2
+ import { render } from '@testing-library/react'
3
+ import { describe, it, expect, vi } from 'vitest'
4
+ import { composeRefs, useComposedRefs } from './utils'
5
+
6
+ describe('composeRefs', () => {
7
+ it('assigns a node to object refs and calls function refs', () => {
8
+ const objectRef = React.createRef<HTMLDivElement>()
9
+ const fnRef = vi.fn()
10
+ const node = document.createElement('div')
11
+
12
+ composeRefs(objectRef, fnRef)(node)
13
+
14
+ expect(objectRef.current).toBe(node)
15
+ expect(fnRef).toHaveBeenCalledWith(node)
16
+ })
17
+
18
+ it('propagates a cleanup returned by an inner callback ref', () => {
19
+ const cleanup = vi.fn()
20
+ const fnRef = vi.fn(() => cleanup)
21
+ const node = document.createElement('div')
22
+
23
+ const composed = composeRefs<HTMLDivElement>(fnRef)
24
+ const composedCleanup = composed(node)
25
+
26
+ expect(typeof composedCleanup).toBe('function')
27
+ composedCleanup?.()
28
+ expect(cleanup).toHaveBeenCalledTimes(1)
29
+ })
30
+
31
+ it('calls legacy refs with null when a sibling ref uses cleanup style', () => {
32
+ const legacy = vi.fn()
33
+ const cleanup = vi.fn()
34
+ const cleanupRef = vi.fn(() => cleanup)
35
+ const node = document.createElement('div')
36
+
37
+ const composedCleanup = composeRefs<HTMLDivElement>(legacy, cleanupRef)(node)
38
+ composedCleanup?.()
39
+
40
+ expect(legacy).toHaveBeenCalledWith(node)
41
+ expect(legacy).toHaveBeenLastCalledWith(null)
42
+ expect(cleanup).toHaveBeenCalledTimes(1)
43
+ })
44
+ })
45
+
46
+ describe('useComposedRefs', () => {
47
+ it('does not re-invoke a consumer ref on an unrelated re-render', () => {
48
+ const consumerRef = vi.fn()
49
+
50
+ function Probe({ tick }: { tick: number }) {
51
+ const innerRef = React.useRef<HTMLDivElement>(null)
52
+ const composed = useComposedRefs(consumerRef, innerRef)
53
+ return <div ref={composed} data-tick={tick} />
54
+ }
55
+
56
+ const { rerender } = render(<Probe tick={0} />)
57
+ const callsAfterMount = consumerRef.mock.calls.length
58
+ expect(callsAfterMount).toBeGreaterThan(0)
59
+
60
+ rerender(<Probe tick={1} />)
61
+ expect(consumerRef.mock.calls.length).toBe(callsAfterMount)
62
+ })
63
+ })
package/src/utils.ts ADDED
@@ -0,0 +1,57 @@
1
+ import { clsx, type ClassValue } from 'clsx'
2
+ import { twMerge } from 'tailwind-merge'
3
+ import * as React from 'react'
4
+
5
+ export function cn(...inputs: ClassValue[]) {
6
+ return twMerge(clsx(inputs))
7
+ }
8
+
9
+ type PossibleRef<T> = React.Ref<T> | undefined
10
+
11
+ function setRef<T>(ref: PossibleRef<T>, value: T): (() => void) | void {
12
+ if (typeof ref === 'function') {
13
+ return ref(value) as (() => void) | void
14
+ } else if (ref != null) {
15
+ ;(ref as React.RefObject<T>).current = value
16
+ }
17
+ }
18
+
19
+ export function composeRefs<T>(...refs: PossibleRef<T>[]) {
20
+ return (node: T): void | (() => void) => {
21
+ let hasCleanup = false
22
+ const cleanups = refs.map((ref) => {
23
+ const cleanup = setRef(ref, node)
24
+ if (!hasCleanup && typeof cleanup === 'function') {
25
+ hasCleanup = true
26
+ }
27
+ return cleanup
28
+ })
29
+
30
+ if (hasCleanup) {
31
+ return () => {
32
+ for (let i = 0; i < cleanups.length; i++) {
33
+ const cleanup = cleanups[i]
34
+ if (typeof cleanup === 'function') {
35
+ cleanup()
36
+ } else {
37
+ setRef(refs[i], null as T)
38
+ }
39
+ }
40
+ }
41
+ }
42
+
43
+ return undefined
44
+ }
45
+ }
46
+
47
+ export function useComposedRefs<T>(...refs: PossibleRef<T>[]) {
48
+ // eslint-disable-next-line react-hooks/exhaustive-deps
49
+ return React.useCallback(composeRefs(...refs), refs)
50
+ }
51
+
52
+ export function focusableProps(disabled = false) {
53
+ if (disabled) {
54
+ return { tabIndex: -1, 'aria-disabled': true, 'data-disabled': '' } as const
55
+ }
56
+ return { tabIndex: 0 } as const
57
+ }