@arshad-shah/cynosure 0.3.0 → 0.5.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 (687) hide show
  1. package/README.md +6 -6
  2. package/dist/_virtual/_rolldown/runtime.js +12 -0
  3. package/dist/adapters/astro/index.d.ts +53 -0
  4. package/dist/adapters/astro/index.js +27 -0
  5. package/dist/adapters/astro/index.js.map +1 -0
  6. package/dist/adapters/vite/index.d.ts +11 -0
  7. package/dist/adapters/vite/index.js +33 -12
  8. package/dist/adapters/vite/index.js.map +1 -1
  9. package/dist/brands/googleplay.d.ts +2 -0
  10. package/dist/brands/googleplay.js +17 -0
  11. package/dist/brands/googleplay.js.map +1 -0
  12. package/dist/brands/index.d.ts +1 -0
  13. package/dist/brands/index.js +132 -130
  14. package/dist/components/Accordion/Accordion.d.ts +1 -1
  15. package/dist/components/Accordion/Accordion.js +26 -26
  16. package/dist/components/Accordion/Accordion.js.map +1 -1
  17. package/dist/components/Announcer/Announcer.d.ts +2 -1
  18. package/dist/components/Announcer/Announcer.js +32 -34
  19. package/dist/components/Announcer/Announcer.js.map +1 -1
  20. package/dist/components/AppShell/AppShell.js +41 -41
  21. package/dist/components/AppShell/AppShell.js.map +1 -1
  22. package/dist/components/Avatar/Avatar.js +20 -20
  23. package/dist/components/Avatar/Avatar.js.map +1 -1
  24. package/dist/components/Badge/Badge.d.ts +19 -5
  25. package/dist/components/Badge/Badge.js +19 -13
  26. package/dist/components/Badge/Badge.js.map +1 -1
  27. package/dist/components/Button/Button.d.ts +30 -6
  28. package/dist/components/Button/Button.js +50 -42
  29. package/dist/components/Button/Button.js.map +1 -1
  30. package/dist/components/Calendar/Calendar.js +158 -161
  31. package/dist/components/Calendar/Calendar.js.map +1 -1
  32. package/dist/components/Calendar/dates.js +42 -38
  33. package/dist/components/Calendar/dates.js.map +1 -1
  34. package/dist/components/Card/Card.d.ts +22 -2
  35. package/dist/components/Card/Card.js +60 -52
  36. package/dist/components/Card/Card.js.map +1 -1
  37. package/dist/components/ChatMessage/ChatMessage.d.ts +55 -0
  38. package/dist/components/ChatMessage/ChatMessage.js +50 -0
  39. package/dist/components/ChatMessage/ChatMessage.js.map +1 -0
  40. package/dist/components/ChatMessage/index.d.ts +1 -0
  41. package/dist/components/Checkbox/Checkbox.d.ts +4 -4
  42. package/dist/components/Checkbox/Checkbox.js +33 -8
  43. package/dist/components/Checkbox/Checkbox.js.map +1 -1
  44. package/dist/components/Checklist/Checklist.js +21 -21
  45. package/dist/components/Checklist/Checklist.js.map +1 -1
  46. package/dist/components/Choice/Choice.d.ts +73 -0
  47. package/dist/components/Choice/Choice.js +41 -0
  48. package/dist/components/Choice/Choice.js.map +1 -0
  49. package/dist/components/Choice/index.d.ts +1 -0
  50. package/dist/components/CodeBlock/CodeBlock.d.ts +6 -1
  51. package/dist/components/CodeBlock/CodeBlock.js +40 -37
  52. package/dist/components/CodeBlock/CodeBlock.js.map +1 -1
  53. package/dist/components/ColorField/ColorField.d.ts +3 -2
  54. package/dist/components/ColorField/ColorField.js +202 -212
  55. package/dist/components/ColorField/ColorField.js.map +1 -1
  56. package/dist/components/ColorField/read-color.js +5 -6
  57. package/dist/components/ColorField/read-color.js.map +1 -1
  58. package/dist/components/ColorSwatches/ColorSwatches.js +42 -33
  59. package/dist/components/ColorSwatches/ColorSwatches.js.map +1 -1
  60. package/dist/components/Combobox/Combobox.d.ts +13 -2
  61. package/dist/components/Combobox/Combobox.js +118 -129
  62. package/dist/components/Combobox/Combobox.js.map +1 -1
  63. package/dist/components/CommandPalette/CommandPalette.d.ts +14 -1
  64. package/dist/components/CommandPalette/CommandPalette.js +153 -109
  65. package/dist/components/CommandPalette/CommandPalette.js.map +1 -1
  66. package/dist/components/CommandPalette/index.d.ts +1 -1
  67. package/dist/components/CompareSlider/CompareSlider.js +14 -14
  68. package/dist/components/CompareSlider/CompareSlider.js.map +1 -1
  69. package/dist/components/Container/Container.d.ts +2 -2
  70. package/dist/components/Container/Container.js +17 -13
  71. package/dist/components/Container/Container.js.map +1 -1
  72. package/dist/components/ContextMenu/ContextMenu.d.ts +27 -13
  73. package/dist/components/ContextMenu/ContextMenu.js +64 -46
  74. package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
  75. package/dist/components/CopyButton/CopyButton.js +41 -41
  76. package/dist/components/CopyButton/CopyButton.js.map +1 -1
  77. package/dist/components/DataGrid/DataGrid.d.ts +135 -0
  78. package/dist/components/DataGrid/DataGrid.js +385 -0
  79. package/dist/components/DataGrid/DataGrid.js.map +1 -0
  80. package/dist/components/DataGrid/index.d.ts +1 -0
  81. package/dist/components/DateField/DateField.d.ts +4 -3
  82. package/dist/components/DateField/DateField.js +70 -59
  83. package/dist/components/DateField/DateField.js.map +1 -1
  84. package/dist/components/DeviceFrame/DeviceFrame.d.ts +63 -0
  85. package/dist/components/DeviceFrame/DeviceFrame.js +54 -0
  86. package/dist/components/DeviceFrame/DeviceFrame.js.map +1 -0
  87. package/dist/components/DeviceFrame/index.d.ts +1 -0
  88. package/dist/components/Dialog/Dialog.d.ts +10 -1
  89. package/dist/components/Dialog/Dialog.js +82 -81
  90. package/dist/components/Dialog/Dialog.js.map +1 -1
  91. package/dist/components/Disclosure/Disclosure.d.ts +15 -1
  92. package/dist/components/Disclosure/Disclosure.js +37 -30
  93. package/dist/components/Disclosure/Disclosure.js.map +1 -1
  94. package/dist/components/DocumentViewport/DocumentViewport.js +54 -57
  95. package/dist/components/DocumentViewport/DocumentViewport.js.map +1 -1
  96. package/dist/components/EmptyState/EmptyState.d.ts +5 -2
  97. package/dist/components/EmptyState/EmptyState.js.map +1 -1
  98. package/dist/components/ErrorBoundary/ErrorBoundary.d.ts +59 -0
  99. package/dist/components/ErrorBoundary/ErrorBoundary.js +53 -0
  100. package/dist/components/ErrorBoundary/ErrorBoundary.js.map +1 -0
  101. package/dist/components/ErrorBoundary/index.d.ts +1 -0
  102. package/dist/components/Field/Field.d.ts +38 -5
  103. package/dist/components/Field/Field.js +48 -42
  104. package/dist/components/Field/Field.js.map +1 -1
  105. package/dist/components/Field/index.d.ts +1 -1
  106. package/dist/components/FileDrop/FileDrop.d.ts +26 -1
  107. package/dist/components/FileDrop/FileDrop.js +150 -99
  108. package/dist/components/FileDrop/FileDrop.js.map +1 -1
  109. package/dist/components/FloatingToolbar/FloatingToolbar.js +80 -77
  110. package/dist/components/FloatingToolbar/FloatingToolbar.js.map +1 -1
  111. package/dist/components/Grid/Grid.d.ts +32 -11
  112. package/dist/components/Grid/Grid.js +78 -48
  113. package/dist/components/Grid/Grid.js.map +1 -1
  114. package/dist/components/Grid/index.d.ts +1 -1
  115. package/dist/components/Heading/Heading.d.ts +4 -2
  116. package/dist/components/Heading/Heading.js.map +1 -1
  117. package/dist/components/HighlightedText/HighlightedText.d.ts +40 -0
  118. package/dist/components/HighlightedText/HighlightedText.js +36 -0
  119. package/dist/components/HighlightedText/HighlightedText.js.map +1 -0
  120. package/dist/components/HighlightedText/index.d.ts +2 -0
  121. package/dist/components/HotkeyField/HotkeyField.d.ts +84 -0
  122. package/dist/components/HotkeyField/HotkeyField.js +161 -0
  123. package/dist/components/HotkeyField/HotkeyField.js.map +1 -0
  124. package/dist/components/HotkeyField/index.d.ts +1 -0
  125. package/dist/components/HoverCard/HoverCard.js +6 -6
  126. package/dist/components/HoverCard/HoverCard.js.map +1 -1
  127. package/dist/components/IconButton/IconButton.d.ts +16 -1
  128. package/dist/components/IconButton/IconButton.js +20 -15
  129. package/dist/components/IconButton/IconButton.js.map +1 -1
  130. package/dist/components/IconTile/IconTile.d.ts +45 -0
  131. package/dist/components/IconTile/IconTile.js +25 -0
  132. package/dist/components/IconTile/IconTile.js.map +1 -0
  133. package/dist/components/IconTile/index.d.ts +1 -0
  134. package/dist/components/Image/Image.js.map +1 -1
  135. package/dist/components/Inline/Inline.d.ts +3 -3
  136. package/dist/components/Inline/Inline.js +12 -22
  137. package/dist/components/Inline/Inline.js.map +1 -1
  138. package/dist/components/Kbd/Kbd.d.ts +0 -2
  139. package/dist/components/Kbd/Kbd.js +16 -22
  140. package/dist/components/Kbd/Kbd.js.map +1 -1
  141. package/dist/components/KeyValueEditor/KeyValueEditor.js +37 -36
  142. package/dist/components/KeyValueEditor/KeyValueEditor.js.map +1 -1
  143. package/dist/components/KeyValueEditor/bulk.js +3 -4
  144. package/dist/components/KeyValueEditor/bulk.js.map +1 -1
  145. package/dist/components/Link/Link.d.ts +9 -1
  146. package/dist/components/Link/Link.js +20 -18
  147. package/dist/components/Link/Link.js.map +1 -1
  148. package/dist/components/List/List.d.ts +73 -0
  149. package/dist/components/List/List.js +64 -0
  150. package/dist/components/List/List.js.map +1 -0
  151. package/dist/components/List/index.d.ts +1 -0
  152. package/dist/components/ListRow/ListRow.d.ts +105 -0
  153. package/dist/components/ListRow/ListRow.js +164 -0
  154. package/dist/components/ListRow/ListRow.js.map +1 -0
  155. package/dist/components/ListRow/index.d.ts +1 -0
  156. package/dist/components/LoadingDots/LoadingDots.d.ts +7 -2
  157. package/dist/components/LoadingDots/LoadingDots.js +28 -18
  158. package/dist/components/LoadingDots/LoadingDots.js.map +1 -1
  159. package/dist/components/Menu/Menu.d.ts +29 -11
  160. package/dist/components/Menu/Menu.js +204 -111
  161. package/dist/components/Menu/Menu.js.map +1 -1
  162. package/dist/components/Menubar/Menubar.d.ts +40 -0
  163. package/dist/components/Menubar/Menubar.js +82 -0
  164. package/dist/components/Menubar/Menubar.js.map +1 -0
  165. package/dist/components/Menubar/index.d.ts +1 -0
  166. package/dist/components/Notice/Notice.d.ts +11 -2
  167. package/dist/components/Notice/Notice.js +31 -27
  168. package/dist/components/Notice/Notice.js.map +1 -1
  169. package/dist/components/NumberField/NumberField.d.ts +8 -3
  170. package/dist/components/NumberField/NumberField.js +151 -100
  171. package/dist/components/NumberField/NumberField.js.map +1 -1
  172. package/dist/components/OptionList/OptionList.d.ts +102 -0
  173. package/dist/components/OptionList/OptionList.js +98 -0
  174. package/dist/components/OptionList/OptionList.js.map +1 -0
  175. package/dist/components/OptionList/index.d.ts +1 -0
  176. package/dist/components/OverlayFrame/OverlayFrame.d.ts +33 -0
  177. package/dist/components/OverlayFrame/OverlayFrame.js +20 -0
  178. package/dist/components/OverlayFrame/OverlayFrame.js.map +1 -0
  179. package/dist/components/OverlayFrame/index.d.ts +1 -0
  180. package/dist/components/PageHeader/PageHeader.d.ts +6 -0
  181. package/dist/components/PageHeader/PageHeader.js +27 -27
  182. package/dist/components/PageHeader/PageHeader.js.map +1 -1
  183. package/dist/components/Pagination/Pagination.js +31 -30
  184. package/dist/components/Pagination/Pagination.js.map +1 -1
  185. package/dist/components/PanZoomCanvas/PanZoomCanvas.d.ts +71 -4
  186. package/dist/components/PanZoomCanvas/PanZoomCanvas.js +197 -141
  187. package/dist/components/PanZoomCanvas/PanZoomCanvas.js.map +1 -1
  188. package/dist/components/PanZoomCanvas/index.d.ts +1 -1
  189. package/dist/components/PathField/PathField.d.ts +68 -0
  190. package/dist/components/PathField/PathField.js +67 -0
  191. package/dist/components/PathField/PathField.js.map +1 -0
  192. package/dist/components/PathField/index.d.ts +1 -0
  193. package/dist/components/Popover/Popover.d.ts +16 -3
  194. package/dist/components/Popover/Popover.js +51 -42
  195. package/dist/components/Popover/Popover.js.map +1 -1
  196. package/dist/components/ProgressBar/ProgressBar.d.ts +4 -3
  197. package/dist/components/ProgressBar/ProgressBar.js.map +1 -1
  198. package/dist/components/QRCode/QRCode.d.ts +56 -0
  199. package/dist/components/QRCode/QRCode.js +48 -0
  200. package/dist/components/QRCode/QRCode.js.map +1 -0
  201. package/dist/components/QRCode/index.d.ts +1 -0
  202. package/dist/components/RadioGroup/RadioGroup.js +32 -24
  203. package/dist/components/RadioGroup/RadioGroup.js.map +1 -1
  204. package/dist/components/RowActions/RowActions.d.ts +35 -0
  205. package/dist/components/RowActions/RowActions.js +38 -0
  206. package/dist/components/RowActions/RowActions.js.map +1 -0
  207. package/dist/components/RowActions/index.d.ts +1 -0
  208. package/dist/components/ScrollArea/ScrollArea.d.ts +55 -0
  209. package/dist/components/ScrollArea/ScrollArea.js +55 -0
  210. package/dist/components/ScrollArea/ScrollArea.js.map +1 -0
  211. package/dist/components/ScrollArea/index.d.ts +1 -0
  212. package/dist/components/SearchField/SearchField.d.ts +17 -0
  213. package/dist/components/SearchField/SearchField.js +31 -17
  214. package/dist/components/SearchField/SearchField.js.map +1 -1
  215. package/dist/components/SearchField/index.d.ts +1 -1
  216. package/dist/components/Section/Section.d.ts +57 -0
  217. package/dist/components/Section/Section.js +27 -0
  218. package/dist/components/Section/Section.js.map +1 -0
  219. package/dist/components/Section/index.d.ts +1 -0
  220. package/dist/components/SegmentedControl/SegmentedControl.d.ts +6 -3
  221. package/dist/components/SegmentedControl/SegmentedControl.js +24 -20
  222. package/dist/components/SegmentedControl/SegmentedControl.js.map +1 -1
  223. package/dist/components/Select/Select.d.ts +22 -6
  224. package/dist/components/Select/Select.js +155 -156
  225. package/dist/components/Select/Select.js.map +1 -1
  226. package/dist/components/SelectionFrame/frame-math.js +19 -20
  227. package/dist/components/SelectionFrame/frame-math.js.map +1 -1
  228. package/dist/components/Sheet/Sheet.js +12 -7
  229. package/dist/components/Sheet/Sheet.js.map +1 -1
  230. package/dist/components/SideNav/SideNav.d.ts +13 -1
  231. package/dist/components/SideNav/SideNav.js +100 -91
  232. package/dist/components/SideNav/SideNav.js.map +1 -1
  233. package/dist/components/SignaturePad/SignaturePad.js +63 -62
  234. package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
  235. package/dist/components/SignaturePad/ink.js +0 -1
  236. package/dist/components/SignaturePad/ink.js.map +1 -1
  237. package/dist/components/SiteFooter/SiteFooter.d.ts +66 -0
  238. package/dist/components/SiteFooter/SiteFooter.js +80 -0
  239. package/dist/components/SiteFooter/SiteFooter.js.map +1 -0
  240. package/dist/components/SiteFooter/index.d.ts +1 -0
  241. package/dist/components/SiteHeader/SiteHeader.d.ts +78 -0
  242. package/dist/components/SiteHeader/SiteHeader.js +114 -0
  243. package/dist/components/SiteHeader/SiteHeader.js.map +1 -0
  244. package/dist/components/SiteHeader/index.d.ts +1 -0
  245. package/dist/components/SkipLink/SkipLink.d.ts +42 -0
  246. package/dist/components/SkipLink/SkipLink.js +43 -0
  247. package/dist/components/SkipLink/SkipLink.js.map +1 -0
  248. package/dist/components/SkipLink/index.d.ts +1 -0
  249. package/dist/components/Slider/Slider.js +88 -91
  250. package/dist/components/Slider/Slider.js.map +1 -1
  251. package/dist/components/SortButton/SortButton.d.ts +36 -0
  252. package/dist/components/SortButton/SortButton.js +35 -0
  253. package/dist/components/SortButton/SortButton.js.map +1 -0
  254. package/dist/components/SortButton/index.d.ts +1 -0
  255. package/dist/components/SortableList/SortableList.js +146 -120
  256. package/dist/components/SortableList/SortableList.js.map +1 -1
  257. package/dist/components/SplitPane/SplitPane.d.ts +32 -12
  258. package/dist/components/SplitPane/SplitPane.js +105 -59
  259. package/dist/components/SplitPane/SplitPane.js.map +1 -1
  260. package/dist/components/Stack/Stack.d.ts +16 -7
  261. package/dist/components/Stack/Stack.js +32 -18
  262. package/dist/components/Stack/Stack.js.map +1 -1
  263. package/dist/components/Stack/index.d.ts +1 -1
  264. package/dist/components/Stat/Stat.d.ts +88 -0
  265. package/dist/components/Stat/Stat.js +105 -0
  266. package/dist/components/Stat/Stat.js.map +1 -0
  267. package/dist/components/Stat/index.d.ts +1 -0
  268. package/dist/components/StatusBar/StatusBar.d.ts +95 -0
  269. package/dist/components/StatusBar/StatusBar.js +110 -0
  270. package/dist/components/StatusBar/StatusBar.js.map +1 -0
  271. package/dist/components/StatusBar/index.d.ts +1 -0
  272. package/dist/components/Steps/Steps.d.ts +10 -4
  273. package/dist/components/Steps/Steps.js +31 -30
  274. package/dist/components/Steps/Steps.js.map +1 -1
  275. package/dist/components/Switch/Switch.d.ts +4 -4
  276. package/dist/components/Switch/Switch.js +18 -7
  277. package/dist/components/Switch/Switch.js.map +1 -1
  278. package/dist/components/Table/Table.d.ts +6 -6
  279. package/dist/components/Table/Table.js +73 -102
  280. package/dist/components/Table/Table.js.map +1 -1
  281. package/dist/components/Tabs/Tabs.d.ts +55 -6
  282. package/dist/components/Tabs/Tabs.js +288 -169
  283. package/dist/components/Tabs/Tabs.js.map +1 -1
  284. package/dist/components/TagInput/TagInput.d.ts +10 -2
  285. package/dist/components/TagInput/TagInput.js +137 -148
  286. package/dist/components/TagInput/TagInput.js.map +1 -1
  287. package/dist/components/Text/Text.d.ts +6 -0
  288. package/dist/components/Text/Text.js +18 -17
  289. package/dist/components/Text/Text.js.map +1 -1
  290. package/dist/components/TextArea/TextArea.d.ts +37 -6
  291. package/dist/components/TextArea/TextArea.js +200 -72
  292. package/dist/components/TextArea/TextArea.js.map +1 -1
  293. package/dist/components/TextArea/index.d.ts +1 -1
  294. package/dist/components/TextField/TextField.d.ts +22 -6
  295. package/dist/components/TextField/TextField.js +59 -53
  296. package/dist/components/TextField/TextField.js.map +1 -1
  297. package/dist/components/ThemeToggle/ThemeToggle.d.ts +7 -1
  298. package/dist/components/ThemeToggle/ThemeToggle.js +33 -30
  299. package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
  300. package/dist/components/TimeField/TimeField.d.ts +4 -3
  301. package/dist/components/TimeField/TimeField.js +197 -183
  302. package/dist/components/TimeField/TimeField.js.map +1 -1
  303. package/dist/components/TitleBar/TitleBar.d.ts +91 -0
  304. package/dist/components/TitleBar/TitleBar.js +80 -0
  305. package/dist/components/TitleBar/TitleBar.js.map +1 -0
  306. package/dist/components/TitleBar/index.d.ts +1 -0
  307. package/dist/components/Toast/Toast.d.ts +17 -2
  308. package/dist/components/Toast/Toast.js +166 -147
  309. package/dist/components/Toast/Toast.js.map +1 -1
  310. package/dist/components/Toast/index.d.ts +1 -1
  311. package/dist/components/Toolbar/Toolbar.js +11 -12
  312. package/dist/components/Toolbar/Toolbar.js.map +1 -1
  313. package/dist/components/Tooltip/Tooltip.d.ts +23 -1
  314. package/dist/components/Tooltip/Tooltip.js +50 -31
  315. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  316. package/dist/components/Tree/Tree.d.ts +92 -11
  317. package/dist/components/Tree/Tree.js +332 -164
  318. package/dist/components/Tree/Tree.js.map +1 -1
  319. package/dist/components/VirtualList/VirtualList.d.ts +27 -4
  320. package/dist/components/VirtualList/VirtualList.js +179 -145
  321. package/dist/components/VirtualList/VirtualList.js.map +1 -1
  322. package/dist/components/VirtualList/index.d.ts +1 -1
  323. package/dist/components/VisuallyHidden/VisuallyHidden.d.ts +24 -0
  324. package/dist/components/VisuallyHidden/VisuallyHidden.js +17 -0
  325. package/dist/components/VisuallyHidden/VisuallyHidden.js.map +1 -0
  326. package/dist/components/VisuallyHidden/index.d.ts +1 -0
  327. package/dist/components/ZoomControls/ZoomControls.d.ts +6 -2
  328. package/dist/components/ZoomControls/ZoomControls.js +37 -37
  329. package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
  330. package/dist/entries/tokens.js +22 -16
  331. package/dist/foundations/ChoiceBase/ChoiceBase.js +15 -13
  332. package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
  333. package/dist/foundations/HiddenValue/HiddenValue.js +5 -5
  334. package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
  335. package/dist/foundations/Icon/Icon.d.ts +6 -1
  336. package/dist/foundations/Icon/Icon.js +15 -14
  337. package/dist/foundations/Icon/Icon.js.map +1 -1
  338. package/dist/foundations/LiveRegion/LiveRegion.d.ts +33 -0
  339. package/dist/foundations/LiveRegion/LiveRegion.js +29 -0
  340. package/dist/foundations/LiveRegion/LiveRegion.js.map +1 -0
  341. package/dist/foundations/LiveRegion/index.d.ts +1 -0
  342. package/dist/foundations/canvas-size.d.ts +14 -0
  343. package/dist/foundations/canvas-size.js +32 -0
  344. package/dist/foundations/canvas-size.js.map +1 -0
  345. package/dist/foundations/dir.js +0 -1
  346. package/dist/foundations/dir.js.map +1 -1
  347. package/dist/foundations/draft.d.ts +14 -0
  348. package/dist/foundations/draft.js +22 -0
  349. package/dist/foundations/draft.js.map +1 -0
  350. package/dist/foundations/edge.d.ts +20 -0
  351. package/dist/foundations/edge.js +26 -0
  352. package/dist/foundations/edge.js.map +1 -0
  353. package/dist/foundations/focus.d.ts +5 -0
  354. package/dist/foundations/focus.js +10 -0
  355. package/dist/foundations/focus.js.map +1 -0
  356. package/dist/foundations/hotkey.d.ts +23 -1
  357. package/dist/foundations/hotkey.js +48 -26
  358. package/dist/foundations/hotkey.js.map +1 -1
  359. package/dist/foundations/icon-size.d.ts +7 -0
  360. package/dist/foundations/icon-size.js +6 -0
  361. package/dist/foundations/icon-size.js.map +1 -0
  362. package/dist/foundations/image-outcome.d.ts +8 -3
  363. package/dist/foundations/image-outcome.js +12 -8
  364. package/dist/foundations/image-outcome.js.map +1 -1
  365. package/dist/foundations/keys.js +12 -13
  366. package/dist/foundations/keys.js.map +1 -1
  367. package/dist/foundations/layout.d.ts +81 -0
  368. package/dist/foundations/layout.js +29 -0
  369. package/dist/foundations/layout.js.map +1 -0
  370. package/dist/foundations/listbox.d.ts +47 -2
  371. package/dist/foundations/listbox.js +56 -25
  372. package/dist/foundations/listbox.js.map +1 -1
  373. package/dist/foundations/math.d.ts +25 -0
  374. package/dist/foundations/math.js +14 -3
  375. package/dist/foundations/math.js.map +1 -1
  376. package/dist/foundations/media-query.d.ts +5 -0
  377. package/dist/foundations/media-query.js +14 -0
  378. package/dist/foundations/media-query.js.map +1 -0
  379. package/dist/foundations/motion.d.ts +12 -0
  380. package/dist/foundations/motion.js +21 -0
  381. package/dist/foundations/motion.js.map +1 -0
  382. package/dist/foundations/option-icon.d.ts +3 -1
  383. package/dist/foundations/option-icon.js +6 -6
  384. package/dist/foundations/option-icon.js.map +1 -1
  385. package/dist/foundations/printing.d.ts +6 -0
  386. package/dist/foundations/printing.js +17 -0
  387. package/dist/foundations/printing.js.map +1 -0
  388. package/dist/foundations/qr.d.ts +42 -0
  389. package/dist/foundations/qr.js +245 -0
  390. package/dist/foundations/qr.js.map +1 -0
  391. package/dist/foundations/refs.d.ts +8 -0
  392. package/dist/foundations/refs.js +14 -0
  393. package/dist/foundations/refs.js.map +1 -0
  394. package/dist/foundations/reorder.js +5 -6
  395. package/dist/foundations/reorder.js.map +1 -1
  396. package/dist/foundations/roving-focus.d.ts +10 -0
  397. package/dist/foundations/roving-focus.js +34 -31
  398. package/dist/foundations/roving-focus.js.map +1 -1
  399. package/dist/foundations/scroll-align.d.ts +11 -0
  400. package/dist/foundations/scroll-align.js +8 -0
  401. package/dist/foundations/scroll-align.js.map +1 -0
  402. package/dist/foundations/sort.d.ts +13 -0
  403. package/dist/foundations/sort.js +26 -0
  404. package/dist/foundations/sort.js.map +1 -0
  405. package/dist/foundations/text-match.d.ts +11 -0
  406. package/dist/foundations/text-match.js +20 -0
  407. package/dist/foundations/text-match.js.map +1 -0
  408. package/dist/foundations/tone-icons.js +4 -5
  409. package/dist/foundations/tone-icons.js.map +1 -1
  410. package/dist/foundations/use-follow.d.ts +29 -0
  411. package/dist/foundations/use-follow.js +51 -0
  412. package/dist/foundations/use-follow.js.map +1 -0
  413. package/dist/foundations/virtual-window.d.ts +22 -5
  414. package/dist/foundations/virtual-window.js +58 -54
  415. package/dist/foundations/virtual-window.js.map +1 -1
  416. package/dist/foundations/zoom-gestures.d.ts +23 -1
  417. package/dist/foundations/zoom-gestures.js +123 -84
  418. package/dist/foundations/zoom-gestures.js.map +1 -1
  419. package/dist/foundations/zoom.d.ts +10 -4
  420. package/dist/foundations/zoom.js +16 -17
  421. package/dist/foundations/zoom.js.map +1 -1
  422. package/dist/icons/book-marked.d.ts +2 -0
  423. package/dist/icons/book-marked.js +14 -0
  424. package/dist/icons/book-marked.js.map +1 -0
  425. package/dist/icons/boxes.d.ts +2 -0
  426. package/dist/icons/boxes.js +34 -0
  427. package/dist/icons/boxes.js.map +1 -0
  428. package/dist/icons/by-name.d.ts +11 -0
  429. package/dist/icons/by-name.js +11 -0
  430. package/dist/icons/by-name.js.map +1 -0
  431. package/dist/icons/cable.d.ts +2 -0
  432. package/dist/icons/cable.js +14 -0
  433. package/dist/icons/cable.js.map +1 -0
  434. package/dist/icons/calendar-days.d.ts +2 -0
  435. package/dist/icons/calendar-days.js +24 -0
  436. package/dist/icons/calendar-days.js.map +1 -0
  437. package/dist/icons/check-check.d.ts +2 -0
  438. package/dist/icons/check-check.js +17 -0
  439. package/dist/icons/check-check.js.map +1 -0
  440. package/dist/icons/check-square.d.ts +2 -0
  441. package/dist/icons/check-square.js +14 -0
  442. package/dist/icons/check-square.js.map +1 -0
  443. package/dist/icons/clipboard-paste.d.ts +2 -0
  444. package/dist/icons/clipboard-paste.js +30 -0
  445. package/dist/icons/clipboard-paste.js.map +1 -0
  446. package/dist/icons/crescent.d.ts +2 -0
  447. package/dist/icons/crescent.js +14 -0
  448. package/dist/icons/crescent.js.map +1 -0
  449. package/dist/icons/facet.d.ts +274 -0
  450. package/dist/icons/facet.js +830 -0
  451. package/dist/icons/facet.js.map +1 -0
  452. package/dist/icons/file-plus.d.ts +2 -0
  453. package/dist/icons/file-plus.js +14 -0
  454. package/dist/icons/file-plus.js.map +1 -0
  455. package/dist/icons/file-question.d.ts +2 -0
  456. package/dist/icons/file-question.js +14 -0
  457. package/dist/icons/file-question.js.map +1 -0
  458. package/dist/icons/file-search.d.ts +2 -0
  459. package/dist/icons/file-search.js +24 -0
  460. package/dist/icons/file-search.js.map +1 -0
  461. package/dist/icons/function.d.ts +2 -0
  462. package/dist/icons/function.js +20 -0
  463. package/dist/icons/function.js.map +1 -0
  464. package/dist/icons/gauge.d.ts +2 -0
  465. package/dist/icons/gauge.js +14 -0
  466. package/dist/icons/gauge.js.map +1 -0
  467. package/dist/icons/hourglass.d.ts +2 -0
  468. package/dist/icons/hourglass.js +14 -0
  469. package/dist/icons/hourglass.js.map +1 -0
  470. package/dist/icons/index.d.ts +1 -240
  471. package/dist/icons/index.js +546 -478
  472. package/dist/icons/kaaba.d.ts +2 -0
  473. package/dist/icons/kaaba.js +14 -0
  474. package/dist/icons/kaaba.js.map +1 -0
  475. package/dist/icons/keywords.d.ts +35 -1
  476. package/dist/icons/keywords.js +274 -1
  477. package/dist/icons/keywords.js.map +1 -1
  478. package/dist/icons/languages.d.ts +2 -0
  479. package/dist/icons/languages.js +14 -0
  480. package/dist/icons/languages.js.map +1 -0
  481. package/dist/icons/list-tree.d.ts +2 -0
  482. package/dist/icons/list-tree.js +14 -0
  483. package/dist/icons/list-tree.js.map +1 -0
  484. package/dist/icons/loader.d.ts +2 -0
  485. package/dist/icons/loader.js +14 -0
  486. package/dist/icons/loader.js.map +1 -0
  487. package/dist/icons/monitor-down.d.ts +2 -0
  488. package/dist/icons/monitor-down.js +24 -0
  489. package/dist/icons/monitor-down.js.map +1 -0
  490. package/dist/icons/mosque.d.ts +2 -0
  491. package/dist/icons/mosque.js +14 -0
  492. package/dist/icons/mosque.js.map +1 -0
  493. package/dist/icons/panel-right.d.ts +2 -0
  494. package/dist/icons/panel-right.js +20 -0
  495. package/dist/icons/panel-right.js.map +1 -0
  496. package/dist/icons/party-popper.d.ts +2 -0
  497. package/dist/icons/party-popper.js +14 -0
  498. package/dist/icons/party-popper.js.map +1 -0
  499. package/dist/icons/power-off.d.ts +2 -0
  500. package/dist/icons/power-off.js +14 -0
  501. package/dist/icons/power-off.js.map +1 -0
  502. package/dist/icons/prayer-beads.d.ts +2 -0
  503. package/dist/icons/prayer-beads.js +67 -0
  504. package/dist/icons/prayer-beads.js.map +1 -0
  505. package/dist/icons/qr-code.d.ts +2 -0
  506. package/dist/icons/qr-code.js +38 -0
  507. package/dist/icons/qr-code.js.map +1 -0
  508. package/dist/icons/refresh-cw.d.ts +2 -0
  509. package/dist/icons/refresh-cw.js +14 -0
  510. package/dist/icons/refresh-cw.js.map +1 -0
  511. package/dist/icons/rocket.d.ts +2 -0
  512. package/dist/icons/rocket.js +21 -0
  513. package/dist/icons/rocket.js.map +1 -0
  514. package/dist/icons/rows.d.ts +2 -0
  515. package/dist/icons/rows.js +20 -0
  516. package/dist/icons/rows.js.map +1 -0
  517. package/dist/icons/scissors.d.ts +2 -0
  518. package/dist/icons/scissors.js +26 -0
  519. package/dist/icons/scissors.js.map +1 -0
  520. package/dist/icons/shield-question.d.ts +2 -0
  521. package/dist/icons/shield-question.js +14 -0
  522. package/dist/icons/shield-question.js.map +1 -0
  523. package/dist/icons/square-plus.d.ts +2 -0
  524. package/dist/icons/square-plus.js +20 -0
  525. package/dist/icons/square-plus.js.map +1 -0
  526. package/dist/icons/text-select.d.ts +2 -0
  527. package/dist/icons/text-select.js +14 -0
  528. package/dist/icons/text-select.js.map +1 -0
  529. package/dist/icons/types.d.ts +1 -1
  530. package/dist/icons/types.js +2 -1
  531. package/dist/icons/types.js.map +1 -1
  532. package/dist/icons/window-maximize.d.ts +2 -0
  533. package/dist/icons/window-maximize.js +14 -0
  534. package/dist/icons/window-maximize.js.map +1 -0
  535. package/dist/icons/window-restore.d.ts +2 -0
  536. package/dist/icons/window-restore.js +20 -0
  537. package/dist/icons/window-restore.js.map +1 -0
  538. package/dist/index.d.ts +38 -9
  539. package/dist/index.js +326 -249
  540. package/dist/overlay/dismiss.js +15 -13
  541. package/dist/overlay/dismiss.js.map +1 -1
  542. package/dist/overlay/floating.d.ts +7 -2
  543. package/dist/overlay/floating.js +29 -21
  544. package/dist/overlay/floating.js.map +1 -1
  545. package/dist/overlay/listbox-layer.d.ts +3 -2
  546. package/dist/overlay/listbox-layer.js.map +1 -1
  547. package/dist/overlay/position.d.ts +5 -2
  548. package/dist/overlay/position.js +19 -19
  549. package/dist/overlay/position.js.map +1 -1
  550. package/dist/overlay/toast-host.js +3 -2
  551. package/dist/overlay/toast-host.js.map +1 -1
  552. package/dist/overlay/use-anchored-position.d.ts +2 -2
  553. package/dist/overlay/use-anchored-position.js +25 -25
  554. package/dist/overlay/use-anchored-position.js.map +1 -1
  555. package/dist/styles/announcer.css +1 -1
  556. package/dist/styles/app-shell.css +1 -1
  557. package/dist/styles/avatar.css +1 -1
  558. package/dist/styles/badge.css +1 -1
  559. package/dist/styles/base.css +1 -1
  560. package/dist/styles/button.css +1 -1
  561. package/dist/styles/calendar.css +1 -1
  562. package/dist/styles/card.css +1 -1
  563. package/dist/styles/chat-message.css +1 -0
  564. package/dist/styles/checkbox.css +1 -1
  565. package/dist/styles/choice-base.css +1 -0
  566. package/dist/styles/choice.css +1 -1
  567. package/dist/styles/code-block.css +1 -1
  568. package/dist/styles/color-field.css +1 -1
  569. package/dist/styles/combobox.css +1 -1
  570. package/dist/styles/command-palette.css +1 -1
  571. package/dist/styles/copy-button.css +1 -1
  572. package/dist/styles/data-grid.css +1 -0
  573. package/dist/styles/date-field.css +1 -1
  574. package/dist/styles/device-frame.css +1 -0
  575. package/dist/styles/dialog.css +1 -1
  576. package/dist/styles/disclosure.css +1 -1
  577. package/dist/styles/error-boundary.css +1 -0
  578. package/dist/styles/field.css +1 -1
  579. package/dist/styles/file-drop.css +1 -1
  580. package/dist/styles/floating-toolbar.css +1 -1
  581. package/dist/styles/generated-css.d.ts +1 -1
  582. package/dist/styles/generated-css.js +3 -3
  583. package/dist/styles/generated-css.js.map +1 -1
  584. package/dist/styles/grid.css +1 -1
  585. package/dist/styles/heading.css +1 -1
  586. package/dist/styles/highlighted-text.css +1 -0
  587. package/dist/styles/hotkey-field.css +1 -0
  588. package/dist/styles/icon-tile.css +1 -0
  589. package/dist/styles/icon.css +1 -1
  590. package/dist/styles/inline.css +1 -0
  591. package/dist/styles/key-value-editor.css +1 -1
  592. package/dist/styles/link.css +1 -1
  593. package/dist/styles/list-row.css +1 -0
  594. package/dist/styles/list.css +1 -0
  595. package/dist/styles/loading-dots.css +1 -1
  596. package/dist/styles/manifest.json +852 -0
  597. package/dist/styles/menu.css +1 -1
  598. package/dist/styles/menubar.css +1 -0
  599. package/dist/styles/notice.css +1 -1
  600. package/dist/styles/number-field.css +1 -1
  601. package/dist/styles/option-list.css +1 -0
  602. package/dist/styles/overlay-frame.css +1 -0
  603. package/dist/styles/pagination.css +1 -1
  604. package/dist/styles/pan-zoom-canvas.css +1 -1
  605. package/dist/styles/path-field.css +1 -0
  606. package/dist/styles/popover.css +1 -1
  607. package/dist/styles/progress-bar.css +1 -1
  608. package/dist/styles/qr-code.css +1 -0
  609. package/dist/styles/radio-group.css +1 -1
  610. package/dist/styles/row-actions.css +1 -0
  611. package/dist/styles/scroll-area.css +1 -0
  612. package/dist/styles/search-field.css +1 -1
  613. package/dist/styles/section.css +1 -0
  614. package/dist/styles/segmented-control.css +1 -1
  615. package/dist/styles/select.css +1 -1
  616. package/dist/styles/sheet.css +1 -1
  617. package/dist/styles/side-nav.css +1 -1
  618. package/dist/styles/site-footer.css +1 -0
  619. package/dist/styles/site-header.css +1 -0
  620. package/dist/styles/skip-link.css +1 -0
  621. package/dist/styles/sort-button.css +1 -0
  622. package/dist/styles/sortable-list.css +1 -1
  623. package/dist/styles/split-pane.css +1 -1
  624. package/dist/styles/stack.css +1 -1
  625. package/dist/styles/stat.css +1 -0
  626. package/dist/styles/status-bar.css +1 -0
  627. package/dist/styles/steps.css +1 -1
  628. package/dist/styles/switch.css +1 -0
  629. package/dist/styles/table.css +1 -1
  630. package/dist/styles/tabs.css +1 -1
  631. package/dist/styles/tag-input.css +1 -1
  632. package/dist/styles/text-area.css +1 -1
  633. package/dist/styles/text-field.css +1 -1
  634. package/dist/styles/text.css +1 -1
  635. package/dist/styles/time-field.css +1 -1
  636. package/dist/styles/title-bar.css +1 -0
  637. package/dist/styles/toast.css +1 -1
  638. package/dist/styles/tokens.css +3 -3
  639. package/dist/styles/tree.css +1 -1
  640. package/dist/styles/virtual-list.css +1 -1
  641. package/dist/styles/visually-hidden.css +1 -0
  642. package/dist/styles.css +3 -3
  643. package/dist/theme/CynosureTheme.d.ts +7 -3
  644. package/dist/theme/CynosureTheme.js +47 -31
  645. package/dist/theme/CynosureTheme.js.map +1 -1
  646. package/dist/theme/index.d.ts +1 -0
  647. package/dist/theme/theme-context.d.ts +9 -0
  648. package/dist/theme/theme-context.js +8 -0
  649. package/dist/theme/theme-context.js.map +1 -0
  650. package/dist/theme/theme-init-script.js +0 -1
  651. package/dist/theme/theme-init-script.js.map +1 -1
  652. package/dist/theme/use-color-mode.d.ts +3 -2
  653. package/dist/theme/use-color-mode.js +35 -38
  654. package/dist/theme/use-color-mode.js.map +1 -1
  655. package/dist/theme/use-cynosure-theme.d.ts +18 -0
  656. package/dist/theme/use-cynosure-theme.js +23 -0
  657. package/dist/theme/use-cynosure-theme.js.map +1 -0
  658. package/dist/tokens/chart-themes.d.ts +38 -0
  659. package/dist/tokens/chart-themes.js +35 -0
  660. package/dist/tokens/chart-themes.js.map +1 -0
  661. package/dist/tokens/create-theme.d.ts +11 -1
  662. package/dist/tokens/create-theme.js +194 -125
  663. package/dist/tokens/create-theme.js.map +1 -1
  664. package/dist/tokens/defaults.d.ts +3 -3
  665. package/dist/tokens/defaults.js +1 -0
  666. package/dist/tokens/defaults.js.map +1 -1
  667. package/dist/tokens/editor-themes.d.ts +9 -2
  668. package/dist/tokens/editor-themes.js +43 -42
  669. package/dist/tokens/editor-themes.js.map +1 -1
  670. package/dist/tokens/index.d.ts +3 -1
  671. package/dist/tokens/named-themes.d.ts +41 -0
  672. package/dist/tokens/named-themes.js +118 -0
  673. package/dist/tokens/named-themes.js.map +1 -0
  674. package/dist/tokens/schema.d.ts +24 -1
  675. package/dist/tokens/schema.js +13 -0
  676. package/dist/tokens/schema.js.map +1 -0
  677. package/dist/tokens/to-css.js +34 -31
  678. package/dist/tokens/to-css.js.map +1 -1
  679. package/package.json +15 -6
  680. package/dist/components/Checkbox/ChoiceRow.d.ts +0 -39
  681. package/dist/components/Checkbox/ChoiceRow.js +0 -58
  682. package/dist/components/Checkbox/ChoiceRow.js.map +0 -1
  683. package/dist/components/Stack/space.d.ts +0 -18
  684. package/dist/components/Stack/space.js +0 -12
  685. package/dist/components/Stack/space.js.map +0 -1
  686. package/dist/styles/hidden-value.css +0 -1
  687. package/dist/styles/iconbutton.css +0 -1
@@ -1,50 +1,69 @@
1
1
  "use client";
2
- import { useDismiss as P } from "../../overlay/dismiss.js";
3
- import { usePopover as b } from "../../overlay/floating.js";
4
- import { useAnchoredPosition as g } from "../../overlay/use-anchored-position.js";
5
- import { cloneElement as v, useCallback as m, useEffect as E, useId as j, useLayoutEffect as x, useRef as o, useState as C } from "react";
6
- import { jsx as L, jsxs as w } from "react/jsx-runtime";
7
- function k({ content: d, children: a, placement: h = "top", delay: T = 300 }) {
8
- const p = `cy-tip-${j().replace(/:/g, "")}`, i = o(null), r = o(null), t = o(void 0), [c, u] = C(!1), y = () => i.current?.firstElementChild ?? i.current, l = o(null), n = o(!1), f = m((e) => {
9
- clearTimeout(t.current), t.current = setTimeout(() => u(!0), e);
10
- }, []), s = m((e = 0) => {
11
- clearTimeout(t.current), t.current = setTimeout(() => u(!1), e);
2
+ import { useClientLayoutEffect as L } from "../../foundations/client-layout-effect.js";
3
+ import { useDismiss as D } from "../../overlay/dismiss.js";
4
+ import { usePopover as F } from "../../overlay/floating.js";
5
+ import { useAnchoredPosition as N } from "../../overlay/use-anchored-position.js";
6
+ import { cloneElement as O, useCallback as x, useEffect as g, useId as W, useRef as o, useState as R } from "react";
7
+ import { jsx as $, jsxs as k } from "react/jsx-runtime";
8
+ function w(u, l) {
9
+ const [b, v] = R(!1), e = o(null);
10
+ return L(() => {
11
+ const a = u ? l() : null, n = a && typeof u == "function" ? u(a) : a, s = () => {
12
+ const c = e.current?.el;
13
+ v(!!c && c.scrollWidth > c.clientWidth);
14
+ };
15
+ n !== (e.current?.el ?? null) && (e.current?.observer.disconnect(), e.current = n ? {
16
+ el: n,
17
+ observer: new ResizeObserver(s)
18
+ } : null, e.current?.observer.observe(n)), s();
19
+ }), g(() => () => e.current?.observer.disconnect(), []), b;
20
+ }
21
+ function H({ content: u, children: l, placement: b = "top", delay: v = 300, className: e, disabled: a = !1, describe: n = !0, whenTruncated: s }) {
22
+ const c = `cy-tip-${W().replace(/:/g, "")}`, h = o(null), f = o(null), t = o(void 0), [y, p] = R(!1), E = () => h.current?.firstElementChild ?? h.current, P = o(null), m = o(!1), B = w(s, E), i = a || (s ? !B : !1), T = n && !s, C = o(i);
23
+ C.current = i;
24
+ const j = x((r) => {
25
+ clearTimeout(t.current), !C.current && (t.current = setTimeout(() => p(!0), r));
26
+ }, []), d = x((r = 0) => {
27
+ clearTimeout(t.current), t.current = setTimeout(() => p(!1), r);
12
28
  }, []);
13
- return E(() => () => clearTimeout(t.current), []), x(() => {
14
- l.current = y();
15
- }), b(r, c), P({
16
- open: c,
17
- onClose: () => u(!1),
18
- inside: [l, r],
29
+ return g(() => () => clearTimeout(t.current), []), g(() => {
30
+ i && (clearTimeout(t.current), p(!1));
31
+ }, [i]), L(() => {
32
+ P.current = E();
33
+ }), F(f, y), D({
34
+ open: y,
35
+ onClose: () => p(!1),
36
+ inside: [P, f],
19
37
  outside: !1
20
- }), g(l, r, c, h), /* @__PURE__ */ w("span", {
21
- ref: i,
22
- className: "cy-tooltip-anchor",
23
- onPointerEnter: (e) => e.pointerType !== "touch" && f(T),
24
- onPointerLeave: () => s(120),
38
+ }), N(P, f, y, b), /* @__PURE__ */ k("span", {
39
+ ref: h,
40
+ className: e ? `cy-tooltip-anchor ${e}` : "cy-tooltip-anchor",
41
+ onPointerEnter: (r) => r.pointerType !== "touch" && j(v),
42
+ onPointerLeave: () => d(120),
25
43
  onPointerDown: () => {
26
- n.current = !0, s();
44
+ m.current = !0, d();
27
45
  },
28
- onFocus: (e) => {
29
- !n.current && e.target.matches(":focus-visible") && f(0), n.current = !1;
46
+ onFocus: (r) => {
47
+ !m.current && r.target.matches(":focus-visible") && j(0), m.current = !1;
30
48
  },
31
49
  onBlur: () => {
32
- n.current = !1, s();
50
+ m.current = !1, d();
33
51
  },
34
- children: [v(a, { "aria-describedby": [a.props["aria-describedby"], p].filter(Boolean).join(" ") }), /* @__PURE__ */ L("span", {
35
- ref: r,
36
- id: p,
52
+ children: [i || !T ? l : O(l, { "aria-describedby": [l.props["aria-describedby"], c].filter(Boolean).join(" ") }), !i && /* @__PURE__ */ $("span", {
53
+ ref: f,
54
+ id: c,
37
55
  role: "tooltip",
56
+ "aria-hidden": T ? void 0 : !0,
38
57
  className: "cy-tooltip",
39
58
  popover: "manual",
40
59
  onPointerEnter: () => clearTimeout(t.current),
41
- onPointerLeave: () => s(120),
42
- children: d
60
+ onPointerLeave: () => d(120),
61
+ children: u
43
62
  })]
44
63
  });
45
64
  }
46
65
  export {
47
- k as Tooltip
66
+ H as Tooltip
48
67
  };
49
68
 
50
69
  //# sourceMappingURL=Tooltip.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Tooltip.js","names":["useDismiss","usePopover","useAnchoredPosition","cloneElement","useCallback","useEffect","useId","useLayoutEffect","useRef","useState","jsx","jsxs","Tooltip","content","children","placement","delay","id","anchor","tip","timer","open","setOpen","trigger","triggerRef","pointerFocus","show","wait","hide"],"sources":["../../../src/components/Tooltip/Tooltip.tsx"],"sourcesContent":["import {\n cloneElement,\n type ReactElement,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { useDismiss } from \"../../overlay/dismiss.js\";\nimport { usePopover } from \"../../overlay/floating.js\";\nimport type { Placement } from \"../../overlay/position.js\";\nimport { useAnchoredPosition } from \"../../overlay/use-anchored-position.js\";\n\nexport interface TooltipTokens {\n bg: string;\n ink: string;\n radius: string;\n maxWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n tooltip: TooltipTokens;\n }\n}\n\nexport interface TooltipProps {\n /** Short supplementary text; it becomes the trigger's accessible description. */\n content: ReactNode;\n /** One focusable element (Button, IconButton, Link…). */\n children: ReactElement<Record<string, unknown>>;\n /** Preferred side; flips when it does not fit. Default \"top\". */\n placement?: Placement;\n /** Hover delay in ms (focus opens immediately). */\n delay?: number;\n}\n\n/**\n * Tooltip in the top layer (Popover API), positioned against its trigger. Opens on hover after `delay` and on\n * keyboard focus; dismissible with Escape; hoverable; never opens on touch (WCAG 1.4.13).\n */\nexport function Tooltip({ content, children, placement = \"top\", delay = 300 }: TooltipProps) {\n const id = `cy-tip-${useId().replace(/:/g, \"\")}`;\n const anchor = useRef<HTMLSpanElement>(null);\n const tip = useRef<HTMLSpanElement>(null);\n const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n const [open, setOpen] = useState(false);\n const trigger = () => (anchor.current?.firstElementChild as HTMLElement | null) ?? anchor.current;\n const triggerRef = useRef<HTMLElement | null>(null);\n // Focus that follows a pointer press (mouse or touch) is not keyboard focus: hover handles mouse, touch never opens.\n const pointerFocus = useRef(false);\n\n const show = useCallback((wait: number) => {\n clearTimeout(timer.current);\n timer.current = setTimeout(() => setOpen(true), wait);\n }, []);\n const hide = useCallback((wait = 0) => {\n clearTimeout(timer.current);\n timer.current = setTimeout(() => setOpen(false), wait);\n }, []);\n\n useEffect(() => () => clearTimeout(timer.current), []);\n useLayoutEffect(() => {\n triggerRef.current = trigger();\n });\n usePopover(tip, open);\n // Escape closes the tooltip first when it sits inside a Popover, Menu or Dialog (shared layer stack).\n useDismiss({ open, onClose: () => setOpen(false), inside: [triggerRef, tip], outside: false });\n useAnchoredPosition(triggerRef, tip, open, placement);\n\n return (\n // biome-ignore lint/a11y/noStaticElementInteractions: delegated hover/focus listeners for the interactive child\n <span\n ref={anchor}\n className=\"cy-tooltip-anchor\"\n onPointerEnter={(e) => e.pointerType !== \"touch\" && show(delay)}\n onPointerLeave={() => hide(120)}\n onPointerDown={() => {\n pointerFocus.current = true;\n hide();\n }}\n onFocus={(e) => {\n if (!pointerFocus.current && (e.target as HTMLElement).matches(\":focus-visible\")) show(0);\n pointerFocus.current = false;\n }}\n onBlur={() => {\n pointerFocus.current = false;\n hide();\n }}\n >\n {cloneElement(children, {\n \"aria-describedby\": [children.props[\"aria-describedby\"], id].filter(Boolean).join(\" \"),\n })}\n <span\n ref={tip}\n id={id}\n role=\"tooltip\"\n className=\"cy-tooltip\"\n {...{ popover: \"manual\" }}\n onPointerEnter={() => clearTimeout(timer.current)}\n onPointerLeave={() => hide(120)}\n >\n {content}\n </span>\n </span>\n );\n}\n"],"mappings":";;;;;;AA4CA,SAAgBY,EAAQ,EAAE,SAAAC,GAAS,UAAAC,GAAU,WAAAC,IAAY,OAAO,OAAAC,IAAQ,IAAA,GAAqB;AAC3F,QAAMC,IAAK,UAAUX,EAAM,EAAE,QAAQ,MAAM,EAAE,CAAA,IACvCY,IAASV,EAAwB,IAAI,GACrCW,IAAMX,EAAwB,IAAI,GAClCY,IAAQZ,EAAkD,MAAS,GACnE,CAACa,GAAMC,CAAA,IAAWb,EAAS,EAAK,GAChCc,IAAA,MAAiBL,EAAO,SAAS,qBAA4CA,EAAO,SACpFM,IAAahB,EAA2B,IAAI,GAE5CiB,IAAejB,EAAO,EAAK,GAE3BkB,IAAOtB,EAAA,CAAauB,MAAiB;AACzC,iBAAaP,EAAM,OAAO,GAC1BA,EAAM,UAAU,WAAA,MAAiBE,EAAQ,EAAI,GAAGK,CAAI;AAAA,EACtD,GAAG,CAAC,CAAC,GACCC,IAAOxB,EAAA,CAAauB,IAAO,MAAM;AACrC,iBAAaP,EAAM,OAAO,GAC1BA,EAAM,UAAU,WAAA,MAAiBE,EAAQ,EAAK,GAAGK,CAAI;AAAA,EACvD,GAAG,CAAC,CAAC;AAEL,SAAAtB,EAAA,MAAA,MAAsB,aAAae,EAAM,OAAO,GAAG,CAAC,CAAC,GACrDb,EAAA,MAAsB;AACpB,IAAAiB,EAAW,UAAUD,EAAQ;AAAA,EAC/B,CAAC,GACDtB,EAAWkB,GAAKE,CAAI,GAEpBrB,EAAW;AAAA,IAAE,MAAAqB;AAAA,IAAM,SAAA,MAAeC,EAAQ,EAAK;AAAA,IAAG,QAAQ,CAACE,GAAYL,CAAG;AAAA,IAAG,SAAS;AAAA,EAAM,CAAC,GAC7FjB,EAAoBsB,GAAYL,GAAKE,GAAMN,CAAS,GAIlD,gBAAAJ,EAAC,QAAD;AAAA,IACE,KAAKO;AAAA,IACL,WAAU;AAAA,IACV,gBAAA,CAAiB,MAAM,EAAE,gBAAgB,WAAWQ,EAAKV,CAAK;AAAA,IAC9D,gBAAA,MAAsBY,EAAK,GAAG;AAAA,IAC9B,eAAA,MAAqB;AACnB,MAAAH,EAAa,UAAU,IACvBG,EAAK;AAAA,IACP;AAAA,IACA,SAAA,CAAU,MAAM;AACd,MAAI,CAACH,EAAa,WAAY,EAAE,OAAuB,QAAQ,gBAAgB,KAAGC,EAAK,CAAC,GACxFD,EAAa,UAAU;AAAA,IACzB;AAAA,IACA,QAAA,MAAc;AACZ,MAAAA,EAAa,UAAU,IACvBG,EAAK;AAAA,IACP;AAAA,IAhBF,UAAA,CAkBGzB,EAAaW,GAAU,EACtB,oBAAoB,CAACA,EAAS,MAAM,kBAAA,GAAqBG,CAAE,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EACvF,CAAC,GACD,gBAAAP,EAAC,QAAD;AAAA,MACE,KAAKS;AAAA,MACD,IAAAF;AAAA,MACJ,MAAK;AAAA,MACL,WAAU;AAAA,MACJ,SAAS;AAAA,MACf,gBAAA,MAAsB,aAAaG,EAAM,OAAO;AAAA,MAChD,gBAAA,MAAsBQ,EAAK,GAAG;AAAA,MAE7B,UAAAf;AAAA,IACG,CAAA,CACF;AAAA,E;AAEV"}
1
+ {"version":3,"file":"Tooltip.js","names":["useClientLayoutEffect","useDismiss","usePopover","useAnchoredPosition","cloneElement","useCallback","useEffect","useId","useRef","useState","jsx","jsxs","useTruncated","whenTruncated","trigger","cut","setCut","watched","host","el","measure","node","Tooltip","content","children","placement","delay","className","off","describes","id","anchor","tip","timer","open","setOpen","triggerRef","pointerFocus","disabled","describe","disabledNow","show","wait","hide","e"],"sources":["../../../src/components/Tooltip/Tooltip.tsx"],"sourcesContent":["import {\n cloneElement,\n type ReactElement,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useRef,\n useState,\n} from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useDismiss } from \"../../overlay/dismiss.js\";\nimport { usePopover } from \"../../overlay/floating.js\";\nimport type { Placement } from \"../../overlay/position.js\";\nimport { useAnchoredPosition } from \"../../overlay/use-anchored-position.js\";\n\nexport interface TooltipTokens {\n bg: string;\n ink: string;\n radius: string;\n maxWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n tooltip: TooltipTokens;\n }\n}\n\nexport interface TooltipProps {\n /** Short supplementary text; it becomes the trigger's accessible description. */\n content: ReactNode;\n /** One focusable element (Button, IconButton, Link…). */\n children: ReactElement<Record<string, unknown>>;\n /** Preferred side; flips when it does not fit. Default \"top\". */\n placement?: Placement;\n /** Hover delay in ms (focus opens immediately). */\n delay?: number;\n /**\n * Added to the element around the trigger (the anchor, the box the parent lays out), for layout: a grid area,\n * `flex`, margins.\n */\n className?: string | undefined;\n /**\n * Turn the tooltip off without remounting the trigger: no tip, no description, hover and focus do nothing. For a\n * tooltip that only matters sometimes, such as the full text of a label while it is cut short.\n */\n disabled?: boolean | undefined;\n /**\n * `false` when the tip only repeats text the trigger's name already holds, such as a label cut short with an\n * ellipsis: it is shown but hidden from assistive technology, and does not describe the trigger. Default true.\n */\n describe?: boolean | undefined;\n /**\n * Show the tip only while text is cut short (it overflows its box, as with an ellipsis), for the full text of a\n * label: `true` measures the trigger, a function picks the element inside it that holds the text. It is measured\n * after every render and whenever the element is resized, and the tip repeats the trigger's name, so it implies\n * `describe={false}`.\n */\n whenTruncated?: boolean | ((trigger: HTMLElement) => HTMLElement | null) | undefined;\n}\n\n/**\n * Whether the text `whenTruncated` names is cut short: measured after every render (the text may change while the box\n * keeps its width) and, through one ResizeObserver, whenever its box is resized (the window, a neighbour). Off: false.\n */\nfunction useTruncated(whenTruncated: TooltipProps[\"whenTruncated\"], trigger: () => HTMLElement | null) {\n const [cut, setCut] = useState(false);\n const watched = useRef<{ el: HTMLElement; observer: ResizeObserver } | null>(null);\n useClientLayoutEffect(() => {\n const host = whenTruncated ? trigger() : null;\n const el = host && typeof whenTruncated === \"function\" ? whenTruncated(host) : host;\n const measure = () => {\n const node = watched.current?.el;\n setCut(!!node && node.scrollWidth > node.clientWidth);\n };\n if (el !== (watched.current?.el ?? null)) {\n watched.current?.observer.disconnect();\n watched.current = el ? { el, observer: new ResizeObserver(measure) } : null;\n watched.current?.observer.observe(el as HTMLElement);\n }\n measure();\n });\n useEffect(() => () => watched.current?.observer.disconnect(), []);\n return cut;\n}\n\n/**\n * Tooltip in the top layer (Popover API), positioned against its trigger. Opens on hover after `delay` and on\n * keyboard focus; dismissible with Escape; hoverable; never opens on touch (WCAG 1.4.13).\n */\nexport function Tooltip({\n content,\n children,\n placement = \"top\",\n delay = 300,\n className,\n disabled: off = false,\n describe: describes = true,\n whenTruncated,\n}: TooltipProps) {\n const id = `cy-tip-${useId().replace(/:/g, \"\")}`;\n const anchor = useRef<HTMLSpanElement>(null);\n const tip = useRef<HTMLSpanElement>(null);\n const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n const [open, setOpen] = useState(false);\n const trigger = () => (anchor.current?.firstElementChild as HTMLElement | null) ?? anchor.current;\n const triggerRef = useRef<HTMLElement | null>(null);\n // Focus that follows a pointer press (mouse or touch) is not keyboard focus: hover handles mouse, touch never opens.\n const pointerFocus = useRef(false);\n\n const cut = useTruncated(whenTruncated, trigger);\n const disabled = off || (whenTruncated ? !cut : false);\n const describe = describes && !whenTruncated;\n const disabledNow = useRef(disabled);\n disabledNow.current = disabled;\n const show = useCallback((wait: number) => {\n clearTimeout(timer.current);\n if (disabledNow.current) return;\n timer.current = setTimeout(() => setOpen(true), wait);\n }, []);\n const hide = useCallback((wait = 0) => {\n clearTimeout(timer.current);\n timer.current = setTimeout(() => setOpen(false), wait);\n }, []);\n\n useEffect(() => () => clearTimeout(timer.current), []);\n // Disabled while open (a label stopped being cut short): close, so it does not reappear when enabled again.\n useEffect(() => {\n if (disabled) {\n clearTimeout(timer.current);\n setOpen(false);\n }\n }, [disabled]);\n useClientLayoutEffect(() => {\n triggerRef.current = trigger();\n });\n usePopover(tip, open);\n // Escape closes the tooltip first when it sits inside a Popover, Menu or Dialog (shared layer stack).\n useDismiss({ open, onClose: () => setOpen(false), inside: [triggerRef, tip], outside: false });\n useAnchoredPosition(triggerRef, tip, open, placement);\n\n return (\n // biome-ignore lint/a11y/noStaticElementInteractions: delegated hover/focus listeners for the interactive child\n <span\n ref={anchor}\n className={className ? `cy-tooltip-anchor ${className}` : \"cy-tooltip-anchor\"}\n onPointerEnter={(e) => e.pointerType !== \"touch\" && show(delay)}\n onPointerLeave={() => hide(120)}\n onPointerDown={() => {\n pointerFocus.current = true;\n hide();\n }}\n onFocus={(e) => {\n if (!pointerFocus.current && (e.target as HTMLElement).matches(\":focus-visible\")) show(0);\n pointerFocus.current = false;\n }}\n onBlur={() => {\n pointerFocus.current = false;\n hide();\n }}\n >\n {disabled || !describe\n ? children\n : cloneElement(children, {\n \"aria-describedby\": [children.props[\"aria-describedby\"], id].filter(Boolean).join(\" \"),\n })}\n {!disabled && (\n <span\n ref={tip}\n id={id}\n role=\"tooltip\"\n aria-hidden={describe ? undefined : true}\n className=\"cy-tooltip\"\n {...{ popover: \"manual\" }}\n onPointerEnter={() => clearTimeout(timer.current)}\n onPointerLeave={() => hide(120)}\n >\n {content}\n </span>\n )}\n </span>\n );\n}\n"],"mappings":"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"}
@@ -1,7 +1,11 @@
1
- import { type CSSProperties, type ReactNode } from "react";
1
+ import { type CSSProperties, type ReactNode, type Ref } from "react";
2
+ import { type OptionIconColor } from "../../foundations/option-icon.js";
2
3
  import type { IconData } from "../../icons/types.js";
3
4
  import type { Size } from "../../tokens/schema.js";
5
+ import type { MenuEntry } from "../Menu/Menu.js";
4
6
  export interface TreeTokens {
7
+ trailingInk: string;
8
+ groupInk: string;
5
9
  indent: string;
6
10
  rowHeight: string;
7
11
  selectedBg: string;
@@ -11,25 +15,76 @@ declare module "../../tokens/schema.js" {
11
15
  tree: TreeTokens;
12
16
  }
13
17
  }
14
- export interface TreeItem {
18
+ /** A button at the end of a row (View data, Open in a new tab), shown while the row is hovered, focused or selected. */
19
+ export interface TreeItemAction {
20
+ /** Handed to `onCommand` with the item when the button is pressed. */
21
+ value: string;
22
+ /** The button's accessible name and tooltip. */
23
+ label: string;
24
+ /** The button's icon. */
25
+ icon: IconData;
26
+ /** Shown but cannot be pressed. */
27
+ disabled?: boolean;
28
+ }
29
+ export interface TreeItem<T = unknown> extends OptionIconColor {
30
+ /** Identifies the item: selection, expansion, `loadingIds`, `errorIds` and `reload` use it. Unique in the tree. */
15
31
  id: string;
32
+ /** The row's text; type-ahead and a string `filter` match it. */
16
33
  label: string;
34
+ /** Icon before the label, muted by default. Colour it with `iconTone` or `iconColor`. */
17
35
  icon?: IconData;
36
+ /** Shown but cannot be focused, selected or acted on. */
18
37
  disabled?: boolean;
19
38
  /** Known children. Leave it out and set `hasChildren` to load them with `loadChildren` on first expand. */
20
- children?: TreeItem[];
39
+ children?: TreeItem<T>[];
40
+ /** It has children not known yet: loaded by `loadChildren`, or put in `children` by you (`loadingIds`). */
21
41
  hasChildren?: boolean;
42
+ /**
43
+ * `group`: a heading for the rows under it (Tables, Views, Functions). It is never selected: Enter, Space and a click
44
+ * open and close it, and its end shows how many children it has (shown ones, while filtering) unless `trailing` is
45
+ * given.
46
+ */
47
+ kind?: "item" | "group";
48
+ /** At the end of the row: a count, a badge, a short value. Part of the row's name. */
49
+ trailing?: ReactNode;
50
+ /** Your own payload (a table's schema, a node's type), handed back with the item in every callback. */
51
+ data?: T;
52
+ /**
53
+ * Buttons at the end of the row, shown while it is hovered, focused or selected. On the focused row they are in the
54
+ * Tab order: Tab reaches them, Shift+Tab or Escape goes back to the row. Pressed, they call `onCommand`.
55
+ */
56
+ actions?: TreeItemAction[];
57
+ /**
58
+ * Commands in a ContextMenu, opened by right-click, a long press, Shift+F10 or the context menu key on the row: items,
59
+ * or sections of items, as in `Menu`. Chosen, they call `onCommand`.
60
+ */
61
+ contextMenu?: MenuEntry[];
62
+ }
63
+ /** Imperative control of a Tree, through its `handle` prop. */
64
+ export interface TreeHandle {
65
+ /**
66
+ * Forget the loaded children of an item and run `loadChildren` again: now when it is open (a loading row shows),
67
+ * else the next time it opens.
68
+ */
69
+ reload: (id: string) => void;
22
70
  }
23
71
  export interface TreeLabels {
24
72
  loading: string;
25
73
  /** Row shown when `loadChildren` fails; Enter or a click on it tries again. */
26
74
  failed: string;
75
+ /** The name of a row's context menu, from its label. Default "users actions". */
76
+ menu: (label: string) => string;
27
77
  }
28
- export interface TreeProps {
78
+ /**
79
+ * Which items match: a string (case-insensitive, anywhere in the label), or a function returning true, false, or the
80
+ * indices of the matched characters in the label (a fuzzy matcher's positions) to mark exactly those.
81
+ */
82
+ export type TreeFilter<T = unknown> = string | ((item: TreeItem<T>) => boolean | readonly number[] | null);
83
+ export interface TreeProps<T = unknown> {
29
84
  /** Accessible name of the tree. */
30
85
  label: string;
31
86
  /** The top-level items; each can hold more under `children`. */
32
- items: TreeItem[];
87
+ items: TreeItem<T>[];
33
88
  /** Selected ids (controlled) and the default for uncontrolled use. */
34
89
  selected?: string[];
35
90
  /** Ids selected at the start when uncontrolled. */
@@ -45,11 +100,37 @@ export interface TreeProps {
45
100
  /** `single` (default): one at a time. `multiple`: Space and clicks toggle. */
46
101
  selectionMode?: "single" | "multiple";
47
102
  /** Fetch the children of an item that `hasChildren` but has none yet. */
48
- loadChildren?: (item: TreeItem) => Promise<TreeItem[]>;
49
- /** Custom row content after the chevron (a value, a badge, a line number). `label` still drives type-ahead. */
50
- renderLabel?: (item: TreeItem) => ReactNode;
103
+ loadChildren?: (item: TreeItem<T>) => Promise<TreeItem<T>[]>;
104
+ /**
105
+ * Items whose children are loading somewhere else (a store): a loading row shows under them while open and they have
106
+ * no `children` yet; with children, the item is only marked busy.
107
+ */
108
+ loadingIds?: readonly string[];
109
+ /** Items whose children failed to load somewhere else: an error row shows under them in place of any children. */
110
+ errorIds?: readonly string[];
111
+ /** Called when a failed item is retried (Enter or a click on its error row, or `renderError`'s `retry`). */
112
+ onRetry?: (item: TreeItem<T>) => void;
113
+ /** Content of the error row of an item whose children failed. `retry` runs `loadChildren` again and `onRetry`. */
114
+ renderError?: (item: TreeItem<T>, retry: () => void) => ReactNode;
115
+ /** Content of a row shown under an open item that has no children ("No columns"). Without it, nothing shows. */
116
+ renderEmpty?: (item: TreeItem<T>) => ReactNode;
117
+ /**
118
+ * Show only matching items, with their ancestors (opened) and their own children, and mark the matched text. A string
119
+ * matches the label anywhere, ignoring case. Only known children are searched. Pass a stable function (useCallback):
120
+ * branches closed while filtering open again when it changes.
121
+ */
122
+ filter?: TreeFilter<T> | undefined;
123
+ /**
124
+ * Custom row content after the chevron and icon (a value, a badge, a line number). `label` is the label as the tree
125
+ * would draw it (with matches marked while filtering). The item's `label` still drives type-ahead.
126
+ */
127
+ renderLabel?: (item: TreeItem<T>, label: ReactNode) => ReactNode;
51
128
  /** Enter (or a double-click) on an item: its default action, such as opening it or copying its path. Space selects. */
52
- onAction?: ((item: TreeItem) => void) | undefined;
129
+ onAction?: ((item: TreeItem<T>) => void) | undefined;
130
+ /** Called with the `value` of a pressed row action or a chosen context menu command, and the row's item. */
131
+ onCommand?: ((value: string, item: TreeItem<T>) => void) | undefined;
132
+ /** Imperative control: `reload(id)`. */
133
+ handle?: Ref<TreeHandle>;
53
134
  /**
54
135
  * Render only the rows in view (for tens of thousands of rows). Give the tree a height (`style` or a class); rows
55
136
  * must share one height.
@@ -57,7 +138,7 @@ export interface TreeProps {
57
138
  virtual?: boolean;
58
139
  /** Row height and indent. Default "md". */
59
140
  size?: Extract<Size, "sm" | "md">;
60
- /** Replace the built-in English text: the loading row and the failed-to-load row. */
141
+ /** Replace the built-in English text: the loading row, the failed-to-load row and the context menu's name. */
61
142
  labels?: Partial<TreeLabels>;
62
143
  /** Added to the root element, for layout. */
63
144
  className?: string;
@@ -65,4 +146,4 @@ export interface TreeProps {
65
146
  style?: CSSProperties;
66
147
  }
67
148
  /** Hierarchical list (WAI-ARIA APG tree view): arrows, type-ahead, expand and collapse, selection, lazy children. */
68
- export declare function Tree({ label, items, selected, defaultSelected, onSelectionChange, expanded, defaultExpanded, onExpandedChange, selectionMode, loadChildren, renderLabel, onAction, virtual, size, labels, className, style, }: TreeProps): import("react").JSX.Element;
149
+ export declare function Tree<T = unknown>(props: TreeProps<T>): import("react").JSX.Element;