panelui-native 0.116.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (499) hide show
  1. package/README.md +3 -1
  2. package/lib/module/components/accordion/index.js.map +1 -1
  3. package/lib/module/components/ai-input/index.js.map +1 -1
  4. package/lib/module/components/alert/index.js.map +1 -1
  5. package/lib/module/components/animated-badge/index.js +1 -2
  6. package/lib/module/components/animated-badge/index.js.map +1 -1
  7. package/lib/module/components/area-chart/index.js +15 -3
  8. package/lib/module/components/area-chart/index.js.map +1 -1
  9. package/lib/module/components/attachment/index.js.map +1 -1
  10. package/lib/module/components/avatar/index.js.map +1 -1
  11. package/lib/module/components/avatar-cropper/index.js.map +1 -1
  12. package/lib/module/components/badge/index.js.map +1 -1
  13. package/lib/module/components/bar-chart/index.js +15 -3
  14. package/lib/module/components/bar-chart/index.js.map +1 -1
  15. package/lib/module/components/breadcrumb/index.js.map +1 -1
  16. package/lib/module/components/bubble-chart/index.js +13 -3
  17. package/lib/module/components/bubble-chart/index.js.map +1 -1
  18. package/lib/module/components/bump-chart/index.js +15 -3
  19. package/lib/module/components/bump-chart/index.js.map +1 -1
  20. package/lib/module/components/button/index.js.map +1 -1
  21. package/lib/module/components/button-group/index.js.map +1 -1
  22. package/lib/module/components/calendar/index.js.map +1 -1
  23. package/lib/module/components/candlestick-chart/index.js +15 -3
  24. package/lib/module/components/candlestick-chart/index.js.map +1 -1
  25. package/lib/module/components/card/index.js.map +1 -1
  26. package/lib/module/components/checkbox/index.js.map +1 -1
  27. package/lib/module/components/chip/index.js.map +1 -1
  28. package/lib/module/components/collapsible/index.js.map +1 -1
  29. package/lib/module/components/color-picker/index.js +13 -5
  30. package/lib/module/components/color-picker/index.js.map +1 -1
  31. package/lib/module/components/combobox/index.js +1 -2
  32. package/lib/module/components/combobox/index.js.map +1 -1
  33. package/lib/module/components/context-menu/index.js +1 -2
  34. package/lib/module/components/context-menu/index.js.map +1 -1
  35. package/lib/module/components/countdown/index.js.map +1 -1
  36. package/lib/module/components/dialog/index.js.map +1 -1
  37. package/lib/module/components/empty-state/index.js.map +1 -1
  38. package/lib/module/components/fab/index.js +2 -1
  39. package/lib/module/components/fab/index.js.map +1 -1
  40. package/lib/module/components/feedback/index.js +1 -2
  41. package/lib/module/components/feedback/index.js.map +1 -1
  42. package/lib/module/components/field/index.js.map +1 -1
  43. package/lib/module/components/file-upload/index.js.map +1 -1
  44. package/lib/module/components/flip-card/index.js +1 -2
  45. package/lib/module/components/flip-card/index.js.map +1 -1
  46. package/lib/module/components/frame/index.js +1 -2
  47. package/lib/module/components/frame/index.js.map +1 -1
  48. package/lib/module/components/grid-item/index.js.map +1 -1
  49. package/lib/module/components/heatmap-chart/index.js +1 -2
  50. package/lib/module/components/heatmap-chart/index.js.map +1 -1
  51. package/lib/module/components/image-viewer/index.js +1 -2
  52. package/lib/module/components/image-viewer/index.js.map +1 -1
  53. package/lib/module/components/input/index.js +1 -2
  54. package/lib/module/components/input/index.js.map +1 -1
  55. package/lib/module/components/input-group/index.js.map +1 -1
  56. package/lib/module/components/item/index.js.map +1 -1
  57. package/lib/module/components/kpi/index.js +1 -2
  58. package/lib/module/components/kpi/index.js.map +1 -1
  59. package/lib/module/components/label/index.js.map +1 -1
  60. package/lib/module/components/leaderboard/index.js.map +1 -1
  61. package/lib/module/components/line-chart/index.js +15 -3
  62. package/lib/module/components/line-chart/index.js.map +1 -1
  63. package/lib/module/components/live-line-chart/index.js +16 -4
  64. package/lib/module/components/live-line-chart/index.js.map +1 -1
  65. package/lib/module/components/map/native-style.js +38 -7
  66. package/lib/module/components/map/native-style.js.map +1 -1
  67. package/lib/module/components/markdown-editor/index.js.map +1 -1
  68. package/lib/module/components/marker/index.js.map +1 -1
  69. package/lib/module/components/marquee/index.js +2 -1
  70. package/lib/module/components/marquee/index.js.map +1 -1
  71. package/lib/module/components/message/index.js.map +1 -1
  72. package/lib/module/components/message-scroller/index.js +2 -3
  73. package/lib/module/components/message-scroller/index.js.map +1 -1
  74. package/lib/module/components/meter/index.js.map +1 -1
  75. package/lib/module/components/mirror-area-chart/index.js +15 -3
  76. package/lib/module/components/mirror-area-chart/index.js.map +1 -1
  77. package/lib/module/components/number-input/index.js +1 -2
  78. package/lib/module/components/number-input/index.js.map +1 -1
  79. package/lib/module/components/otp-input/index.js +1 -2
  80. package/lib/module/components/otp-input/index.js.map +1 -1
  81. package/lib/module/components/page-header/index.js +1 -2
  82. package/lib/module/components/page-header/index.js.map +1 -1
  83. package/lib/module/components/pagination/index.js.map +1 -1
  84. package/lib/module/components/panelside/index.js +8 -7
  85. package/lib/module/components/panelside/index.js.map +1 -1
  86. package/lib/module/components/planner/index.js +1 -2
  87. package/lib/module/components/planner/index.js.map +1 -1
  88. package/lib/module/components/plot/index.js +15 -3
  89. package/lib/module/components/plot/index.js.map +1 -1
  90. package/lib/module/components/popover/index.js +1 -2
  91. package/lib/module/components/popover/index.js.map +1 -1
  92. package/lib/module/components/post/index.js +1 -2
  93. package/lib/module/components/post/index.js.map +1 -1
  94. package/lib/module/components/progress/index.js.map +1 -1
  95. package/lib/module/components/progress-button/index.js +1 -2
  96. package/lib/module/components/progress-button/index.js.map +1 -1
  97. package/lib/module/components/pyramid-chart/index.js +15 -3
  98. package/lib/module/components/pyramid-chart/index.js.map +1 -1
  99. package/lib/module/components/qr-code/index.js.map +1 -1
  100. package/lib/module/components/questionnaire/index.js +1 -2
  101. package/lib/module/components/questionnaire/index.js.map +1 -1
  102. package/lib/module/components/radio-group/index.js.map +1 -1
  103. package/lib/module/components/rating/index.js +1 -2
  104. package/lib/module/components/rating/index.js.map +1 -1
  105. package/lib/module/components/scatter-chart/index.js +13 -3
  106. package/lib/module/components/scatter-chart/index.js.map +1 -1
  107. package/lib/module/components/scroll-header/index.js +5 -4
  108. package/lib/module/components/scroll-header/index.js.map +1 -1
  109. package/lib/module/components/search-bar/index.js +1 -2
  110. package/lib/module/components/search-bar/index.js.map +1 -1
  111. package/lib/module/components/section-progress/index.js +3 -2
  112. package/lib/module/components/section-progress/index.js.map +1 -1
  113. package/lib/module/components/select/index.js.map +1 -1
  114. package/lib/module/components/separator/index.js.map +1 -1
  115. package/lib/module/components/shimmer/index.js +8 -1
  116. package/lib/module/components/shimmer/index.js.map +1 -1
  117. package/lib/module/components/signature/index.js.map +1 -1
  118. package/lib/module/components/sketch/index.js.map +1 -1
  119. package/lib/module/components/slide-button/index.js +1 -2
  120. package/lib/module/components/slide-button/index.js.map +1 -1
  121. package/lib/module/components/slider/index.js +1 -2
  122. package/lib/module/components/slider/index.js.map +1 -1
  123. package/lib/module/components/sortable/index.js +6 -7
  124. package/lib/module/components/sortable/index.js.map +1 -1
  125. package/lib/module/components/splitter/index.js +3 -2
  126. package/lib/module/components/splitter/index.js.map +1 -1
  127. package/lib/module/components/stack-card/index.js +3 -2
  128. package/lib/module/components/stack-card/index.js.map +1 -1
  129. package/lib/module/components/steps/index.js.map +1 -1
  130. package/lib/module/components/support/index.js.map +1 -1
  131. package/lib/module/components/surface/index.js.map +1 -1
  132. package/lib/module/components/swipe/index.js.map +1 -1
  133. package/lib/module/components/switch/index.js.map +1 -1
  134. package/lib/module/components/table/index.js +1 -2
  135. package/lib/module/components/table/index.js.map +1 -1
  136. package/lib/module/components/tabs/index.js +2 -1
  137. package/lib/module/components/tabs/index.js.map +1 -1
  138. package/lib/module/components/tag-input/index.js +1 -2
  139. package/lib/module/components/tag-input/index.js.map +1 -1
  140. package/lib/module/components/text-animation/index.js +2 -1
  141. package/lib/module/components/text-animation/index.js.map +1 -1
  142. package/lib/module/components/textarea/index.js +1 -2
  143. package/lib/module/components/textarea/index.js.map +1 -1
  144. package/lib/module/components/time-picker/index.js.map +1 -1
  145. package/lib/module/components/timeline/index.js.map +1 -1
  146. package/lib/module/components/toast/index.js +1 -0
  147. package/lib/module/components/toast/index.js.map +1 -1
  148. package/lib/module/components/toggle-button/index.js.map +1 -1
  149. package/lib/module/components/tooltip/index.js +1 -2
  150. package/lib/module/components/tooltip/index.js.map +1 -1
  151. package/lib/module/components/tour/index.js.map +1 -1
  152. package/lib/module/components/tree/index.js +2 -1
  153. package/lib/module/components/tree/index.js.map +1 -1
  154. package/lib/module/components/typography/index.js.map +1 -1
  155. package/lib/module/components/waterfall-chart/index.js +15 -3
  156. package/lib/module/components/waterfall-chart/index.js.map +1 -1
  157. package/lib/module/hooks/use-keyboard-avoidance.js +0 -1
  158. package/lib/module/hooks/use-keyboard-avoidance.js.map +1 -1
  159. package/lib/module/hooks/use-reveal-progress.js.map +1 -1
  160. package/lib/module/hooks/use-scroll-sections.js.map +1 -1
  161. package/lib/module/icons/index.js +22 -1
  162. package/lib/module/icons/index.js.map +1 -1
  163. package/lib/module/index.js +4 -0
  164. package/lib/module/index.js.map +1 -1
  165. package/lib/module/primitives/animated-pressable.js.map +1 -1
  166. package/lib/module/primitives/chart-accessibility.js +9 -1
  167. package/lib/module/primitives/chart-accessibility.js.map +1 -1
  168. package/lib/module/primitives/glass.js.map +1 -1
  169. package/lib/module/primitives/refs.js +4 -0
  170. package/lib/module/primitives/refs.js.map +1 -0
  171. package/lib/module/primitives/scroll-progress.js.map +1 -1
  172. package/lib/module/primitives/text.js.map +1 -1
  173. package/lib/module/primitives/web-deps.js +17 -0
  174. package/lib/module/primitives/web-deps.js.map +1 -0
  175. package/lib/module/uniwind-env.d.ts +1 -0
  176. package/lib/typescript/src/components/accordion/index.d.ts +8 -7
  177. package/lib/typescript/src/components/accordion/index.d.ts.map +1 -1
  178. package/lib/typescript/src/components/ai-input/index.d.ts.map +1 -1
  179. package/lib/typescript/src/components/alert/index.d.ts +9 -8
  180. package/lib/typescript/src/components/alert/index.d.ts.map +1 -1
  181. package/lib/typescript/src/components/animated-badge/index.d.ts +5 -4
  182. package/lib/typescript/src/components/animated-badge/index.d.ts.map +1 -1
  183. package/lib/typescript/src/components/area-chart/index.d.ts +11 -1
  184. package/lib/typescript/src/components/area-chart/index.d.ts.map +1 -1
  185. package/lib/typescript/src/components/attachment/index.d.ts +10 -9
  186. package/lib/typescript/src/components/attachment/index.d.ts.map +1 -1
  187. package/lib/typescript/src/components/avatar/index.d.ts +7 -6
  188. package/lib/typescript/src/components/avatar/index.d.ts.map +1 -1
  189. package/lib/typescript/src/components/avatar-cropper/index.d.ts.map +1 -1
  190. package/lib/typescript/src/components/badge/index.d.ts +5 -4
  191. package/lib/typescript/src/components/badge/index.d.ts.map +1 -1
  192. package/lib/typescript/src/components/bar-chart/index.d.ts +11 -1
  193. package/lib/typescript/src/components/bar-chart/index.d.ts.map +1 -1
  194. package/lib/typescript/src/components/bottom-sheet/index.d.ts +1 -1
  195. package/lib/typescript/src/components/breadcrumb/index.d.ts +9 -8
  196. package/lib/typescript/src/components/breadcrumb/index.d.ts.map +1 -1
  197. package/lib/typescript/src/components/bubble-chart/index.d.ts +11 -1
  198. package/lib/typescript/src/components/bubble-chart/index.d.ts.map +1 -1
  199. package/lib/typescript/src/components/bump-chart/index.d.ts +11 -1
  200. package/lib/typescript/src/components/bump-chart/index.d.ts.map +1 -1
  201. package/lib/typescript/src/components/button/index.d.ts +4 -4
  202. package/lib/typescript/src/components/button/index.d.ts.map +1 -1
  203. package/lib/typescript/src/components/button-group/index.d.ts +5 -4
  204. package/lib/typescript/src/components/button-group/index.d.ts.map +1 -1
  205. package/lib/typescript/src/components/calendar/index.d.ts.map +1 -1
  206. package/lib/typescript/src/components/candlestick-chart/index.d.ts +11 -1
  207. package/lib/typescript/src/components/candlestick-chart/index.d.ts.map +1 -1
  208. package/lib/typescript/src/components/card/index.d.ts +16 -15
  209. package/lib/typescript/src/components/card/index.d.ts.map +1 -1
  210. package/lib/typescript/src/components/checkbox/index.d.ts +5 -4
  211. package/lib/typescript/src/components/checkbox/index.d.ts.map +1 -1
  212. package/lib/typescript/src/components/chip/index.d.ts +4 -4
  213. package/lib/typescript/src/components/chip/index.d.ts.map +1 -1
  214. package/lib/typescript/src/components/collapsible/index.d.ts +7 -6
  215. package/lib/typescript/src/components/collapsible/index.d.ts.map +1 -1
  216. package/lib/typescript/src/components/color-picker/index.d.ts +13 -13
  217. package/lib/typescript/src/components/color-picker/index.d.ts.map +1 -1
  218. package/lib/typescript/src/components/combobox/index.d.ts.map +1 -1
  219. package/lib/typescript/src/components/context-menu/index.d.ts.map +1 -1
  220. package/lib/typescript/src/components/countdown/index.d.ts +5 -4
  221. package/lib/typescript/src/components/countdown/index.d.ts.map +1 -1
  222. package/lib/typescript/src/components/dialog/index.d.ts +11 -10
  223. package/lib/typescript/src/components/dialog/index.d.ts.map +1 -1
  224. package/lib/typescript/src/components/empty-state/index.d.ts +12 -11
  225. package/lib/typescript/src/components/empty-state/index.d.ts.map +1 -1
  226. package/lib/typescript/src/components/fab/index.d.ts +7 -6
  227. package/lib/typescript/src/components/fab/index.d.ts.map +1 -1
  228. package/lib/typescript/src/components/feedback/index.d.ts +6 -5
  229. package/lib/typescript/src/components/feedback/index.d.ts.map +1 -1
  230. package/lib/typescript/src/components/field/index.d.ts +12 -11
  231. package/lib/typescript/src/components/field/index.d.ts.map +1 -1
  232. package/lib/typescript/src/components/file-upload/index.d.ts +5 -4
  233. package/lib/typescript/src/components/file-upload/index.d.ts.map +1 -1
  234. package/lib/typescript/src/components/flip-card/index.d.ts +5 -4
  235. package/lib/typescript/src/components/flip-card/index.d.ts.map +1 -1
  236. package/lib/typescript/src/components/frame/index.d.ts +14 -13
  237. package/lib/typescript/src/components/frame/index.d.ts.map +1 -1
  238. package/lib/typescript/src/components/grid-item/index.d.ts +30 -29
  239. package/lib/typescript/src/components/grid-item/index.d.ts.map +1 -1
  240. package/lib/typescript/src/components/heatmap-chart/index.d.ts +3 -2
  241. package/lib/typescript/src/components/heatmap-chart/index.d.ts.map +1 -1
  242. package/lib/typescript/src/components/image-viewer/index.d.ts.map +1 -1
  243. package/lib/typescript/src/components/input/index.d.ts +5 -4
  244. package/lib/typescript/src/components/input/index.d.ts.map +1 -1
  245. package/lib/typescript/src/components/input-group/index.d.ts +6 -5
  246. package/lib/typescript/src/components/input-group/index.d.ts.map +1 -1
  247. package/lib/typescript/src/components/item/index.d.ts +34 -33
  248. package/lib/typescript/src/components/item/index.d.ts.map +1 -1
  249. package/lib/typescript/src/components/kpi/index.d.ts +6 -5
  250. package/lib/typescript/src/components/kpi/index.d.ts.map +1 -1
  251. package/lib/typescript/src/components/label/index.d.ts +4 -3
  252. package/lib/typescript/src/components/label/index.d.ts.map +1 -1
  253. package/lib/typescript/src/components/leaderboard/index.d.ts +3 -2
  254. package/lib/typescript/src/components/leaderboard/index.d.ts.map +1 -1
  255. package/lib/typescript/src/components/line-chart/index.d.ts +11 -1
  256. package/lib/typescript/src/components/line-chart/index.d.ts.map +1 -1
  257. package/lib/typescript/src/components/live-line-chart/index.d.ts +11 -1
  258. package/lib/typescript/src/components/live-line-chart/index.d.ts.map +1 -1
  259. package/lib/typescript/src/components/map/native-style.d.ts.map +1 -1
  260. package/lib/typescript/src/components/markdown-editor/index.d.ts +6 -5
  261. package/lib/typescript/src/components/markdown-editor/index.d.ts.map +1 -1
  262. package/lib/typescript/src/components/marker/index.d.ts +7 -6
  263. package/lib/typescript/src/components/marker/index.d.ts.map +1 -1
  264. package/lib/typescript/src/components/marquee/index.d.ts.map +1 -1
  265. package/lib/typescript/src/components/message/index.d.ts +13 -12
  266. package/lib/typescript/src/components/message/index.d.ts.map +1 -1
  267. package/lib/typescript/src/components/message-scroller/index.d.ts.map +1 -1
  268. package/lib/typescript/src/components/meter/index.d.ts +5 -4
  269. package/lib/typescript/src/components/meter/index.d.ts.map +1 -1
  270. package/lib/typescript/src/components/mirror-area-chart/index.d.ts +11 -1
  271. package/lib/typescript/src/components/mirror-area-chart/index.d.ts.map +1 -1
  272. package/lib/typescript/src/components/number-input/index.d.ts +5 -4
  273. package/lib/typescript/src/components/number-input/index.d.ts.map +1 -1
  274. package/lib/typescript/src/components/otp-input/index.d.ts +5 -4
  275. package/lib/typescript/src/components/otp-input/index.d.ts.map +1 -1
  276. package/lib/typescript/src/components/page-header/index.d.ts +15 -14
  277. package/lib/typescript/src/components/page-header/index.d.ts.map +1 -1
  278. package/lib/typescript/src/components/pagination/index.d.ts +9 -8
  279. package/lib/typescript/src/components/pagination/index.d.ts.map +1 -1
  280. package/lib/typescript/src/components/panelside/index.d.ts.map +1 -1
  281. package/lib/typescript/src/components/planner/index.d.ts +3 -2
  282. package/lib/typescript/src/components/planner/index.d.ts.map +1 -1
  283. package/lib/typescript/src/components/plot/index.d.ts +11 -1
  284. package/lib/typescript/src/components/plot/index.d.ts.map +1 -1
  285. package/lib/typescript/src/components/popover/index.d.ts.map +1 -1
  286. package/lib/typescript/src/components/post/index.d.ts +15 -14
  287. package/lib/typescript/src/components/post/index.d.ts.map +1 -1
  288. package/lib/typescript/src/components/progress/index.d.ts +5 -4
  289. package/lib/typescript/src/components/progress/index.d.ts.map +1 -1
  290. package/lib/typescript/src/components/progress-button/index.d.ts +5 -4
  291. package/lib/typescript/src/components/progress-button/index.d.ts.map +1 -1
  292. package/lib/typescript/src/components/pyramid-chart/index.d.ts +11 -1
  293. package/lib/typescript/src/components/pyramid-chart/index.d.ts.map +1 -1
  294. package/lib/typescript/src/components/qr-code/index.d.ts +11 -10
  295. package/lib/typescript/src/components/qr-code/index.d.ts.map +1 -1
  296. package/lib/typescript/src/components/questionnaire/index.d.ts +4 -3
  297. package/lib/typescript/src/components/questionnaire/index.d.ts.map +1 -1
  298. package/lib/typescript/src/components/radio-group/index.d.ts +6 -5
  299. package/lib/typescript/src/components/radio-group/index.d.ts.map +1 -1
  300. package/lib/typescript/src/components/rating/index.d.ts +4 -4
  301. package/lib/typescript/src/components/rating/index.d.ts.map +1 -1
  302. package/lib/typescript/src/components/scatter-chart/index.d.ts +11 -1
  303. package/lib/typescript/src/components/scatter-chart/index.d.ts.map +1 -1
  304. package/lib/typescript/src/components/scroll-header/index.d.ts +11 -10
  305. package/lib/typescript/src/components/scroll-header/index.d.ts.map +1 -1
  306. package/lib/typescript/src/components/search-bar/index.d.ts +5 -4
  307. package/lib/typescript/src/components/search-bar/index.d.ts.map +1 -1
  308. package/lib/typescript/src/components/section-progress/index.d.ts.map +1 -1
  309. package/lib/typescript/src/components/select/index.d.ts.map +1 -1
  310. package/lib/typescript/src/components/selection-mode/index.d.ts +2 -2
  311. package/lib/typescript/src/components/selection-mode/index.d.ts.map +1 -1
  312. package/lib/typescript/src/components/separator/index.d.ts +17 -16
  313. package/lib/typescript/src/components/separator/index.d.ts.map +1 -1
  314. package/lib/typescript/src/components/shimmer/index.d.ts.map +1 -1
  315. package/lib/typescript/src/components/signature/index.d.ts +2 -2
  316. package/lib/typescript/src/components/signature/index.d.ts.map +1 -1
  317. package/lib/typescript/src/components/sketch/index.d.ts.map +1 -1
  318. package/lib/typescript/src/components/slide-button/index.d.ts +5 -4
  319. package/lib/typescript/src/components/slide-button/index.d.ts.map +1 -1
  320. package/lib/typescript/src/components/slider/index.d.ts +4 -4
  321. package/lib/typescript/src/components/slider/index.d.ts.map +1 -1
  322. package/lib/typescript/src/components/sortable/index.d.ts.map +1 -1
  323. package/lib/typescript/src/components/spinner/index.d.ts +11 -11
  324. package/lib/typescript/src/components/spinner/index.d.ts.map +1 -1
  325. package/lib/typescript/src/components/splitter/index.d.ts.map +1 -1
  326. package/lib/typescript/src/components/stack-card/index.d.ts +11 -10
  327. package/lib/typescript/src/components/stack-card/index.d.ts.map +1 -1
  328. package/lib/typescript/src/components/steps/index.d.ts +9 -8
  329. package/lib/typescript/src/components/steps/index.d.ts.map +1 -1
  330. package/lib/typescript/src/components/support/index.d.ts +22 -21
  331. package/lib/typescript/src/components/support/index.d.ts.map +1 -1
  332. package/lib/typescript/src/components/surface/index.d.ts +35 -34
  333. package/lib/typescript/src/components/surface/index.d.ts.map +1 -1
  334. package/lib/typescript/src/components/swipe/index.d.ts +8 -7
  335. package/lib/typescript/src/components/swipe/index.d.ts.map +1 -1
  336. package/lib/typescript/src/components/switch/index.d.ts +5 -4
  337. package/lib/typescript/src/components/switch/index.d.ts.map +1 -1
  338. package/lib/typescript/src/components/table/index.d.ts +14 -13
  339. package/lib/typescript/src/components/table/index.d.ts.map +1 -1
  340. package/lib/typescript/src/components/tabs/index.d.ts.map +1 -1
  341. package/lib/typescript/src/components/tag-input/index.d.ts +5 -4
  342. package/lib/typescript/src/components/tag-input/index.d.ts.map +1 -1
  343. package/lib/typescript/src/components/text-animation/index.d.ts.map +1 -1
  344. package/lib/typescript/src/components/textarea/index.d.ts +5 -4
  345. package/lib/typescript/src/components/textarea/index.d.ts.map +1 -1
  346. package/lib/typescript/src/components/time-picker/index.d.ts.map +1 -1
  347. package/lib/typescript/src/components/timeline/index.d.ts +18 -17
  348. package/lib/typescript/src/components/timeline/index.d.ts.map +1 -1
  349. package/lib/typescript/src/components/toast/index.d.ts +2 -2
  350. package/lib/typescript/src/components/toast/index.d.ts.map +1 -1
  351. package/lib/typescript/src/components/toggle-button/index.d.ts +6 -5
  352. package/lib/typescript/src/components/toggle-button/index.d.ts.map +1 -1
  353. package/lib/typescript/src/components/tooltip/index.d.ts.map +1 -1
  354. package/lib/typescript/src/components/tour/index.d.ts.map +1 -1
  355. package/lib/typescript/src/components/tree/index.d.ts +10 -9
  356. package/lib/typescript/src/components/tree/index.d.ts.map +1 -1
  357. package/lib/typescript/src/components/typography/index.d.ts +101 -100
  358. package/lib/typescript/src/components/typography/index.d.ts.map +1 -1
  359. package/lib/typescript/src/components/waterfall-chart/index.d.ts +11 -1
  360. package/lib/typescript/src/components/waterfall-chart/index.d.ts.map +1 -1
  361. package/lib/typescript/src/hooks/use-keyboard-avoidance.d.ts +3 -2
  362. package/lib/typescript/src/hooks/use-keyboard-avoidance.d.ts.map +1 -1
  363. package/lib/typescript/src/hooks/use-reveal-progress.d.ts +2 -2
  364. package/lib/typescript/src/hooks/use-reveal-progress.d.ts.map +1 -1
  365. package/lib/typescript/src/hooks/use-scroll-sections.d.ts +3 -2
  366. package/lib/typescript/src/hooks/use-scroll-sections.d.ts.map +1 -1
  367. package/lib/typescript/src/icons/index.d.ts +40 -0
  368. package/lib/typescript/src/icons/index.d.ts.map +1 -1
  369. package/lib/typescript/src/index.d.ts +1 -0
  370. package/lib/typescript/src/index.d.ts.map +1 -1
  371. package/lib/typescript/src/primitives/animated-pressable.d.ts +3 -2
  372. package/lib/typescript/src/primitives/animated-pressable.d.ts.map +1 -1
  373. package/lib/typescript/src/primitives/chart-accessibility.d.ts +5 -6
  374. package/lib/typescript/src/primitives/chart-accessibility.d.ts.map +1 -1
  375. package/lib/typescript/src/primitives/glass.d.ts +3 -2
  376. package/lib/typescript/src/primitives/glass.d.ts.map +1 -1
  377. package/lib/typescript/src/primitives/refs.d.ts +25 -0
  378. package/lib/typescript/src/primitives/refs.d.ts.map +1 -0
  379. package/lib/typescript/src/primitives/scroll-progress.d.ts.map +1 -1
  380. package/lib/typescript/src/primitives/text.d.ts +41 -40
  381. package/lib/typescript/src/primitives/text.d.ts.map +1 -1
  382. package/lib/typescript/src/primitives/web-deps.d.ts +11 -0
  383. package/lib/typescript/src/primitives/web-deps.d.ts.map +1 -0
  384. package/package.json +12 -7
  385. package/src/components/accordion/index.tsx +7 -6
  386. package/src/components/ai-input/index.tsx +2 -1
  387. package/src/components/alert/index.tsx +6 -5
  388. package/src/components/animated-badge/index.tsx +2 -1
  389. package/src/components/area-chart/index.tsx +31 -3
  390. package/src/components/attachment/index.tsx +9 -8
  391. package/src/components/avatar/index.tsx +4 -3
  392. package/src/components/avatar-cropper/index.tsx +2 -1
  393. package/src/components/badge/index.tsx +2 -1
  394. package/src/components/bar-chart/index.tsx +40 -3
  395. package/src/components/breadcrumb/index.tsx +8 -7
  396. package/src/components/bubble-chart/index.tsx +23 -2
  397. package/src/components/bump-chart/index.tsx +31 -3
  398. package/src/components/button/index.tsx +2 -1
  399. package/src/components/button-group/index.tsx +2 -1
  400. package/src/components/calendar/index.tsx +2 -1
  401. package/src/components/candlestick-chart/index.tsx +25 -2
  402. package/src/components/card/index.tsx +7 -6
  403. package/src/components/checkbox/index.tsx +2 -1
  404. package/src/components/chip/index.tsx +2 -1
  405. package/src/components/collapsible/index.tsx +6 -5
  406. package/src/components/color-picker/index.tsx +29 -15
  407. package/src/components/combobox/index.tsx +3 -2
  408. package/src/components/context-menu/index.tsx +2 -1
  409. package/src/components/countdown/index.tsx +2 -1
  410. package/src/components/dialog/index.tsx +3 -2
  411. package/src/components/empty-state/index.tsx +7 -6
  412. package/src/components/fab/index.tsx +6 -4
  413. package/src/components/feedback/index.tsx +5 -4
  414. package/src/components/field/index.tsx +11 -10
  415. package/src/components/file-upload/index.tsx +4 -3
  416. package/src/components/flip-card/index.tsx +4 -3
  417. package/src/components/frame/index.tsx +13 -12
  418. package/src/components/grid-item/index.tsx +10 -9
  419. package/src/components/heatmap-chart/index.tsx +2 -1
  420. package/src/components/image-viewer/index.tsx +2 -1
  421. package/src/components/input/index.tsx +2 -1
  422. package/src/components/input-group/index.tsx +4 -3
  423. package/src/components/item/index.tsx +11 -10
  424. package/src/components/kpi/index.tsx +3 -2
  425. package/src/components/label/index.tsx +3 -2
  426. package/src/components/leaderboard/index.tsx +2 -1
  427. package/src/components/line-chart/index.tsx +31 -3
  428. package/src/components/live-line-chart/index.tsx +31 -4
  429. package/src/components/map/native-style.ts +31 -4
  430. package/src/components/markdown-editor/index.tsx +11 -11
  431. package/src/components/marker/index.tsx +4 -3
  432. package/src/components/marquee/index.tsx +2 -1
  433. package/src/components/message/index.tsx +10 -9
  434. package/src/components/message-scroller/index.tsx +4 -4
  435. package/src/components/meter/index.tsx +2 -1
  436. package/src/components/mirror-area-chart/index.tsx +25 -2
  437. package/src/components/number-input/index.tsx +2 -1
  438. package/src/components/otp-input/index.tsx +4 -3
  439. package/src/components/page-header/index.tsx +12 -11
  440. package/src/components/pagination/index.tsx +6 -5
  441. package/src/components/panelside/index.tsx +8 -7
  442. package/src/components/planner/index.tsx +7 -7
  443. package/src/components/plot/index.tsx +37 -3
  444. package/src/components/popover/index.tsx +2 -1
  445. package/src/components/post/index.tsx +12 -11
  446. package/src/components/progress/index.tsx +2 -1
  447. package/src/components/progress-button/index.tsx +2 -1
  448. package/src/components/pyramid-chart/index.tsx +25 -2
  449. package/src/components/qr-code/index.tsx +8 -7
  450. package/src/components/questionnaire/index.tsx +4 -3
  451. package/src/components/radio-group/index.tsx +3 -2
  452. package/src/components/rating/index.tsx +2 -1
  453. package/src/components/scatter-chart/index.tsx +23 -2
  454. package/src/components/scroll-header/index.tsx +13 -11
  455. package/src/components/search-bar/index.tsx +7 -8
  456. package/src/components/section-progress/index.tsx +3 -2
  457. package/src/components/select/index.tsx +2 -1
  458. package/src/components/separator/index.tsx +2 -1
  459. package/src/components/shimmer/index.tsx +11 -2
  460. package/src/components/signature/index.tsx +2 -1
  461. package/src/components/sketch/index.tsx +2 -1
  462. package/src/components/slide-button/index.tsx +2 -1
  463. package/src/components/slider/index.tsx +2 -1
  464. package/src/components/sortable/index.tsx +5 -7
  465. package/src/components/splitter/index.tsx +3 -2
  466. package/src/components/stack-card/index.tsx +9 -7
  467. package/src/components/steps/index.tsx +8 -7
  468. package/src/components/support/index.tsx +17 -16
  469. package/src/components/surface/index.tsx +2 -1
  470. package/src/components/swipe/index.tsx +5 -4
  471. package/src/components/switch/index.tsx +2 -1
  472. package/src/components/table/index.tsx +11 -10
  473. package/src/components/tabs/index.tsx +4 -2
  474. package/src/components/tag-input/index.tsx +5 -5
  475. package/src/components/text-animation/index.tsx +2 -1
  476. package/src/components/textarea/index.tsx +3 -3
  477. package/src/components/time-picker/index.tsx +2 -1
  478. package/src/components/timeline/index.tsx +17 -16
  479. package/src/components/toast/index.tsx +2 -2
  480. package/src/components/toggle-button/index.tsx +3 -2
  481. package/src/components/tooltip/index.tsx +2 -1
  482. package/src/components/tour/index.tsx +3 -2
  483. package/src/components/tree/index.tsx +11 -9
  484. package/src/components/typography/index.tsx +8 -7
  485. package/src/components/waterfall-chart/index.tsx +35 -2
  486. package/src/hooks/use-keyboard-avoidance.ts +3 -2
  487. package/src/hooks/use-reveal-progress.ts +3 -2
  488. package/src/hooks/use-scroll-sections.ts +3 -2
  489. package/src/icons/index.tsx +21 -2
  490. package/src/index.ts +14 -0
  491. package/src/primitives/animated-pressable.tsx +2 -1
  492. package/src/primitives/chart-accessibility.ts +9 -5
  493. package/src/primitives/glass.tsx +3 -2
  494. package/src/primitives/refs.ts +45 -0
  495. package/src/primitives/scroll-progress.tsx +2 -1
  496. package/src/primitives/text.tsx +2 -1
  497. package/src/primitives/web-deps.ts +14 -0
  498. package/lib/module/uniwind-env.d.js +0 -4
  499. package/lib/module/uniwind-env.d.js.map +0 -1
@@ -947,6 +947,15 @@ function CrosshairDot({
947
947
  );
948
948
  }
949
949
 
950
+ /**
951
+ * How long the readout waits before claiming the touch, in milliseconds.
952
+ *
953
+ * Long enough that a tap reaches a button drawn over the chart and a swipe
954
+ * scrolls the screen, short enough that a deliberate press does not feel
955
+ * ignored.
956
+ */
957
+ const DEFAULT_HOLD = 180;
958
+
950
959
  export interface AreaChartTooltipProps {
951
960
  color?: string;
952
961
  /** Format one series' value. Defaults to a compact number. */
@@ -954,6 +963,16 @@ export interface AreaChartTooltipProps {
954
963
  /** Format the readout's heading from the row. Defaults to the value at xDataKey. */
955
964
  formatX?: (datum: AreaChartDatum) => string;
956
965
  className?: string;
966
+ /**
967
+ * How long a press has to be held before the readout takes the touch, in
968
+ * milliseconds.
969
+ *
970
+ * Until then the touch belongs to whatever else wants it: a quick tap still
971
+ * reaches a button floating over the chart, and a swipe still scrolls the
972
+ * screen the chart sits in. Set `0` to read on contact, only for a chart with
973
+ * nothing over it and no scroll view around it.
974
+ */
975
+ activateAfterLongPress?: number;
957
976
  }
958
977
 
959
978
  /**
@@ -962,7 +981,13 @@ export interface AreaChartTooltipProps {
962
981
  * The hit area is the whole plot. A crosshair you have to land on a band to
963
982
  * summon is a crosshair nobody finds.
964
983
  */
965
- function AreaChartTooltip({ color, formatValue, formatX, className }: AreaChartTooltipProps) {
984
+ function AreaChartTooltip({
985
+ color,
986
+ formatValue,
987
+ formatX,
988
+ className,
989
+ activateAfterLongPress = DEFAULT_HOLD,
990
+ }: AreaChartTooltipProps) {
966
991
  const {
967
992
  data,
968
993
  xDataKey,
@@ -1001,7 +1026,8 @@ function AreaChartTooltip({ color, formatValue, formatX, className }: AreaChartT
1001
1026
 
1002
1027
  return Gesture.Pan()
1003
1028
  .minDistance(0)
1004
- .onBegin((event) => {
1029
+ .activateAfterLongPress(activateAfterLongPress)
1030
+ .onStart((event) => {
1005
1031
  'worklet';
1006
1032
  resolve(event.x);
1007
1033
  })
@@ -1011,10 +1037,12 @@ function AreaChartTooltip({ color, formatValue, formatX, className }: AreaChartT
1011
1037
  })
1012
1038
  .onFinalize(() => {
1013
1039
  'worklet';
1040
+ // Fires whether or not the readout ever took the touch.
1041
+ if (activeIndex.value === -1) return;
1014
1042
  activeIndex.value = -1;
1015
1043
  runOnJS(setActiveIndexJS)(-1);
1016
1044
  });
1017
- }, [total, left, width, activeIndex, setActiveIndexJS]);
1045
+ }, [total, left, width, activeIndex, setActiveIndexJS, activateAfterLongPress]);
1018
1046
 
1019
1047
  const crosshairStyle = useAnimatedStyle(() => {
1020
1048
  const index = activeIndex.value;
@@ -35,6 +35,7 @@ import { Text, type TextProps, textChildren } from '../../primitives/text';
35
35
  import { cn } from '../../utils/cn';
36
36
  import { Item } from '../item';
37
37
  import { Shimmer } from '../shimmer';
38
+ import type { TextRef, ViewRef } from '../../primitives/refs';
38
39
 
39
40
  export type AttachmentState = 'idle' | 'uploading' | 'processing' | 'error' | 'done';
40
41
  type AttachmentSize = 'default' | 'sm' | 'xs';
@@ -86,7 +87,7 @@ export interface AttachmentProps
86
87
  children?: ReactNode;
87
88
  }
88
89
 
89
- const AttachmentRoot = forwardRef<View, AttachmentProps>(
90
+ const AttachmentRoot = forwardRef<ViewRef, AttachmentProps>(
90
91
  (
91
92
  { className, state = 'done', size = 'default', orientation, progress, children, ...props },
92
93
  ref
@@ -132,7 +133,7 @@ export interface AttachmentGroupProps extends ViewProps {
132
133
  }
133
134
 
134
135
  /** A row (or column) of attachments — the same stack `Item.Group` provides. */
135
- const AttachmentGroup = forwardRef<View, AttachmentGroupProps>(
136
+ const AttachmentGroup = forwardRef<ViewRef, AttachmentGroupProps>(
136
137
  ({ className, orientation = 'vertical', children, ...props }, ref) => (
137
138
  <Item.Group ref={ref} orientation={orientation} className={className} {...props}>
138
139
  {children}
@@ -149,7 +150,7 @@ export interface AttachmentMediaProps extends ViewProps {
149
150
  }
150
151
 
151
152
  /** Leading slot — a file-type icon tile, or an image thumbnail. */
152
- const AttachmentMedia = forwardRef<View, AttachmentMediaProps>(
153
+ const AttachmentMedia = forwardRef<ViewRef, AttachmentMediaProps>(
153
154
  ({ className, variant = 'icon', children, ...props }, ref) => (
154
155
  <Item.Media ref={ref} variant={variant} className={className} {...props}>
155
156
  {children}
@@ -163,7 +164,7 @@ export interface AttachmentContentProps extends ViewProps {
163
164
  children?: ReactNode;
164
165
  }
165
166
 
166
- const AttachmentContent = forwardRef<View, AttachmentContentProps>(
167
+ const AttachmentContent = forwardRef<ViewRef, AttachmentContentProps>(
167
168
  ({ className, children, ...props }, ref) => (
168
169
  <Item.Content ref={ref} className={className} {...props}>
169
170
  {children}
@@ -178,7 +179,7 @@ export interface AttachmentTitleProps extends TextProps {
178
179
  }
179
180
 
180
181
  /** The file name. Shimmers while the file is uploading or processing. */
181
- const AttachmentTitle = forwardRef<React.ElementRef<typeof Text>, AttachmentTitleProps>(
182
+ const AttachmentTitle = forwardRef<TextRef, AttachmentTitleProps>(
182
183
  ({ className, children, ...props }, ref) => {
183
184
  const { state } = useContext(AttachmentContext);
184
185
 
@@ -207,7 +208,7 @@ export interface AttachmentDescriptionProps extends TextProps {
207
208
 
208
209
  /** File type, size or status. Tints destructive on `error`. */
209
210
  const AttachmentDescription = forwardRef<
210
- React.ElementRef<typeof Text>,
211
+ TextRef,
211
212
  AttachmentDescriptionProps
212
213
  >(({ className, children, ...props }, ref) => {
213
214
  const { state } = useContext(AttachmentContext);
@@ -229,7 +230,7 @@ export interface AttachmentActionsProps extends ViewProps {
229
230
  children?: ReactNode;
230
231
  }
231
232
 
232
- const AttachmentActions = forwardRef<View, AttachmentActionsProps>(
233
+ const AttachmentActions = forwardRef<ViewRef, AttachmentActionsProps>(
233
234
  ({ className, children, ...props }, ref) => (
234
235
  <Item.Actions ref={ref} className={className} {...props}>
235
236
  {children}
@@ -249,7 +250,7 @@ export interface AttachmentActionProps
249
250
  * A single icon button in the actions slot — remove, retry, download. An icon
250
251
  * on its own says nothing to a screen reader, so the label is required.
251
252
  */
252
- const AttachmentAction = forwardRef<View, AttachmentActionProps>(
253
+ const AttachmentAction = forwardRef<ViewRef, AttachmentActionProps>(
253
254
  ({ className, accessibilityLabel, children, ...props }, ref) => (
254
255
  <AnimatedPressable
255
256
  ref={ref}
@@ -23,6 +23,7 @@ import {
23
23
  type AvatarSizeName,
24
24
  } from './avatar-group';
25
25
  import { avatarSourceIdentity } from './avatar-source';
26
+ import type { ViewRef } from '../../primitives/refs';
26
27
 
27
28
  const avatarVariants = tv({
28
29
  slots: {
@@ -67,7 +68,7 @@ export interface AvatarProps extends ViewProps, VariantProps<typeof avatarVarian
67
68
  imageProps?: Omit<ImageProps, 'source'>;
68
69
  }
69
70
 
70
- const AvatarRoot = forwardRef<View, AvatarProps>(
71
+ const AvatarRoot = forwardRef<ViewRef, AvatarProps>(
71
72
  ({ className, size, source, fallback, imageProps, children, ...props }, ref) => {
72
73
  const [failedSource, setFailedSource] = useState<string>();
73
74
  const { root, image, fallback: fallbackSlot } = avatarVariants({ size });
@@ -128,7 +129,7 @@ export interface AvatarBadgeProps extends ViewProps {
128
129
  * The ring is `border-background` so the badge separates from the image
129
130
  * whatever surface the avatar sits on.
130
131
  */
131
- const AvatarBadge = forwardRef<View, AvatarBadgeProps>(
132
+ const AvatarBadge = forwardRef<ViewRef, AvatarBadgeProps>(
132
133
  ({ className, children, ...props }, ref) => (
133
134
  <View
134
135
  ref={ref}
@@ -184,7 +185,7 @@ export interface AvatarGroupProps extends ViewProps {
184
185
  * </Avatar.Group>
185
186
  * ```
186
187
  */
187
- const AvatarGroup = forwardRef<View, AvatarGroupProps>(
188
+ const AvatarGroup = forwardRef<ViewRef, AvatarGroupProps>(
188
189
  ({ className, size = 'md', max, total, overlap, children, ...props }, ref) => {
189
190
  const faces = Children.toArray(children).filter(isValidElement) as ReactElement<AvatarProps>[];
190
191
  const { visible, overflow } = avatarGroupCount(faces.length, max, total);
@@ -98,6 +98,7 @@ import {
98
98
  type Size,
99
99
  type SourceCrop,
100
100
  } from './avatar-cropper-math';
101
+ import type { ViewRef } from '../../primitives/refs';
101
102
 
102
103
  export type { CropShape as AvatarCropperShape, SourceCrop as AvatarCrop };
103
104
 
@@ -633,7 +634,7 @@ function ExportStage({
633
634
  left: number;
634
635
  top: number;
635
636
  }) {
636
- const ref = useRef<View>(null);
637
+ const ref = useRef<ViewRef>(null);
637
638
  const started = useRef(false);
638
639
  const side = frame.mask;
639
640
  const { width, height } = frame.image;
@@ -2,6 +2,7 @@ import { forwardRef, type ReactNode } from 'react';
2
2
  import { View, type ViewProps } from 'react-native';
3
3
  import { tv, type VariantProps } from 'tailwind-variants';
4
4
  import { Text, textChildren } from '../../primitives/text';
5
+ import type { ViewRef } from '../../primitives/refs';
5
6
 
6
7
  const badgeVariants = tv({
7
8
  slots: {
@@ -77,7 +78,7 @@ export interface BadgeProps
77
78
  count?: number;
78
79
  }
79
80
 
80
- export const Badge = forwardRef<View, BadgeProps>(
81
+ export const Badge = forwardRef<ViewRef, BadgeProps>(
81
82
  ({ children, className, labelClassName, variant, shape, size, count, ...props }, ref) => {
82
83
  const resolvedShape = shape ?? (count !== undefined ? 'count' : 'default');
83
84
  const { root, label } = badgeVariants({ variant, shape: resolvedShape, size });
@@ -1073,12 +1073,31 @@ BarChartYAxis.layer = 'overlay' as Layer;
1073
1073
  // makes what it is drawn over unreadable too.
1074
1074
  BarChartYAxis.axis = 'y' as const;
1075
1075
 
1076
+ /**
1077
+ * How long the readout waits before claiming the touch, in milliseconds.
1078
+ *
1079
+ * Long enough that a tap reaches a button drawn over the chart and a swipe
1080
+ * scrolls the screen, short enough that a deliberate press does not feel
1081
+ * ignored.
1082
+ */
1083
+ const DEFAULT_HOLD = 180;
1084
+
1076
1085
  export interface BarChartTooltipProps {
1077
1086
  /** Format one series' value. Defaults to a compact number. */
1078
1087
  formatValue?: (value: number, key: string) => string;
1079
1088
  /** Format the readout's heading from the row. Defaults to the value at xDataKey. */
1080
1089
  formatX?: (datum: BarChartDatum) => string;
1081
1090
  className?: string;
1091
+ /**
1092
+ * How long a press has to be held before the readout takes the touch, in
1093
+ * milliseconds.
1094
+ *
1095
+ * Until then the touch belongs to whatever else wants it: a quick tap still
1096
+ * reaches a button floating over the chart, and a swipe still scrolls the
1097
+ * screen the chart sits in. Set `0` to read on contact, only for a chart with
1098
+ * nothing over it and no scroll view around it.
1099
+ */
1100
+ activateAfterLongPress?: number;
1082
1101
  }
1083
1102
 
1084
1103
  /**
@@ -1093,7 +1112,12 @@ export interface BarChartTooltipProps {
1093
1112
  * summon is a readout nobody finds — and the thinner the bars, the truer that
1094
1113
  * gets.
1095
1114
  */
1096
- function BarChartTooltip({ formatValue, formatX, className }: BarChartTooltipProps) {
1115
+ function BarChartTooltip({
1116
+ formatValue,
1117
+ formatX,
1118
+ className,
1119
+ activateAfterLongPress = DEFAULT_HOLD,
1120
+ }: BarChartTooltipProps) {
1097
1121
  const {
1098
1122
  data,
1099
1123
  xDataKey,
@@ -1142,7 +1166,8 @@ function BarChartTooltip({ formatValue, formatX, className }: BarChartTooltipPro
1142
1166
 
1143
1167
  return Gesture.Pan()
1144
1168
  .minDistance(0)
1145
- .onBegin((event) => {
1169
+ .activateAfterLongPress(activateAfterLongPress)
1170
+ .onStart((event) => {
1146
1171
  'worklet';
1147
1172
  resolve(event.x, event.y);
1148
1173
  })
@@ -1152,10 +1177,22 @@ function BarChartTooltip({ formatValue, formatX, className }: BarChartTooltipPro
1152
1177
  })
1153
1178
  .onFinalize(() => {
1154
1179
  'worklet';
1180
+ // Fires whether or not the readout ever took the touch.
1181
+ if (activeIndex.value === -1) return;
1155
1182
  activeIndex.value = -1;
1156
1183
  runOnJS(setActiveIndexJS)(-1);
1157
1184
  });
1158
- }, [total, left, top, width, height, horizontal, activeIndex, setActiveIndexJS]);
1185
+ }, [
1186
+ total,
1187
+ left,
1188
+ top,
1189
+ width,
1190
+ height,
1191
+ horizontal,
1192
+ activeIndex,
1193
+ setActiveIndexJS,
1194
+ activateAfterLongPress,
1195
+ ]);
1159
1196
 
1160
1197
  /*
1161
1198
  * The readout centres over its band and is clamped inside the plot, so it
@@ -49,6 +49,7 @@ import {
49
49
  } from '../../primitives/animated-pressable';
50
50
  import { Text, type TextProps, textChildren } from '../../primitives/text';
51
51
  import { cn } from '../../utils/cn';
52
+ import type { TextRef, ViewRef } from '../../primitives/refs';
52
53
 
53
54
  type BreadcrumbSize = 'sm' | 'default';
54
55
 
@@ -93,7 +94,7 @@ export interface BreadcrumbProps extends ViewProps {
93
94
  * The trail's landmark. Labelled for assistive tech so the row is announced as
94
95
  * "Breadcrumb" rather than an anonymous run of links.
95
96
  */
96
- const BreadcrumbRoot = forwardRef<View, BreadcrumbProps>(
97
+ const BreadcrumbRoot = forwardRef<ViewRef, BreadcrumbProps>(
97
98
  ({ className, size = 'default', separator, children, ...props }, ref) => (
98
99
  <BreadcrumbContext.Provider value={{ size, separator: separator ?? null }}>
99
100
  <View
@@ -137,7 +138,7 @@ const COLLAPSE = Symbol('breadcrumb-collapse');
137
138
  * The crumb row. It owns the separators — one between every pair of crumbs and
138
139
  * none at the ends — and the collapsing, so a caller only ever lists items.
139
140
  */
140
- const BreadcrumbList = forwardRef<View, BreadcrumbListProps>(
141
+ const BreadcrumbList = forwardRef<ViewRef, BreadcrumbListProps>(
141
142
  (
142
143
  {
143
144
  className,
@@ -195,7 +196,7 @@ export interface BreadcrumbItemProps extends ViewProps {
195
196
  }
196
197
 
197
198
  /** One crumb: wraps a link or the current page. */
198
- const BreadcrumbItem = forwardRef<View, BreadcrumbItemProps>(
199
+ const BreadcrumbItem = forwardRef<ViewRef, BreadcrumbItemProps>(
199
200
  ({ className, children, ...props }, ref) => (
200
201
  <View
201
202
  ref={ref}
@@ -222,7 +223,7 @@ export interface BreadcrumbLinkProps
222
223
  * trail. A string child is wrapped in the crumb text style; anything else
223
224
  * renders as given.
224
225
  */
225
- const BreadcrumbLink = forwardRef<View, BreadcrumbLinkProps>(
226
+ const BreadcrumbLink = forwardRef<ViewRef, BreadcrumbLinkProps>(
226
227
  ({ className, textClassName, children, ...props }, ref) => {
227
228
  const { size } = useBreadcrumb();
228
229
 
@@ -255,7 +256,7 @@ export interface BreadcrumbPageProps extends TextProps {
255
256
  * marks it as the destination, and it is painted in the full foreground so the
256
257
  * trail resolves to it.
257
258
  */
258
- const BreadcrumbPage = forwardRef<React.ElementRef<typeof Text>, BreadcrumbPageProps>(
259
+ const BreadcrumbPage = forwardRef<TextRef, BreadcrumbPageProps>(
259
260
  ({ className, ...props }, ref) => {
260
261
  const { size } = useBreadcrumb();
261
262
 
@@ -284,7 +285,7 @@ export interface BreadcrumbSeparatorProps extends ViewProps {
284
285
  * only for the rare hand-assembled trail. Hidden from screen readers — the
285
286
  * order of the crumbs already conveys the hierarchy.
286
287
  */
287
- const BreadcrumbSeparator = forwardRef<View, BreadcrumbSeparatorProps>(
288
+ const BreadcrumbSeparator = forwardRef<ViewRef, BreadcrumbSeparatorProps>(
288
289
  ({ className, children, ...props }, ref) => {
289
290
  const { separator } = useBreadcrumb();
290
291
  const rawTint = useCSSVariable('--color-muted-foreground');
@@ -318,7 +319,7 @@ export interface BreadcrumbEllipsisProps
318
319
  * for a menu of the hidden steps. Labelled "Show more" so the collapse is not
319
320
  * silent to assistive tech.
320
321
  */
321
- const BreadcrumbEllipsis = forwardRef<View, BreadcrumbEllipsisProps>(
322
+ const BreadcrumbEllipsis = forwardRef<ViewRef, BreadcrumbEllipsisProps>(
322
323
  ({ className, onPress, ...props }, ref) => {
323
324
  const rawTint = useCSSVariable('--color-muted-foreground');
324
325
  const tint = typeof rawTint === 'string' ? rawTint : undefined;
@@ -1794,6 +1794,15 @@ BubbleChartYAxis.layer = 'overlay' as Layer;
1794
1794
  // plot out.
1795
1795
  BubbleChartYAxis.axis = 'y' as const;
1796
1796
 
1797
+ /**
1798
+ * How long the readout waits before claiming the touch, in milliseconds.
1799
+ *
1800
+ * Long enough that a tap reaches a button drawn over the chart and a swipe
1801
+ * scrolls the screen, short enough that a deliberate press does not feel
1802
+ * ignored.
1803
+ */
1804
+ const DEFAULT_HOLD = 180;
1805
+
1797
1806
  export interface BubbleChartTooltipProps {
1798
1807
  /** Float a small readout beside the selected bubble. On by default. */
1799
1808
  showLabel?: boolean;
@@ -1806,6 +1815,16 @@ export interface BubbleChartTooltipProps {
1806
1815
  /** Floor on the touch target, for a chart whose smallest bubbles are tiny. */
1807
1816
  hitRadius?: number;
1808
1817
  className?: string;
1818
+ /**
1819
+ * How long a press has to be held before the readout takes the touch, in
1820
+ * milliseconds.
1821
+ *
1822
+ * Until then the touch belongs to whatever else wants it: a quick tap still
1823
+ * reaches a button floating over the chart, and a swipe still scrolls the
1824
+ * screen the chart sits in. Set `0` to read on contact, only for a chart with
1825
+ * nothing over it and no scroll view around it.
1826
+ */
1827
+ activateAfterLongPress?: number;
1809
1828
  }
1810
1829
 
1811
1830
  /**
@@ -1831,6 +1850,7 @@ function BubbleChartTooltip({
1831
1850
  formatSize,
1832
1851
  hitRadius = HIT_RADIUS,
1833
1852
  className,
1853
+ activateAfterLongPress = DEFAULT_HOLD,
1834
1854
  }: BubbleChartTooltipProps) {
1835
1855
  const {
1836
1856
  bubbles,
@@ -1926,7 +1946,8 @@ function BubbleChartTooltip({
1926
1946
 
1927
1947
  return Gesture.Pan()
1928
1948
  .minDistance(0)
1929
- .onBegin((event) => {
1949
+ .activateAfterLongPress(activateAfterLongPress)
1950
+ .onStart((event) => {
1930
1951
  'worklet';
1931
1952
  resolve(event.x, event.y);
1932
1953
  })
@@ -1938,7 +1959,7 @@ function BubbleChartTooltip({
1938
1959
  'worklet';
1939
1960
  clear();
1940
1961
  });
1941
- }, [hit, activeIndex, select]);
1962
+ }, [hit, activeIndex, select, activateAfterLongPress]);
1942
1963
 
1943
1964
  /*
1944
1965
  * The readout's own height, measured rather than assumed. It decides whether
@@ -1170,6 +1170,15 @@ function BumpLabel({
1170
1170
  /** Height of one name's hit box. */
1171
1171
  const LABEL_ROW = 20;
1172
1172
 
1173
+ /**
1174
+ * How long the readout waits before claiming the touch, in milliseconds.
1175
+ *
1176
+ * Long enough that a tap reaches a button drawn over the chart and a swipe
1177
+ * scrolls the screen, short enough that a deliberate press does not feel
1178
+ * ignored.
1179
+ */
1180
+ const DEFAULT_HOLD = 180;
1181
+
1173
1182
  export interface BumpChartTooltipProps {
1174
1183
  color?: string;
1175
1184
  /** Format a rank in the readout. Defaults to `#1`, `#2`… */
@@ -1177,13 +1186,29 @@ export interface BumpChartTooltipProps {
1177
1186
  /** Format the readout's heading from the row. Defaults to the value at xDataKey. */
1178
1187
  formatX?: (datum: BumpChartDatum) => string;
1179
1188
  className?: string;
1189
+ /**
1190
+ * How long a press has to be held before the readout takes the touch, in
1191
+ * milliseconds.
1192
+ *
1193
+ * Until then the touch belongs to whatever else wants it: a quick tap still
1194
+ * reaches a button floating over the chart, and a swipe still scrolls the
1195
+ * screen the chart sits in. Set `0` to read on contact, only for a chart with
1196
+ * nothing over it and no scroll view around it.
1197
+ */
1198
+ activateAfterLongPress?: number;
1180
1199
  }
1181
1200
 
1182
1201
  /**
1183
1202
  * A scrub across the columns, and a readout listing every series in the order
1184
1203
  * it stood at the column under the finger.
1185
1204
  */
1186
- function BumpChartTooltip({ color, formatRank, formatX, className }: BumpChartTooltipProps) {
1205
+ function BumpChartTooltip({
1206
+ color,
1207
+ formatRank,
1208
+ formatX,
1209
+ className,
1210
+ activateAfterLongPress = DEFAULT_HOLD,
1211
+ }: BumpChartTooltipProps) {
1187
1212
  const {
1188
1213
  data,
1189
1214
  xDataKey,
@@ -1221,7 +1246,8 @@ function BumpChartTooltip({ color, formatRank, formatX, className }: BumpChartTo
1221
1246
 
1222
1247
  return Gesture.Pan()
1223
1248
  .minDistance(0)
1224
- .onBegin((event) => {
1249
+ .activateAfterLongPress(activateAfterLongPress)
1250
+ .onStart((event) => {
1225
1251
  'worklet';
1226
1252
  resolve(event.x);
1227
1253
  })
@@ -1231,10 +1257,12 @@ function BumpChartTooltip({ color, formatRank, formatX, className }: BumpChartTo
1231
1257
  })
1232
1258
  .onFinalize(() => {
1233
1259
  'worklet';
1260
+ // Fires whether or not the readout ever took the touch.
1261
+ if (activeIndex.value === -1) return;
1234
1262
  activeIndex.value = -1;
1235
1263
  runOnJS(setActiveIndexJS)(-1);
1236
1264
  });
1237
- }, [total, left, width, activeIndex, setActiveIndexJS]);
1265
+ }, [total, left, width, activeIndex, setActiveIndexJS, activateAfterLongPress]);
1238
1266
 
1239
1267
  const crosshairStyle = useAnimatedStyle(() => {
1240
1268
  const index = activeIndex.value;
@@ -11,6 +11,7 @@ import { cn } from '../../utils/cn';
11
11
  import { IconColorProvider } from '../../icons';
12
12
  import { NativeHost, getNativeUI, getSwiftUIModifiers } from '../../native';
13
13
  import { Spinner, type SpinnerProps } from '../spinner';
14
+ import type { ViewRef } from '../../primitives/refs';
14
15
 
15
16
  const buttonVariants = tv({
16
17
  slots: {
@@ -345,7 +346,7 @@ const NATIVE_VARIANT: Record<
345
346
  social: 'outlined',
346
347
  };
347
348
 
348
- export const Button = forwardRef<View, ButtonProps>(
349
+ export const Button = forwardRef<ViewRef, ButtonProps>(
349
350
  (
350
351
  {
351
352
  children,
@@ -59,6 +59,7 @@ import {
59
59
  type ButtonSize,
60
60
  type ButtonVariant,
61
61
  } from '../button';
62
+ import type { ViewRef } from '../../primitives/refs';
62
63
 
63
64
  /** Which way the run reads. */
64
65
  export type ButtonGroupOrientation = 'horizontal' | 'vertical';
@@ -135,7 +136,7 @@ export interface ButtonGroupProps
135
136
  children?: ReactNode;
136
137
  }
137
138
 
138
- const ButtonGroupRoot = forwardRef<View, ButtonGroupProps>(
139
+ const ButtonGroupRoot = forwardRef<ViewRef, ButtonGroupProps>(
139
140
  (
140
141
  {
141
142
  className,
@@ -79,6 +79,7 @@ import {
79
79
  type CalendarSystem,
80
80
  type DateLocale,
81
81
  } from '../../utils/date';
82
+ import type { ScrollViewRef } from '../../primitives/refs';
82
83
 
83
84
  export type CalendarMode = 'single' | 'multiple' | 'range';
84
85
  export type CalendarCaptionLayout = 'label' | 'dropdown';
@@ -769,7 +770,7 @@ function CaptionDropdown({
769
770
  onSelect: (index: number) => void;
770
771
  }) {
771
772
  const [open, setOpen] = useState(false);
772
- const list = useRef<ScrollView>(null);
773
+ const list = useRef<ScrollViewRef>(null);
773
774
  /*
774
775
  * The check is given a colour rather than left to its own fallback, which is
775
776
  * white — right inside a filled control, invisible on this panel.
@@ -1093,6 +1093,15 @@ CandlestickChartYAxis.layer = 'overlay' as Layer;
1093
1093
  // drawn over unreadable too.
1094
1094
  CandlestickChartYAxis.axis = 'y' as const;
1095
1095
 
1096
+ /**
1097
+ * How long the readout waits before claiming the touch, in milliseconds.
1098
+ *
1099
+ * Long enough that a tap reaches a button drawn over the chart and a swipe
1100
+ * scrolls the screen, short enough that a deliberate press does not feel
1101
+ * ignored.
1102
+ */
1103
+ const DEFAULT_HOLD = 180;
1104
+
1096
1105
  export interface CandlestickChartTooltipProps {
1097
1106
  /** Format one of the four prices. Defaults to a compact number. */
1098
1107
  formatValue?: (value: number, field: 'open' | 'high' | 'low' | 'close') => string;
@@ -1101,6 +1110,16 @@ export interface CandlestickChartTooltipProps {
1101
1110
  /** Show the period's change from open to close under the four prices. */
1102
1111
  showChange?: boolean;
1103
1112
  className?: string;
1113
+ /**
1114
+ * How long a press has to be held before the readout takes the touch, in
1115
+ * milliseconds.
1116
+ *
1117
+ * Until then the touch belongs to whatever else wants it: a quick tap still
1118
+ * reaches a button floating over the chart, and a swipe still scrolls the
1119
+ * screen the chart sits in. Set `0` to read on contact, only for a chart with
1120
+ * nothing over it and no scroll view around it.
1121
+ */
1122
+ activateAfterLongPress?: number;
1104
1123
  }
1105
1124
 
1106
1125
  /**
@@ -1118,6 +1137,7 @@ function CandlestickChartTooltip({
1118
1137
  formatX,
1119
1138
  showChange = true,
1120
1139
  className,
1140
+ activateAfterLongPress = DEFAULT_HOLD,
1121
1141
  }: CandlestickChartTooltipProps) {
1122
1142
  const {
1123
1143
  data,
@@ -1156,7 +1176,8 @@ function CandlestickChartTooltip({
1156
1176
 
1157
1177
  return Gesture.Pan()
1158
1178
  .minDistance(0)
1159
- .onBegin((event) => {
1179
+ .activateAfterLongPress(activateAfterLongPress)
1180
+ .onStart((event) => {
1160
1181
  'worklet';
1161
1182
  resolve(event.x);
1162
1183
  })
@@ -1166,10 +1187,12 @@ function CandlestickChartTooltip({
1166
1187
  })
1167
1188
  .onFinalize(() => {
1168
1189
  'worklet';
1190
+ // Fires whether or not the readout ever took the touch.
1191
+ if (activeIndex.value === -1) return;
1169
1192
  activeIndex.value = -1;
1170
1193
  runOnJS(setActiveIndexJS)(-1);
1171
1194
  });
1172
- }, [total, left, width, activeIndex, setActiveIndexJS]);
1195
+ }, [total, left, width, activeIndex, setActiveIndexJS, activateAfterLongPress]);
1173
1196
 
1174
1197
  // The readout centres over its candle and is clamped inside the plot, so it
1175
1198
  // never runs off the edge at the first or last one.
@@ -26,6 +26,7 @@ import { View, type ViewProps } from 'react-native';
26
26
  import { tv, type VariantProps } from 'tailwind-variants';
27
27
  import { cn } from '../../utils/cn';
28
28
  import { Text, type TextProps } from '../../primitives/text';
29
+ import type { TextRef, ViewRef } from '../../primitives/refs';
29
30
 
30
31
  const footerVariants = tv({
31
32
  base: 'flex-row items-center gap-2',
@@ -57,7 +58,7 @@ export interface CardFooterProps
57
58
  extends CardProps,
58
59
  VariantProps<typeof footerVariants> {}
59
60
 
60
- const CardRoot = forwardRef<View, CardProps>(({ className, ...props }, ref) => (
61
+ const CardRoot = forwardRef<ViewRef, CardProps>(({ className, ...props }, ref) => (
61
62
  <View
62
63
  ref={ref}
63
64
  className={cn('rounded-2xl border border-border bg-card shadow-sm', className)}
@@ -66,12 +67,12 @@ const CardRoot = forwardRef<View, CardProps>(({ className, ...props }, ref) => (
66
67
  ));
67
68
  CardRoot.displayName = 'Card';
68
69
 
69
- const CardHeader = forwardRef<View, CardProps>(({ className, ...props }, ref) => (
70
+ const CardHeader = forwardRef<ViewRef, CardProps>(({ className, ...props }, ref) => (
70
71
  <View ref={ref} className={cn('gap-1.5 p-6', className)} {...props} />
71
72
  ));
72
73
  CardHeader.displayName = 'Card.Header';
73
74
 
74
- const CardTitle = forwardRef<React.ElementRef<typeof Text>, TextProps>(
75
+ const CardTitle = forwardRef<TextRef, TextProps>(
75
76
  ({ className, ...props }, ref) => (
76
77
  <Text
77
78
  ref={ref}
@@ -84,19 +85,19 @@ const CardTitle = forwardRef<React.ElementRef<typeof Text>, TextProps>(
84
85
  );
85
86
  CardTitle.displayName = 'Card.Title';
86
87
 
87
- const CardDescription = forwardRef<React.ElementRef<typeof Text>, TextProps>(
88
+ const CardDescription = forwardRef<TextRef, TextProps>(
88
89
  ({ className, ...props }, ref) => (
89
90
  <Text ref={ref} size="sm" muted className={className} {...props} />
90
91
  )
91
92
  );
92
93
  CardDescription.displayName = 'Card.Description';
93
94
 
94
- const CardContent = forwardRef<View, CardProps>(({ className, ...props }, ref) => (
95
+ const CardContent = forwardRef<ViewRef, CardProps>(({ className, ...props }, ref) => (
95
96
  <View ref={ref} className={cn('p-6 pt-0', className)} {...props} />
96
97
  ));
97
98
  CardContent.displayName = 'Card.Content';
98
99
 
99
- const CardFooter = forwardRef<View, CardFooterProps>(
100
+ const CardFooter = forwardRef<ViewRef, CardFooterProps>(
100
101
  ({ className, variant, ...props }, ref) => (
101
102
  <View ref={ref} className={cn(footerVariants({ variant }), className)} {...props} />
102
103
  )