@appica/ui-react 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (511) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/README.md +47 -5
  3. package/agent-rules.md +41 -0
  4. package/appica.css +7 -0
  5. package/dist/components/accordion/accordion.d.ts +24 -0
  6. package/dist/components/accordion/accordion.d.ts.map +1 -1
  7. package/dist/components/accordion/accordion.js +2 -1
  8. package/dist/components/accordion/accordion.js.map +1 -1
  9. package/dist/components/alert/alert.d.ts +30 -2
  10. package/dist/components/alert/alert.d.ts.map +1 -1
  11. package/dist/components/alert/alert.js +2 -1
  12. package/dist/components/alert/alert.js.map +1 -1
  13. package/dist/components/alert-dialog/alert-dialog.d.ts +12 -2
  14. package/dist/components/alert-dialog/alert-dialog.d.ts.map +1 -1
  15. package/dist/components/alert-dialog/alert-dialog.js +10 -5
  16. package/dist/components/alert-dialog/alert-dialog.js.map +1 -1
  17. package/dist/components/autocomplete/autocomplete.d.ts +21 -1
  18. package/dist/components/autocomplete/autocomplete.d.ts.map +1 -1
  19. package/dist/components/autocomplete/autocomplete.js +3 -2
  20. package/dist/components/autocomplete/autocomplete.js.map +1 -1
  21. package/dist/components/avatar/avatar.d.ts +17 -1
  22. package/dist/components/avatar/avatar.d.ts.map +1 -1
  23. package/dist/components/avatar/avatar.js +2 -1
  24. package/dist/components/avatar/avatar.js.map +1 -1
  25. package/dist/components/background-pattern/background-pattern-interactive.d.ts +2 -1
  26. package/dist/components/background-pattern/background-pattern-interactive.d.ts.map +1 -1
  27. package/dist/components/background-pattern/background-pattern-interactive.js +4 -2
  28. package/dist/components/background-pattern/background-pattern-interactive.js.map +1 -1
  29. package/dist/components/background-pattern/background-pattern-shared.d.ts +3 -2
  30. package/dist/components/background-pattern/background-pattern-shared.d.ts.map +1 -1
  31. package/dist/components/background-pattern/background-pattern-shared.js +48 -16
  32. package/dist/components/background-pattern/background-pattern-shared.js.map +1 -1
  33. package/dist/components/background-pattern/background-pattern.d.ts +13 -5
  34. package/dist/components/background-pattern/background-pattern.d.ts.map +1 -1
  35. package/dist/components/background-pattern/background-pattern.js +13 -4
  36. package/dist/components/background-pattern/background-pattern.js.map +1 -1
  37. package/dist/components/background-pattern/index.js +1 -0
  38. package/dist/components/background-pattern/index.js.map +1 -1
  39. package/dist/components/badge/badge.d.ts +13 -3
  40. package/dist/components/badge/badge.d.ts.map +1 -1
  41. package/dist/components/badge/badge.js +2 -1
  42. package/dist/components/badge/badge.js.map +1 -1
  43. package/dist/components/border-beam/border-beam.d.ts +52 -0
  44. package/dist/components/border-beam/border-beam.d.ts.map +1 -0
  45. package/dist/components/border-beam/border-beam.js +68 -0
  46. package/dist/components/border-beam/border-beam.js.map +1 -0
  47. package/dist/components/breadcrumb/breadcrumb.d.ts +8 -0
  48. package/dist/components/breadcrumb/breadcrumb.d.ts.map +1 -1
  49. package/dist/components/breadcrumb/breadcrumb.js +2 -1
  50. package/dist/components/breadcrumb/breadcrumb.js.map +1 -1
  51. package/dist/components/button/button-variants.d.ts +2 -2
  52. package/dist/components/button/button-variants.js +2 -1
  53. package/dist/components/button/button-variants.js.map +1 -1
  54. package/dist/components/button/button.d.ts +11 -1
  55. package/dist/components/button/button.d.ts.map +1 -1
  56. package/dist/components/button/button.js +2 -1
  57. package/dist/components/button/button.js.map +1 -1
  58. package/dist/components/button/index.js +1 -0
  59. package/dist/components/button/index.js.map +1 -1
  60. package/dist/components/button-group/button-group-context.js +1 -0
  61. package/dist/components/button-group/button-group-context.js.map +1 -1
  62. package/dist/components/button-group/button-group.d.ts +10 -0
  63. package/dist/components/button-group/button-group.d.ts.map +1 -1
  64. package/dist/components/button-group/button-group.js +2 -1
  65. package/dist/components/button-group/button-group.js.map +1 -1
  66. package/dist/components/calendar/calendar.d.ts +5 -0
  67. package/dist/components/calendar/calendar.d.ts.map +1 -1
  68. package/dist/components/calendar/calendar.js +2 -1
  69. package/dist/components/calendar/calendar.js.map +1 -1
  70. package/dist/components/card/card.d.ts +43 -0
  71. package/dist/components/card/card.d.ts.map +1 -0
  72. package/dist/components/card/card.js +104 -0
  73. package/dist/components/card/card.js.map +1 -0
  74. package/dist/components/carousel/carousel.d.ts +106 -6
  75. package/dist/components/carousel/carousel.d.ts.map +1 -1
  76. package/dist/components/carousel/carousel.js +180 -5
  77. package/dist/components/carousel/carousel.js.map +1 -1
  78. package/dist/components/checkbox/checkbox.js +2 -1
  79. package/dist/components/checkbox/checkbox.js.map +1 -1
  80. package/dist/components/checkbox-group/checkbox-group.d.ts +4 -0
  81. package/dist/components/checkbox-group/checkbox-group.d.ts.map +1 -1
  82. package/dist/components/checkbox-group/checkbox-group.js +2 -1
  83. package/dist/components/checkbox-group/checkbox-group.js.map +1 -1
  84. package/dist/components/chip/chip.d.ts +33 -1
  85. package/dist/components/chip/chip.d.ts.map +1 -1
  86. package/dist/components/chip/chip.js +2 -1
  87. package/dist/components/chip/chip.js.map +1 -1
  88. package/dist/components/collapsible/collapsible.js +2 -1
  89. package/dist/components/collapsible/collapsible.js.map +1 -1
  90. package/dist/components/color-area/color-area.d.ts +53 -0
  91. package/dist/components/color-area/color-area.d.ts.map +1 -0
  92. package/dist/components/color-area/color-area.js +246 -0
  93. package/dist/components/color-area/color-area.js.map +1 -0
  94. package/dist/components/color-picker/color-picker.d.ts +152 -0
  95. package/dist/components/color-picker/color-picker.d.ts.map +1 -0
  96. package/dist/components/color-picker/color-picker.js +328 -0
  97. package/dist/components/color-picker/color-picker.js.map +1 -0
  98. package/dist/components/color-slider/color-slider.d.ts +48 -0
  99. package/dist/components/color-slider/color-slider.d.ts.map +1 -0
  100. package/dist/components/color-slider/color-slider.js +217 -0
  101. package/dist/components/color-slider/color-slider.js.map +1 -0
  102. package/dist/components/color-swatch/color-swatch.d.ts +47 -0
  103. package/dist/components/color-swatch/color-swatch.d.ts.map +1 -0
  104. package/dist/components/color-swatch/color-swatch.js +67 -0
  105. package/dist/components/color-swatch/color-swatch.js.map +1 -0
  106. package/dist/components/color-swatch-picker/color-swatch-picker.d.ts +62 -0
  107. package/dist/components/color-swatch-picker/color-swatch-picker.d.ts.map +1 -0
  108. package/dist/components/color-swatch-picker/color-swatch-picker.js +203 -0
  109. package/dist/components/color-swatch-picker/color-swatch-picker.js.map +1 -0
  110. package/dist/components/combobox/combobox.d.ts +25 -1
  111. package/dist/components/combobox/combobox.d.ts.map +1 -1
  112. package/dist/components/combobox/combobox.js +3 -2
  113. package/dist/components/combobox/combobox.js.map +1 -1
  114. package/dist/components/context-menu/context-menu.d.ts +7 -1
  115. package/dist/components/context-menu/context-menu.d.ts.map +1 -1
  116. package/dist/components/context-menu/context-menu.js +11 -5
  117. package/dist/components/context-menu/context-menu.js.map +1 -1
  118. package/dist/components/copy-button/copy-button.d.ts +18 -1
  119. package/dist/components/copy-button/copy-button.d.ts.map +1 -1
  120. package/dist/components/copy-button/copy-button.js +6 -5
  121. package/dist/components/copy-button/copy-button.js.map +1 -1
  122. package/dist/components/countdown/countdown.d.ts +14 -0
  123. package/dist/components/countdown/countdown.d.ts.map +1 -1
  124. package/dist/components/countdown/countdown.js +2 -1
  125. package/dist/components/countdown/countdown.js.map +1 -1
  126. package/dist/components/date-field/date-field.d.ts +35 -0
  127. package/dist/components/date-field/date-field.d.ts.map +1 -1
  128. package/dist/components/date-field/date-field.js +2 -1
  129. package/dist/components/date-field/date-field.js.map +1 -1
  130. package/dist/components/date-picker/date-picker.d.ts +94 -0
  131. package/dist/components/date-picker/date-picker.d.ts.map +1 -1
  132. package/dist/components/date-picker/date-picker.js +2 -1
  133. package/dist/components/date-picker/date-picker.js.map +1 -1
  134. package/dist/components/dialog/dialog.d.ts +20 -2
  135. package/dist/components/dialog/dialog.d.ts.map +1 -1
  136. package/dist/components/dialog/dialog.js +9 -4
  137. package/dist/components/dialog/dialog.js.map +1 -1
  138. package/dist/components/drawer/drawer.d.ts +22 -2
  139. package/dist/components/drawer/drawer.d.ts.map +1 -1
  140. package/dist/components/drawer/drawer.js +14 -7
  141. package/dist/components/drawer/drawer.js.map +1 -1
  142. package/dist/components/dropdown-menu/dropdown-menu.d.ts +7 -1
  143. package/dist/components/dropdown-menu/dropdown-menu.d.ts.map +1 -1
  144. package/dist/components/dropdown-menu/dropdown-menu.js +11 -5
  145. package/dist/components/dropdown-menu/dropdown-menu.js.map +1 -1
  146. package/dist/components/field/field.js +2 -1
  147. package/dist/components/field/field.js.map +1 -1
  148. package/dist/components/fieldset/fieldset.js +2 -1
  149. package/dist/components/fieldset/fieldset.js.map +1 -1
  150. package/dist/components/form/form.js +1 -0
  151. package/dist/components/form/form.js.map +1 -1
  152. package/dist/components/gradient-glow/gradient-glow.d.ts +51 -1
  153. package/dist/components/gradient-glow/gradient-glow.d.ts.map +1 -1
  154. package/dist/components/gradient-glow/gradient-glow.js +5 -3
  155. package/dist/components/gradient-glow/gradient-glow.js.map +1 -1
  156. package/dist/components/input/index.js +1 -0
  157. package/dist/components/input/index.js.map +1 -1
  158. package/dist/components/input/input-variants.d.ts +1 -1
  159. package/dist/components/input/input-variants.js +2 -1
  160. package/dist/components/input/input-variants.js.map +1 -1
  161. package/dist/components/input/input.d.ts +21 -1
  162. package/dist/components/input/input.d.ts.map +1 -1
  163. package/dist/components/input/input.js +4 -3
  164. package/dist/components/input/input.js.map +1 -1
  165. package/dist/components/kbd/kbd.d.ts +8 -0
  166. package/dist/components/kbd/kbd.d.ts.map +1 -1
  167. package/dist/components/kbd/kbd.js +2 -1
  168. package/dist/components/kbd/kbd.js.map +1 -1
  169. package/dist/components/loader/loader.d.ts +8 -0
  170. package/dist/components/loader/loader.d.ts.map +1 -1
  171. package/dist/components/loader/loader.js +2 -1
  172. package/dist/components/loader/loader.js.map +1 -1
  173. package/dist/components/menubar/menubar.d.ts +8 -0
  174. package/dist/components/menubar/menubar.d.ts.map +1 -1
  175. package/dist/components/menubar/menubar.js +2 -1
  176. package/dist/components/menubar/menubar.js.map +1 -1
  177. package/dist/components/meter/meter.d.ts +4 -0
  178. package/dist/components/meter/meter.d.ts.map +1 -1
  179. package/dist/components/meter/meter.js +2 -1
  180. package/dist/components/meter/meter.js.map +1 -1
  181. package/dist/components/navigation/index.js +1 -0
  182. package/dist/components/navigation/index.js.map +1 -1
  183. package/dist/components/navigation/navigation-context.js +1 -0
  184. package/dist/components/navigation/navigation-context.js.map +1 -1
  185. package/dist/components/navigation/navigation-link-variants.d.ts +2 -2
  186. package/dist/components/navigation/navigation-link-variants.js +2 -1
  187. package/dist/components/navigation/navigation-link-variants.js.map +1 -1
  188. package/dist/components/navigation/navigation-link.d.ts +22 -0
  189. package/dist/components/navigation/navigation-link.d.ts.map +1 -1
  190. package/dist/components/navigation/navigation-link.js +2 -1
  191. package/dist/components/navigation/navigation-link.js.map +1 -1
  192. package/dist/components/navigation/navigation.d.ts +12 -0
  193. package/dist/components/navigation/navigation.d.ts.map +1 -1
  194. package/dist/components/navigation/navigation.js +2 -1
  195. package/dist/components/navigation/navigation.js.map +1 -1
  196. package/dist/components/navigation-menu/navigation-menu.d.ts +33 -0
  197. package/dist/components/navigation-menu/navigation-menu.d.ts.map +1 -1
  198. package/dist/components/navigation-menu/navigation-menu.js +2 -1
  199. package/dist/components/navigation-menu/navigation-menu.js.map +1 -1
  200. package/dist/components/number-field/number-field.d.ts +14 -0
  201. package/dist/components/number-field/number-field.d.ts.map +1 -1
  202. package/dist/components/number-field/number-field.js +2 -1
  203. package/dist/components/number-field/number-field.js.map +1 -1
  204. package/dist/components/otp-field/otp-field.d.ts +9 -0
  205. package/dist/components/otp-field/otp-field.d.ts.map +1 -1
  206. package/dist/components/otp-field/otp-field.js +2 -1
  207. package/dist/components/otp-field/otp-field.js.map +1 -1
  208. package/dist/components/pagination/pagination.d.ts +16 -0
  209. package/dist/components/pagination/pagination.d.ts.map +1 -1
  210. package/dist/components/pagination/pagination.js +2 -1
  211. package/dist/components/pagination/pagination.js.map +1 -1
  212. package/dist/components/popover/popover.d.ts +5 -1
  213. package/dist/components/popover/popover.d.ts.map +1 -1
  214. package/dist/components/popover/popover.js +3 -2
  215. package/dist/components/popover/popover.js.map +1 -1
  216. package/dist/components/preview-card/preview-card.d.ts +5 -1
  217. package/dist/components/preview-card/preview-card.d.ts.map +1 -1
  218. package/dist/components/preview-card/preview-card.js +3 -2
  219. package/dist/components/preview-card/preview-card.js.map +1 -1
  220. package/dist/components/progress/progress.d.ts +17 -0
  221. package/dist/components/progress/progress.d.ts.map +1 -1
  222. package/dist/components/progress/progress.js +2 -1
  223. package/dist/components/progress/progress.js.map +1 -1
  224. package/dist/components/radio/radio.js +2 -1
  225. package/dist/components/radio/radio.js.map +1 -1
  226. package/dist/components/radio-group/radio-group.d.ts +4 -0
  227. package/dist/components/radio-group/radio-group.d.ts.map +1 -1
  228. package/dist/components/radio-group/radio-group.js +2 -1
  229. package/dist/components/radio-group/radio-group.js.map +1 -1
  230. package/dist/components/rating/rating.d.ts +79 -0
  231. package/dist/components/rating/rating.d.ts.map +1 -0
  232. package/dist/components/rating/rating.js +302 -0
  233. package/dist/components/rating/rating.js.map +1 -0
  234. package/dist/components/scroll-area/scroll-area.d.ts +13 -0
  235. package/dist/components/scroll-area/scroll-area.d.ts.map +1 -1
  236. package/dist/components/scroll-area/scroll-area.js +2 -1
  237. package/dist/components/scroll-area/scroll-area.js.map +1 -1
  238. package/dist/components/select/select.d.ts +20 -1
  239. package/dist/components/select/select.d.ts.map +1 -1
  240. package/dist/components/select/select.js +3 -2
  241. package/dist/components/select/select.js.map +1 -1
  242. package/dist/components/separator/separator.d.ts +4 -0
  243. package/dist/components/separator/separator.d.ts.map +1 -1
  244. package/dist/components/separator/separator.js +2 -1
  245. package/dist/components/separator/separator.js.map +1 -1
  246. package/dist/components/skeleton/skeleton.d.ts +4 -0
  247. package/dist/components/skeleton/skeleton.d.ts.map +1 -1
  248. package/dist/components/skeleton/skeleton.js +2 -1
  249. package/dist/components/skeleton/skeleton.js.map +1 -1
  250. package/dist/components/slider/slider.d.ts +5 -0
  251. package/dist/components/slider/slider.d.ts.map +1 -1
  252. package/dist/components/slider/slider.js +2 -1
  253. package/dist/components/slider/slider.js.map +1 -1
  254. package/dist/components/sparkline/sparkline.d.ts +44 -0
  255. package/dist/components/sparkline/sparkline.d.ts.map +1 -1
  256. package/dist/components/sparkline/sparkline.js +2 -1
  257. package/dist/components/sparkline/sparkline.js.map +1 -1
  258. package/dist/components/spinner/spinner.d.ts +8 -0
  259. package/dist/components/spinner/spinner.d.ts.map +1 -1
  260. package/dist/components/spinner/spinner.js +2 -1
  261. package/dist/components/spinner/spinner.js.map +1 -1
  262. package/dist/components/switch/switch.d.ts +19 -15
  263. package/dist/components/switch/switch.d.ts.map +1 -1
  264. package/dist/components/switch/switch.js +2 -1
  265. package/dist/components/switch/switch.js.map +1 -1
  266. package/dist/components/table/table.d.ts +28 -0
  267. package/dist/components/table/table.d.ts.map +1 -1
  268. package/dist/components/table/table.js +2 -1
  269. package/dist/components/table/table.js.map +1 -1
  270. package/dist/components/tabs/tabs.d.ts +32 -2
  271. package/dist/components/tabs/tabs.d.ts.map +1 -1
  272. package/dist/components/tabs/tabs.js +2 -1
  273. package/dist/components/tabs/tabs.js.map +1 -1
  274. package/dist/components/text-animate/text-animate.d.ts +31 -0
  275. package/dist/components/text-animate/text-animate.d.ts.map +1 -1
  276. package/dist/components/text-animate/text-animate.js +27 -9
  277. package/dist/components/text-animate/text-animate.js.map +1 -1
  278. package/dist/components/textarea/textarea.d.ts +15 -0
  279. package/dist/components/textarea/textarea.d.ts.map +1 -1
  280. package/dist/components/textarea/textarea.js +2 -1
  281. package/dist/components/textarea/textarea.js.map +1 -1
  282. package/dist/components/thumbnail/thumbnail.d.ts +22 -2
  283. package/dist/components/thumbnail/thumbnail.d.ts.map +1 -1
  284. package/dist/components/thumbnail/thumbnail.js +2 -1
  285. package/dist/components/thumbnail/thumbnail.js.map +1 -1
  286. package/dist/components/time-field/time-field.d.ts +35 -0
  287. package/dist/components/time-field/time-field.d.ts.map +1 -1
  288. package/dist/components/time-field/time-field.js +2 -1
  289. package/dist/components/time-field/time-field.js.map +1 -1
  290. package/dist/components/toast/toast.d.ts +18 -0
  291. package/dist/components/toast/toast.d.ts.map +1 -1
  292. package/dist/components/toast/toast.js +2 -1
  293. package/dist/components/toast/toast.js.map +1 -1
  294. package/dist/components/toc/toc.d.ts +10 -0
  295. package/dist/components/toc/toc.d.ts.map +1 -1
  296. package/dist/components/toc/toc.js +2 -1
  297. package/dist/components/toc/toc.js.map +1 -1
  298. package/dist/components/toggle/toggle.js +1 -0
  299. package/dist/components/toggle/toggle.js.map +1 -1
  300. package/dist/components/toggle-group/toggle-group.js +2 -1
  301. package/dist/components/toggle-group/toggle-group.js.map +1 -1
  302. package/dist/components/toolbar/toolbar.js +2 -1
  303. package/dist/components/toolbar/toolbar.js.map +1 -1
  304. package/dist/components/tooltip/tooltip.d.ts +5 -1
  305. package/dist/components/tooltip/tooltip.d.ts.map +1 -1
  306. package/dist/components/tooltip/tooltip.js +3 -2
  307. package/dist/components/tooltip/tooltip.js.map +1 -1
  308. package/dist/hooks/use-direction.js +1 -0
  309. package/dist/hooks/use-direction.js.map +1 -1
  310. package/dist/hooks/use-dismissible.d.ts +4 -0
  311. package/dist/hooks/use-dismissible.d.ts.map +1 -1
  312. package/dist/hooks/use-dismissible.js +1 -0
  313. package/dist/hooks/use-dismissible.js.map +1 -1
  314. package/dist/hooks/use-local-storage.js +1 -0
  315. package/dist/hooks/use-local-storage.js.map +1 -1
  316. package/dist/hooks/use-media-query.js +1 -0
  317. package/dist/hooks/use-media-query.js.map +1 -1
  318. package/dist/hooks/use-reduced-motion.d.ts +1 -1
  319. package/dist/hooks/use-reduced-motion.js +1 -0
  320. package/dist/hooks/use-reduced-motion.js.map +1 -1
  321. package/dist/hooks/use-theme.d.ts +1 -1
  322. package/dist/hooks/use-theme.js +1 -0
  323. package/dist/hooks/use-theme.js.map +1 -1
  324. package/dist/index.d.ts +9 -0
  325. package/dist/index.d.ts.map +1 -1
  326. package/dist/index.js +11 -1
  327. package/dist/index.js.map +1 -1
  328. package/dist/internal/color-control.d.ts +75 -0
  329. package/dist/internal/color-control.d.ts.map +1 -0
  330. package/dist/internal/color-control.js +79 -0
  331. package/dist/internal/color-control.js.map +1 -0
  332. package/dist/internal/color-math.d.ts +9 -0
  333. package/dist/internal/color-math.d.ts.map +1 -0
  334. package/dist/internal/color-math.js +35 -0
  335. package/dist/internal/color-math.js.map +1 -0
  336. package/dist/internal/color-picker-context.d.ts +34 -0
  337. package/dist/internal/color-picker-context.d.ts.map +1 -0
  338. package/dist/internal/color-picker-context.js +42 -0
  339. package/dist/internal/color-picker-context.js.map +1 -0
  340. package/dist/{floating.d.ts → internal/floating.d.ts} +3 -3
  341. package/dist/internal/floating.d.ts.map +1 -0
  342. package/dist/{floating.js → internal/floating.js} +1 -0
  343. package/dist/internal/floating.js.map +1 -0
  344. package/dist/{modal.d.ts → internal/modal.d.ts} +2 -2
  345. package/dist/internal/modal.d.ts.map +1 -0
  346. package/dist/{modal.js → internal/modal.js} +1 -0
  347. package/dist/internal/modal.js.map +1 -0
  348. package/dist/{utils.d.ts → internal/utils.d.ts} +2 -2
  349. package/dist/internal/utils.d.ts.map +1 -0
  350. package/dist/{utils.js → internal/utils.js} +1 -0
  351. package/dist/internal/utils.js.map +1 -0
  352. package/dist/lib/color.d.ts +95 -0
  353. package/dist/lib/color.d.ts.map +1 -0
  354. package/dist/lib/color.js +329 -0
  355. package/dist/lib/color.js.map +1 -0
  356. package/dist/providers/direction-provider.d.ts +4 -4
  357. package/dist/providers/direction-provider.d.ts.map +1 -1
  358. package/dist/providers/direction-provider.js +1 -0
  359. package/dist/providers/direction-provider.js.map +1 -1
  360. package/dist/providers/reduced-motion-provider.d.ts +4 -8
  361. package/dist/providers/reduced-motion-provider.d.ts.map +1 -1
  362. package/dist/providers/reduced-motion-provider.js +1 -0
  363. package/dist/providers/reduced-motion-provider.js.map +1 -1
  364. package/dist/providers/theme-provider/index.js +1 -0
  365. package/dist/providers/theme-provider/index.js.map +1 -1
  366. package/dist/providers/theme-provider/theme-provider.d.ts +28 -12
  367. package/dist/providers/theme-provider/theme-provider.d.ts.map +1 -1
  368. package/dist/providers/theme-provider/theme-provider.js +1 -0
  369. package/dist/providers/theme-provider/theme-provider.js.map +1 -1
  370. package/dist/providers/theme-provider/theme-script.js +1 -0
  371. package/dist/providers/theme-provider/theme-script.js.map +1 -1
  372. package/package.json +91 -31
  373. package/src/components/accordion/accordion.tsx +25 -1
  374. package/src/components/alert/alert.tsx +30 -2
  375. package/src/components/alert-dialog/alert-dialog.test.tsx +34 -2
  376. package/src/components/alert-dialog/alert-dialog.tsx +21 -5
  377. package/src/components/autocomplete/autocomplete.test.tsx +1 -1
  378. package/src/components/autocomplete/autocomplete.tsx +22 -2
  379. package/src/components/avatar/avatar.test.tsx +2 -2
  380. package/src/components/avatar/avatar.tsx +17 -1
  381. package/src/components/background-pattern/background-pattern-interactive.tsx +4 -2
  382. package/src/components/background-pattern/background-pattern-shared.tsx +56 -19
  383. package/src/components/background-pattern/background-pattern.test.tsx +36 -1
  384. package/src/components/background-pattern/background-pattern.tsx +24 -9
  385. package/src/components/badge/badge.tsx +14 -2
  386. package/src/components/border-beam/border-beam.test.tsx +91 -0
  387. package/src/components/border-beam/border-beam.tsx +131 -0
  388. package/src/components/breadcrumb/breadcrumb.tsx +9 -1
  389. package/src/components/button/button-variants.ts +1 -1
  390. package/src/components/button/button.tsx +13 -2
  391. package/src/components/button-group/button-group.tsx +11 -1
  392. package/src/components/calendar/calendar.tsx +6 -1
  393. package/src/components/card/card.test.tsx +98 -0
  394. package/src/components/card/card.tsx +154 -0
  395. package/src/components/carousel/carousel.test.tsx +179 -0
  396. package/src/components/carousel/carousel.tsx +329 -6
  397. package/src/components/checkbox/checkbox.test.tsx +2 -2
  398. package/src/components/checkbox/checkbox.tsx +1 -1
  399. package/src/components/checkbox-group/checkbox-group.tsx +5 -1
  400. package/src/components/chip/chip.tsx +33 -1
  401. package/src/components/collapsible/collapsible.tsx +1 -1
  402. package/src/components/color-area/color-area.test.tsx +242 -0
  403. package/src/components/color-area/color-area.tsx +356 -0
  404. package/src/components/color-picker/color-picker.test.tsx +286 -0
  405. package/src/components/color-picker/color-picker.tsx +546 -0
  406. package/src/components/color-slider/color-slider.test.tsx +222 -0
  407. package/src/components/color-slider/color-slider.tsx +330 -0
  408. package/src/components/color-swatch/color-swatch.test.tsx +117 -0
  409. package/src/components/color-swatch/color-swatch.tsx +119 -0
  410. package/src/components/color-swatch-picker/color-swatch-picker.test.tsx +287 -0
  411. package/src/components/color-swatch-picker/color-swatch-picker.tsx +327 -0
  412. package/src/components/combobox/combobox.test.tsx +1 -1
  413. package/src/components/combobox/combobox.tsx +26 -2
  414. package/src/components/context-menu/context-menu.test.tsx +28 -0
  415. package/src/components/context-menu/context-menu.tsx +16 -5
  416. package/src/components/copy-button/copy-button.test.tsx +14 -1
  417. package/src/components/copy-button/copy-button.tsx +27 -6
  418. package/src/components/countdown/countdown.tsx +15 -1
  419. package/src/components/date-field/date-field.tsx +36 -1
  420. package/src/components/date-picker/date-picker.test.tsx +1 -1
  421. package/src/components/date-picker/date-picker.tsx +95 -1
  422. package/src/components/dialog/dialog.test.tsx +30 -1
  423. package/src/components/dialog/dialog.tsx +28 -6
  424. package/src/components/drawer/drawer.test.tsx +32 -1
  425. package/src/components/drawer/drawer.tsx +37 -7
  426. package/src/components/dropdown-menu/dropdown-menu.test.tsx +28 -0
  427. package/src/components/dropdown-menu/dropdown-menu.tsx +16 -5
  428. package/src/components/field/field.tsx +1 -1
  429. package/src/components/fieldset/fieldset.tsx +1 -1
  430. package/src/components/gradient-glow/gradient-glow.test.tsx +7 -1
  431. package/src/components/gradient-glow/gradient-glow.tsx +64 -11
  432. package/src/components/input/input-variants.ts +1 -1
  433. package/src/components/input/input.tsx +24 -4
  434. package/src/components/kbd/kbd.tsx +9 -1
  435. package/src/components/loader/loader.tsx +9 -1
  436. package/src/components/menubar/menubar.tsx +9 -1
  437. package/src/components/meter/meter.tsx +5 -1
  438. package/src/components/navigation/navigation-link-variants.ts +1 -1
  439. package/src/components/navigation/navigation-link.tsx +23 -1
  440. package/src/components/navigation/navigation.tsx +23 -3
  441. package/src/components/navigation-menu/navigation-menu.tsx +34 -1
  442. package/src/components/number-field/number-field.tsx +15 -1
  443. package/src/components/otp-field/otp-field.tsx +10 -1
  444. package/src/components/pagination/pagination.tsx +17 -1
  445. package/src/components/popover/popover.test.tsx +1 -1
  446. package/src/components/popover/popover.tsx +6 -2
  447. package/src/components/preview-card/preview-card.tsx +6 -2
  448. package/src/components/progress/progress.tsx +18 -1
  449. package/src/components/radio/radio.test.tsx +1 -1
  450. package/src/components/radio/radio.tsx +1 -1
  451. package/src/components/radio-group/radio-group.test.tsx +1 -1
  452. package/src/components/radio-group/radio-group.tsx +5 -1
  453. package/src/components/rating/rating.test.tsx +246 -0
  454. package/src/components/rating/rating.tsx +457 -0
  455. package/src/components/scroll-area/scroll-area.test.tsx +1 -1
  456. package/src/components/scroll-area/scroll-area.tsx +14 -1
  457. package/src/components/select/select.tsx +21 -2
  458. package/src/components/separator/separator.tsx +5 -1
  459. package/src/components/skeleton/skeleton.tsx +5 -1
  460. package/src/components/slider/slider.test.tsx +1 -1
  461. package/src/components/slider/slider.tsx +6 -1
  462. package/src/components/sparkline/sparkline.test.tsx +1 -1
  463. package/src/components/sparkline/sparkline.tsx +45 -1
  464. package/src/components/spinner/spinner.tsx +9 -1
  465. package/src/components/switch/switch.test.tsx +1 -1
  466. package/src/components/switch/switch.tsx +5 -1
  467. package/src/components/table/table.tsx +29 -1
  468. package/src/components/tabs/tabs.test.tsx +1 -1
  469. package/src/components/tabs/tabs.tsx +33 -2
  470. package/src/components/text-animate/text-animate.test.tsx +62 -0
  471. package/src/components/text-animate/text-animate.tsx +77 -9
  472. package/src/components/textarea/textarea.tsx +16 -1
  473. package/src/components/thumbnail/thumbnail.test.tsx +1 -1
  474. package/src/components/thumbnail/thumbnail.tsx +21 -1
  475. package/src/components/time-field/time-field.tsx +36 -1
  476. package/src/components/toast/toast.test.tsx +1 -1
  477. package/src/components/toast/toast.tsx +19 -1
  478. package/src/components/toc/toc.tsx +11 -1
  479. package/src/components/toggle/toggle.test.tsx +1 -1
  480. package/src/components/toggle-group/toggle-group.tsx +1 -1
  481. package/src/components/toolbar/toolbar.tsx +1 -1
  482. package/src/components/tooltip/tooltip.test.tsx +1 -1
  483. package/src/components/tooltip/tooltip.tsx +6 -2
  484. package/src/hooks/use-dismissible.ts +4 -0
  485. package/src/hooks/use-local-storage.ts +3 -3
  486. package/src/hooks/use-reduced-motion.ts +1 -1
  487. package/src/hooks/use-theme.ts +1 -1
  488. package/src/index.ts +11 -2
  489. package/src/internal/color-control.ts +178 -0
  490. package/src/internal/color-math.ts +44 -0
  491. package/src/internal/color-picker-context.ts +80 -0
  492. package/src/{floating.ts → internal/floating.ts} +3 -3
  493. package/src/{modal.ts → internal/modal.ts} +3 -3
  494. package/src/lib/color.test.ts +178 -0
  495. package/src/lib/color.ts +471 -0
  496. package/src/providers/direction-provider.tsx +4 -4
  497. package/src/providers/reduced-motion-provider.tsx +4 -8
  498. package/src/providers/theme-provider/theme-provider.tsx +28 -12
  499. package/src/providers/theme-provider/theme-script.tsx +2 -2
  500. package/src/test/setup.ts +1 -1
  501. package/styles.css +28 -4
  502. package/dist/floating.d.ts.map +0 -1
  503. package/dist/floating.js.map +0 -1
  504. package/dist/modal.d.ts.map +0 -1
  505. package/dist/modal.js.map +0 -1
  506. package/dist/utils.d.ts.map +0 -1
  507. package/dist/utils.js.map +0 -1
  508. /package/src/{floating.test.ts → internal/floating.test.ts} +0 -0
  509. /package/src/{modal.test.ts → internal/modal.test.ts} +0 -0
  510. /package/src/{utils.test.tsx → internal/utils.test.tsx} +0 -0
  511. /package/src/{utils.ts → internal/utils.ts} +0 -0
@@ -3,7 +3,7 @@
3
3
  import * as React from 'react'
4
4
  import { LazyMotion, domAnimation, m } from 'motion/react'
5
5
  import { useReducedMotion } from '../../hooks/use-reduced-motion'
6
- import { cn } from '../../utils'
6
+ import { cn } from '../../internal/utils'
7
7
 
8
8
  interface CountdownParts {
9
9
  days: number
@@ -37,10 +37,18 @@ function getParts(total: number): CountdownParts {
37
37
  }
38
38
 
39
39
  interface CountdownProps extends Omit<React.ComponentProps<'div'>, 'children'> {
40
+ /** Absolute instant to count down to (a `Date`, epoch-ms, or date string). */
40
41
  targetDate?: Date | number | string
42
+ /** Relative length in **seconds** from mount. Ignored when `targetDate` is set. */
41
43
  duration?: number
44
+ /**
45
+ * Tick interval in milliseconds.
46
+ * @default 1000
47
+ */
42
48
  interval?: number
49
+ /** Fired once when the countdown reaches zero. */
43
50
  onComplete?: () => void
51
+ /** Segments and labels, or a render-prop receiving `{ days, hours, minutes, seconds, total, isComplete }`. */
44
52
  children?: React.ReactNode | ((parts: CountdownParts) => React.ReactNode)
45
53
  }
46
54
 
@@ -138,8 +146,14 @@ function DigitRoller({ digit, reduced }: { digit: number; reduced: boolean }) {
138
146
  }
139
147
 
140
148
  interface CountdownSegmentProps extends Omit<React.ComponentProps<'span'>, 'children'> {
149
+ /** Which unit to read from the parent `Countdown`. */
141
150
  unit?: 'days' | 'hours' | 'minutes' | 'seconds'
151
+ /** Render this number directly instead of reading context (standalone display). */
142
152
  value?: number
153
+ /**
154
+ * Minimum digit count; the value is zero-padded to this width.
155
+ * @default 2
156
+ */
143
157
  minDigits?: number
144
158
  }
145
159
 
@@ -4,7 +4,7 @@ import * as React from 'react'
4
4
  import { format as formatDate, formatISO, getDaysInMonth, isValid } from 'date-fns'
5
5
  import { type VariantProps } from 'class-variance-authority'
6
6
  import { useFieldRootContext } from '@base-ui/react/internals/field-root-context'
7
- import { cn } from '../../utils'
7
+ import { cn } from '../../internal/utils'
8
8
  import { useDirection } from '../../hooks/use-direction'
9
9
  import { inputVariants } from '../input/input-variants'
10
10
 
@@ -27,19 +27,54 @@ interface LiteralNode {
27
27
  type FormatNode = SegmentNode | LiteralNode
28
28
 
29
29
  interface DateFieldProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'defaultValue' | 'onChange'> {
30
+ /** Controlled value. Pair with `onValueChange`. */
30
31
  value?: Date | null
32
+ /** Uncontrolled initial value. */
31
33
  defaultValue?: Date | null
34
+ /** Fires with a `Date` when complete, or `null` when cleared. */
32
35
  onValueChange?: (date: Date | null) => void
36
+ /**
37
+ * date-fns token string defining the segments and separators.
38
+ * @default 'MM/dd/yyyy'
39
+ */
33
40
  format?: string
41
+ /**
42
+ * Field appearance - bordered or filled.
43
+ * @default 'outline'
44
+ */
34
45
  variant?: DateFieldVariant
46
+ /**
47
+ * Height, padding, and text scale.
48
+ * @default 'md'
49
+ */
35
50
  size?: DateFieldSize
51
+ /** Content pinned to the start edge. */
36
52
  startSlot?: React.ReactNode
53
+ /** Content pinned to the end edge. */
37
54
  endSlot?: React.ReactNode
55
+ /**
56
+ * Blocks interaction and removes the segments from the tab order.
57
+ * @default false
58
+ */
38
59
  disabled?: boolean
60
+ /**
61
+ * Segments stay focusable and readable but can't be edited.
62
+ * @default false
63
+ */
39
64
  readOnly?: boolean
65
+ /**
66
+ * Marks the hidden form input as required (needs `name`).
67
+ * @default false
68
+ */
40
69
  required?: boolean
70
+ /** Renders a hidden `<input>` with the ISO date for form submission. */
41
71
  name?: string
72
+ /**
73
+ * Drop the input appearance - for composing inside another field (used by `DatePicker`).
74
+ * @default false
75
+ */
42
76
  unstyled?: boolean
77
+ /** Ref to the underlying element. */
43
78
  ref?: React.Ref<HTMLDivElement>
44
79
  }
45
80
 
@@ -105,7 +105,7 @@ describe('DatePicker', () => {
105
105
  await user.keyboard('09')
106
106
 
107
107
  await user.click(screen.getByRole('button', { name: /open calendar/i }))
108
- // react-day-picker labels the month caption — September should now be visible.
108
+ // react-day-picker labels the month caption - September should now be visible.
109
109
  const grid = await screen.findByRole('grid')
110
110
  expect(grid).toHaveAccessibleName(/september 2026/i)
111
111
  })
@@ -9,7 +9,7 @@ import { Input, inputVariants } from '../input'
9
9
  import { Popover, PopoverContent, PopoverTrigger, type PopoverContentProps } from '../popover/popover'
10
10
  import { buttonVariants } from '../button/button-variants'
11
11
  import { useFieldRootContext } from '@base-ui/react/internals/field-root-context'
12
- import { cn } from '../../utils'
12
+ import { cn } from '../../internal/utils'
13
13
 
14
14
  type DatePickerSize = 'sm' | 'md' | 'lg'
15
15
  type DatePickerVariant = 'outline' | 'soft'
@@ -32,32 +32,117 @@ type CalendarPassthrough = DistributiveOmit<
32
32
  >
33
33
 
34
34
  type DatePickerBase = CalendarPassthrough & {
35
+ /**
36
+ * Height, padding, and calendar cell scale.
37
+ * @default 'md'
38
+ */
35
39
  size?: DatePickerSize
40
+ /**
41
+ * Field appearance - bordered or filled.
42
+ * @default 'outline'
43
+ */
36
44
  variant?: DatePickerVariant
45
+ /**
46
+ * date-fns format for the date field(s).
47
+ * @default 'MM/dd/yyyy'
48
+ */
37
49
  dateFormat?: string
50
+ /**
51
+ * date-fns format for the time field(s).
52
+ * @default 'HH:mm:ss'
53
+ */
38
54
  timeFormat?: string
55
+ /**
56
+ * Show a clear button (multiple mode).
57
+ * @default false
58
+ */
39
59
  clearable?: boolean
60
+ /** Content pinned to the start edge. */
40
61
  startSlot?: React.ReactNode
62
+ /** Content pinned to the end edge. */
41
63
  endSlot?: React.ReactNode
64
+ /**
65
+ * Disable the whole control.
66
+ * @default false
67
+ */
42
68
  disabled?: boolean
69
+ /** Dates that can't be selected in the calendar. */
43
70
  disabledDates?: Matcher | Matcher[]
71
+ /**
72
+ * Make the typeable fields read-only.
73
+ * @default false
74
+ */
44
75
  readOnly?: boolean
76
+ /**
77
+ * Mark the form field as required.
78
+ * @default false
79
+ */
45
80
  required?: boolean
81
+ /**
82
+ * Hidden input name for form submission. `range` mode emits `name[from]` / `name[to]`; with `showTime` the value is a
83
+ * full datetime.
84
+ */
46
85
  name?: string
86
+ /** Flag the field invalid - sets `data-invalid` for styling + conveys it to assistive tech. */
47
87
  'aria-invalid'?: boolean
88
+ /** Classes on the root wrapper - use for footprint/layout (e.g. `max-w-60`). Merged via `tailwind-merge`. */
48
89
  className?: string
90
+ /**
91
+ * Classes on the inner field box - use to override field styling (border, radius, background). Merged via
92
+ * `tailwind-merge`.
93
+ */
49
94
  inputClassName?: string
95
+ /**
96
+ * Separator between the range's two fields.
97
+ * @default '–'
98
+ */
50
99
  rangeSeparator?: React.ReactNode
100
+ /** Controlled open state. Pair with `onOpenChange`. */
51
101
  open?: boolean
102
+ /**
103
+ * Uncontrolled initial open state.
104
+ * @default false
105
+ */
52
106
  defaultOpen?: boolean
107
+ /** Fires when the popover opens or closes. */
53
108
  onOpenChange?: (open: boolean) => void
109
+ /**
110
+ * Preferred popover side.
111
+ * @default 'bottom'
112
+ */
54
113
  side?: 'top' | 'bottom' | 'left' | 'right'
114
+ /**
115
+ * Popover alignment.
116
+ * @default 'end'
117
+ */
55
118
  align?: 'start' | 'center' | 'end'
119
+ /**
120
+ * Gap between the field and the popover.
121
+ * @default 6
122
+ */
56
123
  sideOffset?: number
124
+ /** Escape hatch forwarded to the inner `PopoverContent` (collision props, `className`, …). */
57
125
  popoverProps?: Partial<PopoverContentProps>
126
+ /**
127
+ * Override auto-close. By default only single mode closes on pick; range and multiple stay open (dismiss on
128
+ * outside-click/Escape).
129
+ * @default auto
130
+ */
58
131
  closeOnSelect?: boolean
132
+ /**
133
+ * Add a `TimeField` (single/range modes).
134
+ * @default false
135
+ */
59
136
  showTime?: boolean
137
+ /**
138
+ * Icon for the popover trigger button.
139
+ * @default calendar icon
140
+ */
60
141
  triggerIcon?: React.ReactNode
142
+ /**
143
+ * Accessible label for the trigger button.
144
+ * @default 'Open calendar'
145
+ */
61
146
  triggerAriaLabel?: string
62
147
  }
63
148
 
@@ -75,11 +160,20 @@ type DatePickerProps =
75
160
  onValueChange?: (v: DateRange | undefined) => void
76
161
  })
77
162
  | (DatePickerBase & {
163
+ /**
164
+ * Selection behavior; determines the `value` shape.
165
+ * @default 'single'
166
+ */
78
167
  mode: 'multiple'
168
+ /** Controlled value; shape matches `mode`. Pair with `onValueChange`. */
79
169
  value?: Date[] | undefined
170
+ /** Uncontrolled initial value. */
80
171
  defaultValue?: Date[] | undefined
172
+ /** Fires when the selection changes; the argument shape matches `mode`. */
81
173
  onValueChange?: (v: Date[] | undefined) => void
174
+ /** Placeholder for the multiple-mode summary field. */
82
175
  placeholder?: string
176
+ /** Customize the multiple-mode summary text. */
83
177
  formatValue?: (value: Date[] | undefined) => string
84
178
  })
85
179
 
@@ -20,12 +20,14 @@ function renderDialog({
20
20
  description = 'Make changes to your account.',
21
21
  closeButton,
22
22
  backdrop,
23
+ frame,
23
24
  contentClassName,
24
25
  }: {
25
26
  title?: string
26
27
  description?: string
27
28
  closeButton?: boolean
28
29
  backdrop?: boolean
30
+ frame?: boolean
29
31
  contentClassName?: string
30
32
  } = {}) {
31
33
  return render(
@@ -35,6 +37,7 @@ function renderDialog({
35
37
  className={contentClassName}
36
38
  {...(closeButton !== undefined ? { closeButton } : {})}
37
39
  {...(backdrop !== undefined ? { backdrop } : {})}
40
+ {...(frame !== undefined ? { frame } : {})}
38
41
  >
39
42
  <DialogHeader>
40
43
  <DialogTitle>{title}</DialogTitle>
@@ -61,7 +64,7 @@ describe('Dialog', () => {
61
64
  expect(screen.queryByText('Body content')).toBeNull()
62
65
  })
63
66
 
64
- it('opens on trigger click and exposes a labelled dialog', async () => {
67
+ it('opens on trigger click and exposes a labeled dialog', async () => {
65
68
  const user = userEvent.setup()
66
69
  renderDialog()
67
70
 
@@ -159,6 +162,32 @@ describe('Dialog', () => {
159
162
  expect(document.querySelector('[data-slot="dialog-backdrop"]')).toBeNull()
160
163
  })
161
164
 
165
+ it('frames the popup by default and drops the frame when frame is false', async () => {
166
+ const user = userEvent.setup()
167
+ const { unmount } = renderDialog()
168
+
169
+ await user.click(screen.getByRole('button', { name: 'Open dialog' }))
170
+ await screen.findByRole('dialog')
171
+ expect(document.querySelector('[data-slot="dialog-popup"]')).toHaveAttribute('data-frame')
172
+
173
+ unmount()
174
+ renderDialog({ frame: false })
175
+
176
+ await user.click(screen.getByRole('button', { name: 'Open dialog' }))
177
+ await screen.findByRole('dialog')
178
+ expect(document.querySelector('[data-slot="dialog-popup"]')).not.toHaveAttribute('data-frame')
179
+ })
180
+
181
+ it('drops the frame when the backdrop is off, even if frame is set', async () => {
182
+ const user = userEvent.setup()
183
+ renderDialog({ backdrop: false, frame: true })
184
+
185
+ await user.click(screen.getByRole('button', { name: 'Open dialog' }))
186
+ await screen.findByRole('dialog')
187
+
188
+ expect(document.querySelector('[data-slot="dialog-popup"]')).not.toHaveAttribute('data-frame')
189
+ })
190
+
162
191
  it('has no accessibility violations when open', async () => {
163
192
  const user = userEvent.setup()
164
193
  renderDialog()
@@ -1,7 +1,7 @@
1
1
  import * as React from 'react'
2
2
  import { Dialog as BaseDialog } from '@base-ui/react/dialog'
3
- import { cn } from '../../utils'
4
- import { type ModalContentProps, splitModalProps } from '../../modal'
3
+ import { cn } from '../../internal/utils'
4
+ import { type ModalContentProps, splitModalProps } from '../../internal/modal'
5
5
  import { buttonVariants } from '../button/button-variants'
6
6
 
7
7
  type DialogProps = React.ComponentProps<typeof BaseDialog.Root>
@@ -25,9 +25,27 @@ type DialogContentProps = ModalContentProps<
25
25
  React.ComponentProps<typeof BaseDialog.Backdrop>,
26
26
  React.ComponentProps<typeof BaseDialog.Viewport>
27
27
  > & {
28
+ /**
29
+ * Render the × button in the corner.
30
+ * @default true
31
+ */
28
32
  closeButton?: boolean
33
+ /**
34
+ * Accessible label for the close button.
35
+ * @default 'Close'
36
+ */
29
37
  closeLabel?: string
38
+ /**
39
+ * Render the dimmed, blurred backdrop behind the popup.
40
+ * @default true
41
+ */
30
42
  backdrop?: boolean
43
+ /**
44
+ * Wrap the popup in a translucent glass frame. Needs `backdrop`: without one the popup
45
+ * is always a plain solid card.
46
+ * @default true
47
+ */
48
+ frame?: boolean
31
49
  }
32
50
 
33
51
  function DialogContent({
@@ -36,10 +54,14 @@ function DialogContent({
36
54
  closeButton = true,
37
55
  closeLabel = 'Close',
38
56
  backdrop = true,
57
+ frame = true,
39
58
  backdropProps,
40
59
  viewportProps,
41
60
  ...props
42
61
  }: DialogContentProps) {
62
+ // The frame is a rim of blurred page around the popup, so it only reads against the
63
+ // backdrop. Without one it collapses to a plain solid card.
64
+ const showFrame = frame && backdrop
43
65
  const { portal, popup } = splitModalProps(props)
44
66
  return (
45
67
  <BaseDialog.Portal {...portal}>
@@ -65,12 +87,12 @@ function DialogContent({
65
87
  >
66
88
  <BaseDialog.Popup
67
89
  data-slot="dialog-popup"
90
+ {...(showFrame ? { 'data-frame': '' } : {})}
68
91
  className={cn(
69
92
  'group/dialog-popup relative flex max-h-full min-h-0 w-150 max-w-full flex-col',
70
93
  'rounded-2xl border',
71
- backdrop
72
- ? 'border-white/15 bg-white/10 p-1.5 backdrop-blur-sm'
73
- : 'bg-background border-border-overlay shadow-2xl',
94
+ showFrame ? 'border-white/15 bg-white/10 p-1.5 backdrop-blur-sm' : 'bg-background border-border-overlay',
95
+ !showFrame && 'shadow-2xl',
74
96
  'isolate transform-gpu outline-none',
75
97
  'motion-safe:transition-[opacity,scale] motion-safe:duration-250 motion-safe:ease-[cubic-bezier(0.175,0.885,0.32,1.5)]',
76
98
  'data-starting-style:motion-safe:scale-95 data-starting-style:motion-safe:opacity-0',
@@ -84,7 +106,7 @@ function DialogContent({
84
106
  data-slot="dialog-content"
85
107
  className={cn(
86
108
  'relative flex min-h-0 flex-col overflow-hidden not-has-[>[data-slot=dialog-footer]]:pb-6 not-has-[>[data-slot=dialog-header]]:pt-6 [&>[data-slot=dialog-header]+[data-slot=dialog-footer]]:pt-0',
87
- backdrop && 'bg-background rounded-[calc(var(--radius-2xl)*5/6)]',
109
+ showFrame && 'bg-background rounded-[calc(var(--radius-2xl)*5/6)]',
88
110
  )}
89
111
  >
90
112
  {children}
@@ -21,6 +21,7 @@ function renderDrawer({
21
21
  description = 'Update your details below.',
22
22
  closeButton,
23
23
  backdrop,
24
+ frame,
24
25
  contentClassName,
25
26
  }: {
26
27
  side?: 'top' | 'bottom' | 'left' | 'right'
@@ -28,6 +29,7 @@ function renderDrawer({
28
29
  description?: string
29
30
  closeButton?: boolean
30
31
  backdrop?: boolean
32
+ frame?: boolean
31
33
  contentClassName?: string
32
34
  } = {}) {
33
35
  return render(
@@ -37,6 +39,7 @@ function renderDrawer({
37
39
  className={contentClassName}
38
40
  {...(closeButton !== undefined ? { closeButton } : {})}
39
41
  {...(backdrop !== undefined ? { backdrop } : {})}
42
+ {...(frame !== undefined ? { frame } : {})}
40
43
  >
41
44
  <DrawerHeader>
42
45
  <DrawerTitle>{title}</DrawerTitle>
@@ -63,7 +66,7 @@ describe('Drawer', () => {
63
66
  expect(screen.queryByText('Body content')).toBeNull()
64
67
  })
65
68
 
66
- it('opens on trigger click and exposes a labelled dialog', async () => {
69
+ it('opens on trigger click and exposes a labeled dialog', async () => {
67
70
  const user = userEvent.setup()
68
71
  renderDrawer()
69
72
 
@@ -165,6 +168,34 @@ describe('Drawer', () => {
165
168
 
166
169
  // Outermost drawer keeps its backdrop; the nested one auto-omits it.
167
170
  expect(document.querySelectorAll('[data-slot="drawer-backdrop"]')).toHaveLength(1)
171
+ // The frame needs a backdrop, so only the outermost drawer is framed.
172
+ expect(document.querySelectorAll('[data-slot="drawer-popup"][data-frame]')).toHaveLength(1)
173
+ })
174
+
175
+ it('frames the popup by default and drops the frame when frame is false', async () => {
176
+ const user = userEvent.setup()
177
+ const { unmount } = renderDrawer()
178
+
179
+ await user.click(screen.getByRole('button', { name: 'Open drawer' }))
180
+ await screen.findByRole('dialog')
181
+ expect(document.querySelector('[data-slot="drawer-popup"]')).toHaveAttribute('data-frame')
182
+
183
+ unmount()
184
+ renderDrawer({ frame: false })
185
+
186
+ await user.click(screen.getByRole('button', { name: 'Open drawer' }))
187
+ await screen.findByRole('dialog')
188
+ expect(document.querySelector('[data-slot="drawer-popup"]')).not.toHaveAttribute('data-frame')
189
+ })
190
+
191
+ it('drops the frame when the backdrop is off, even if frame is set', async () => {
192
+ const user = userEvent.setup()
193
+ renderDrawer({ backdrop: false, frame: true })
194
+
195
+ await user.click(screen.getByRole('button', { name: 'Open drawer' }))
196
+ await screen.findByRole('dialog')
197
+
198
+ expect(document.querySelector('[data-slot="drawer-popup"]')).not.toHaveAttribute('data-frame')
168
199
  })
169
200
 
170
201
  it('positions on the requested side', async () => {
@@ -2,8 +2,8 @@
2
2
 
3
3
  import * as React from 'react'
4
4
  import { Drawer as BaseDrawer } from '@base-ui/react/drawer'
5
- import { cn } from '../../utils'
6
- import { type ModalContentProps, splitModalProps } from '../../modal'
5
+ import { cn } from '../../internal/utils'
6
+ import { type ModalContentProps, splitModalProps } from '../../internal/modal'
7
7
  import { buttonVariants } from '../button/button-variants'
8
8
 
9
9
  type DrawerSide = 'top' | 'bottom' | 'left' | 'right'
@@ -20,6 +20,10 @@ const DrawerDepthContext = React.createContext(0)
20
20
  const DrawerSnapContext = React.createContext(false)
21
21
 
22
22
  interface DrawerProps extends Omit<React.ComponentProps<typeof BaseDrawer.Root>, 'swipeDirection'> {
23
+ /**
24
+ * The edge the drawer slides in from.
25
+ * @default 'bottom'
26
+ */
23
27
  side?: DrawerSide
24
28
  }
25
29
 
@@ -164,9 +168,25 @@ type DrawerContentProps = ModalContentProps<
164
168
  React.ComponentProps<typeof BaseDrawer.Backdrop>,
165
169
  React.ComponentProps<typeof BaseDrawer.Viewport>
166
170
  > & {
171
+ /**
172
+ * Render the × button in the corner.
173
+ * @default true
174
+ */
167
175
  closeButton?: boolean
176
+ /**
177
+ * Accessible label for the close button.
178
+ * @default 'Close'
179
+ */
168
180
  closeLabel?: string
181
+ /** Render the dimmed backdrop. Defaults to `true` at the top level, off when nested. */
169
182
  backdrop?: boolean
183
+ /**
184
+ * Wrap the panel in a translucent glass frame. Turned off, the drawer is a plain solid
185
+ * card and the handle sits inside it, the way a nested drawer looks. Needs `backdrop`:
186
+ * without one the panel is always solid.
187
+ * @default true
188
+ */
189
+ frame?: boolean
170
190
  }
171
191
 
172
192
  function DrawerContent({
@@ -175,6 +195,7 @@ function DrawerContent({
175
195
  closeButton = true,
176
196
  closeLabel = 'Close',
177
197
  backdrop,
198
+ frame = true,
178
199
  backdropProps,
179
200
  viewportProps,
180
201
  ...props
@@ -184,6 +205,10 @@ function DrawerContent({
184
205
  const hasSnap = React.useContext(DrawerSnapContext)
185
206
  const forceBackdrop = backdropProps?.forceRender === true
186
207
  const showBackdrop = forceBackdrop || (backdrop ?? depth <= 1)
208
+ // The frame is a rim of blurred page around the panel, so it only reads against the
209
+ // backdrop. Without one - a nested drawer, or `backdrop={false}` - it collapses to a
210
+ // plain solid card with the handle inside.
211
+ const showFrame = frame && showBackdrop
187
212
  const snapSide = hasSnap && (side === 'bottom' || side === 'top') ? side : null
188
213
  const { portal, popup } = splitModalProps(props)
189
214
 
@@ -214,18 +239,23 @@ function DrawerContent({
214
239
  >
215
240
  <BaseDrawer.Popup
216
241
  data-slot="drawer-popup"
242
+ {...(showFrame ? { 'data-frame': '' } : {})}
217
243
  className={cn(
218
244
  'relative flex min-h-0 flex-col rounded-2xl border',
219
245
  snapSide
220
246
  ? cn(
221
- 'bg-background border-border-overlay before:bg-background-strong data-expanded:p-1.5',
222
- 'data-expanded:before:bg-background data-expanded:border-white/15 data-expanded:bg-white/10 data-expanded:shadow-none data-expanded:backdrop-blur-sm',
247
+ 'bg-background border-border-overlay before:bg-background-strong',
248
+ showFrame &&
249
+ cn(
250
+ 'data-expanded:before:bg-background data-expanded:border-white/15 data-expanded:p-1.5',
251
+ 'data-expanded:bg-white/10 data-expanded:shadow-none data-expanded:backdrop-blur-sm',
252
+ ),
223
253
  )
224
- : showBackdrop
254
+ : showFrame
225
255
  ? 'before:bg-background border-white/15 bg-white/10 p-1.5 backdrop-blur-sm'
226
256
  : 'bg-background border-border-overlay before:bg-background-strong',
227
257
  'isolate outline-none',
228
- (hasSnap || !showBackdrop) && SHADOW_SIDE[side],
258
+ (hasSnap || !showFrame) && SHADOW_SIDE[side],
229
259
  FRAME_PAD_SIDE[side],
230
260
  HANDLE_SIDE[side],
231
261
  'motion-safe:transition-[transform,height] motion-safe:duration-400 motion-safe:ease-[cubic-bezier(0.32,1.2,0.4,1)]',
@@ -250,7 +280,7 @@ function DrawerContent({
250
280
  data-slot="drawer-content"
251
281
  className={cn(
252
282
  'relative flex min-h-0 flex-col not-has-[>[data-slot=drawer-footer]]:pb-6 not-has-[>[data-slot=drawer-header]]:pt-6 [&>[data-slot=drawer-header]+[data-slot=drawer-footer]]:pt-0',
253
- showBackdrop || snapSide
283
+ showFrame || snapSide
254
284
  ? 'bg-background rounded-[calc(var(--radius-2xl)*5/6)]'
255
285
  : CONTENT_RECLAIM_SIDE[side],
256
286
  snapSide ? 'h-[calc(100dvh-1.5rem-var(--snap-offset,0))]' : 'flex-1',
@@ -86,6 +86,34 @@ describe('DropdownMenu', () => {
86
86
  expect(item.className).toContain('text-base')
87
87
  })
88
88
 
89
+ it('marks every item kind with data-orientation="vertical"', async () => {
90
+ const user = setupUser()
91
+ render(
92
+ <DropdownMenu>
93
+ <DropdownMenuTrigger>Open</DropdownMenuTrigger>
94
+ <DropdownMenuContent>
95
+ <DropdownMenuItem>Item</DropdownMenuItem>
96
+ <DropdownMenuLinkItem href="https://example.com">Link</DropdownMenuLinkItem>
97
+ <DropdownMenuCheckboxItem>Check</DropdownMenuCheckboxItem>
98
+ <DropdownMenuRadioGroup value="a">
99
+ <DropdownMenuRadioItem value="a">Radio</DropdownMenuRadioItem>
100
+ </DropdownMenuRadioGroup>
101
+ <DropdownMenuSub>
102
+ <DropdownMenuSubTrigger>More</DropdownMenuSubTrigger>
103
+ <DropdownMenuSubContent>
104
+ <DropdownMenuItem>Nested</DropdownMenuItem>
105
+ </DropdownMenuSubContent>
106
+ </DropdownMenuSub>
107
+ </DropdownMenuContent>
108
+ </DropdownMenu>,
109
+ )
110
+ await user.click(screen.getByRole('button', { name: 'Open' }))
111
+ await screen.findByRole('menuitem', { name: 'Item' })
112
+ const items = document.querySelectorAll('[data-slot$="-item"], [data-slot="dropdown-menu-sub-trigger"]')
113
+ expect(items).toHaveLength(5)
114
+ items.forEach((item) => expect(item).toHaveAttribute('data-orientation', 'vertical'))
115
+ })
116
+
89
117
  it('renders the popup with size-driven radius', async () => {
90
118
  const user = setupUser()
91
119
  render(<BasicMenu size="sm" />)