@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
@@ -0,0 +1,55 @@
1
+ import { type CSSProperties, type ReactNode, type Ref, type UIEvent } from "react";
2
+ import { type ScrollAlign } from "../../foundations/scroll-align.js";
3
+ /** Where `scrollIntoView` puts the element. */
4
+ export interface ScrollAreaIntoViewOptions {
5
+ /** `nearest` (default) scrolls the least that shows it whole; `start` puts it at the top; `center` in the middle. */
6
+ align?: ScrollAlign;
7
+ }
8
+ /** What `handle` gives you: scrolling from outside the area (a "jump to latest" button, a search hit). */
9
+ export interface ScrollAreaHandle {
10
+ /** Scrolls to the end (the bottom), which also resumes `follow`. */
11
+ scrollToEnd: () => void;
12
+ /** Scrolls the area, and nothing around it, so `element` (inside the area) is in view. */
13
+ scrollIntoView: (element: Element, options?: ScrollAreaIntoViewOptions) => void;
14
+ }
15
+ export interface ScrollAreaProps {
16
+ /**
17
+ * Accessible name. With it the area is a named region, and a tab stop whenever there is something to scroll, so
18
+ * a keyboard can scroll it. Give one unless the content has its own focusable elements (links, buttons, a list).
19
+ */
20
+ label?: string | undefined;
21
+ /** Which way it scrolls; content is clipped the other way. Default "vertical". */
22
+ direction?: "vertical" | "horizontal" | "both";
23
+ /**
24
+ * Keep the end in view while content is added (a log, a chat, an activity stream). Scrolling up lets go; scrolling
25
+ * back to the end, or `handle.scrollToEnd()`, follows again.
26
+ */
27
+ follow?: boolean;
28
+ /** Called on every scroll of the area, with the scroll event of its scrolling element. */
29
+ onScroll?: ((event: UIEvent<HTMLDivElement>) => void) | undefined;
30
+ /**
31
+ * Called with false when the view leaves the end (the bottom) and true when it is back, from scrolling or from
32
+ * content growing past it. It starts true. Use it to show a "jump to latest" control.
33
+ */
34
+ onAtBottomChange?: ((atBottom: boolean) => void) | undefined;
35
+ /**
36
+ * Content pinned over the area at the bottom centre that does not scroll: a "3 new" pill, a "jump to latest" button.
37
+ * It is outside the named region.
38
+ */
39
+ overlay?: ReactNode;
40
+ /** `scrollToEnd` and `scrollIntoView`, for scrolling from outside. */
41
+ handle?: Ref<ScrollAreaHandle>;
42
+ /** Added to the root element, for layout. */
43
+ className?: string;
44
+ /** Layout only (e.g. `maxBlockSize`). Restyle through --cy-scroll-area-* tokens. */
45
+ style?: CSSProperties;
46
+ /** What scrolls. */
47
+ children?: ReactNode;
48
+ /** Set on the root element, for tests. */
49
+ "data-testid"?: string;
50
+ }
51
+ /**
52
+ * A box that fills its parent and scrolls what does not fit: the scrolling middle of an app shell, a panel, a log.
53
+ * It can follow the end as content arrives and hold an overlay that stays put.
54
+ */
55
+ export declare const ScrollArea: import("react").ForwardRefExoticComponent<ScrollAreaProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -0,0 +1,55 @@
1
+ "use client";
2
+ import { alignedScroll as b } from "../../foundations/scroll-align.js";
3
+ import { OverlayFrame as A } from "../OverlayFrame/OverlayFrame.js";
4
+ import { useFollow as B } from "../../foundations/use-follow.js";
5
+ import { forwardRef as C, useImperativeHandle as E, useRef as u, useState as F } from "react";
6
+ import { jsx as n } from "react/jsx-runtime";
7
+ var k = C(function({ label: i, direction: o = "vertical", follow: h = !1, onScroll: p, onAtBottomChange: g, overlay: v, handle: w, className: s, style: y, children: S, ...x }, R) {
8
+ const t = u(null), a = u(null), [H, T] = F(!1), f = B(t, {
9
+ follow: h,
10
+ onAtBottomChange: g,
11
+ content: a,
12
+ onResize: () => {
13
+ const e = t.current;
14
+ if (!e) return;
15
+ const c = o !== "horizontal" && e.scrollHeight > e.clientHeight, l = o !== "vertical" && e.scrollWidth > e.clientWidth;
16
+ T(l || c);
17
+ }
18
+ });
19
+ return E(w, () => ({
20
+ scrollToEnd: f.scrollToEnd,
21
+ scrollIntoView: (e, { align: c = "nearest" } = {}) => {
22
+ const l = t.current, d = l.getBoundingClientRect(), r = e.getBoundingClientRect(), m = (z, I, W) => b(0, W, z, I, c);
23
+ o !== "horizontal" && (l.scrollTop += m(r.top - d.top - l.clientTop, r.height, l.clientHeight)), o !== "vertical" && (l.scrollLeft += m(r.left - d.left - l.clientLeft, r.width, l.clientWidth));
24
+ }
25
+ })), /* @__PURE__ */ n(A, {
26
+ ref: R,
27
+ ...x,
28
+ className: s ? `cy-scroll-area ${s}` : "cy-scroll-area",
29
+ style: y,
30
+ overlay: v,
31
+ children: /* @__PURE__ */ n("div", {
32
+ ref: t,
33
+ className: "cy-scroll-area-viewport cy-reset",
34
+ "data-direction": o,
35
+ ...i ? {
36
+ role: "region",
37
+ "aria-label": i,
38
+ tabIndex: H ? 0 : void 0
39
+ } : {},
40
+ onScroll: (e) => {
41
+ f.onScroll(), p?.(e);
42
+ },
43
+ children: /* @__PURE__ */ n("div", {
44
+ ref: a,
45
+ className: "cy-scroll-area-content cy-reset",
46
+ children: S
47
+ })
48
+ })
49
+ });
50
+ });
51
+ export {
52
+ k as ScrollArea
53
+ };
54
+
55
+ //# sourceMappingURL=ScrollArea.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScrollArea.js","names":["alignedScroll","OverlayFrame","useFollow","forwardRef","useImperativeHandle","useRef","useState","jsx","ScrollArea","label","direction","follow","onScroll","onAtBottomChange","overlay","handle","className","style","children","rest","ref","viewport","content","scrolls","setScrolls","following","el","y","x","element","align","view","box","along","offset","size","room","event"],"sources":["../../../src/components/ScrollArea/ScrollArea.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type ReactNode,\n type Ref,\n type UIEvent,\n useImperativeHandle,\n useRef,\n useState,\n} from \"react\";\nimport { alignedScroll, type ScrollAlign } from \"../../foundations/scroll-align.js\";\nimport { useFollow } from \"../../foundations/use-follow.js\";\nimport { OverlayFrame } from \"../OverlayFrame/OverlayFrame.js\";\n\n/** Where `scrollIntoView` puts the element. */\nexport interface ScrollAreaIntoViewOptions {\n /** `nearest` (default) scrolls the least that shows it whole; `start` puts it at the top; `center` in the middle. */\n align?: ScrollAlign;\n}\n\n/** What `handle` gives you: scrolling from outside the area (a \"jump to latest\" button, a search hit). */\nexport interface ScrollAreaHandle {\n /** Scrolls to the end (the bottom), which also resumes `follow`. */\n scrollToEnd: () => void;\n /** Scrolls the area, and nothing around it, so `element` (inside the area) is in view. */\n scrollIntoView: (element: Element, options?: ScrollAreaIntoViewOptions) => void;\n}\n\nexport interface ScrollAreaProps {\n /**\n * Accessible name. With it the area is a named region, and a tab stop whenever there is something to scroll, so\n * a keyboard can scroll it. Give one unless the content has its own focusable elements (links, buttons, a list).\n */\n label?: string | undefined;\n /** Which way it scrolls; content is clipped the other way. Default \"vertical\". */\n direction?: \"vertical\" | \"horizontal\" | \"both\";\n /**\n * Keep the end in view while content is added (a log, a chat, an activity stream). Scrolling up lets go; scrolling\n * back to the end, or `handle.scrollToEnd()`, follows again.\n */\n follow?: boolean;\n /** Called on every scroll of the area, with the scroll event of its scrolling element. */\n onScroll?: ((event: UIEvent<HTMLDivElement>) => void) | undefined;\n /**\n * Called with false when the view leaves the end (the bottom) and true when it is back, from scrolling or from\n * content growing past it. It starts true. Use it to show a \"jump to latest\" control.\n */\n onAtBottomChange?: ((atBottom: boolean) => void) | undefined;\n /**\n * Content pinned over the area at the bottom centre that does not scroll: a \"3 new\" pill, a \"jump to latest\" button.\n * It is outside the named region.\n */\n overlay?: ReactNode;\n /** `scrollToEnd` and `scrollIntoView`, for scrolling from outside. */\n handle?: Ref<ScrollAreaHandle>;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only (e.g. `maxBlockSize`). Restyle through --cy-scroll-area-* tokens. */\n style?: CSSProperties;\n /** What scrolls. */\n children?: ReactNode;\n /** Set on the root element, for tests. */\n \"data-testid\"?: string;\n}\n\n/**\n * A box that fills its parent and scrolls what does not fit: the scrolling middle of an app shell, a panel, a log.\n * It can follow the end as content arrives and hold an overlay that stays put.\n */\nexport const ScrollArea = forwardRef<HTMLDivElement, ScrollAreaProps>(function ScrollArea(\n {\n label,\n direction = \"vertical\",\n follow = false,\n onScroll,\n onAtBottomChange,\n overlay,\n handle,\n className,\n style,\n children,\n ...rest\n },\n ref,\n) {\n const viewport = useRef<HTMLDivElement>(null);\n const content = useRef<HTMLDivElement>(null);\n const [scrolls, setScrolls] = useState(false);\n const following = useFollow(viewport, {\n follow,\n onAtBottomChange,\n content,\n onResize: () => {\n const el = viewport.current;\n if (!el) return;\n const y = direction !== \"horizontal\" && el.scrollHeight > el.clientHeight;\n const x = direction !== \"vertical\" && el.scrollWidth > el.clientWidth;\n setScrolls(x || y);\n },\n });\n\n useImperativeHandle(handle, () => ({\n scrollToEnd: following.scrollToEnd,\n // The handle is set while the area is mounted, so its viewport is there.\n scrollIntoView: (element, { align = \"nearest\" } = {}) => {\n const el = viewport.current as HTMLDivElement;\n const view = el.getBoundingClientRect();\n const box = element.getBoundingClientRect();\n // Where the element is in the visible area (the view at 0), so the distance works in either text direction.\n const along = (offset: number, size: number, room: number) =>\n alignedScroll(0, room, offset, size, align);\n if (direction !== \"horizontal\")\n el.scrollTop += along(box.top - view.top - el.clientTop, box.height, el.clientHeight);\n if (direction !== \"vertical\")\n el.scrollLeft += along(box.left - view.left - el.clientLeft, box.width, el.clientWidth);\n },\n }));\n\n return (\n <OverlayFrame\n ref={ref}\n {...rest}\n className={className ? `cy-scroll-area ${className}` : \"cy-scroll-area\"}\n style={style}\n overlay={overlay}\n >\n <div\n ref={viewport}\n className=\"cy-scroll-area-viewport cy-reset\"\n data-direction={direction}\n // A named region, and a tab stop while there is something to scroll, so a keyboard can scroll it.\n {...(label ? { role: \"region\", \"aria-label\": label, tabIndex: scrolls ? 0 : undefined } : {})}\n onScroll={(event) => {\n following.onScroll();\n onScroll?.(event);\n }}\n >\n <div ref={content} className=\"cy-scroll-area-content cy-reset\">\n {children}\n </div>\n </div>\n </OverlayFrame>\n );\n});\n"],"mappings":";;;;;;AAqEA,IAAaQ,IAAaL,EAA4C,SACpE,EACE,OAAAM,GACA,WAAAC,IAAY,YACZ,QAAAC,IAAS,IACT,UAAAC,GACA,kBAAAC,GACA,SAAAC,GACA,QAAAC,GACA,WAAAC,GACA,OAAAC,GACA,UAAAC,GACA,GAAGC,EAAA,GAELC,GACA;AACA,QAAMC,IAAWhB,EAAuB,IAAI,GACtCiB,IAAUjB,EAAuB,IAAI,GACrC,CAACkB,GAASC,CAAA,IAAclB,EAAS,EAAK,GACtCmB,IAAYvB,EAAUmB,GAAU;AAAA,IACpC,QAAAV;AAAA,IACA,kBAAAE;AAAA,IACA,SAAAS;AAAA,IACA,UAAA,MAAgB;AACd,YAAMI,IAAKL,EAAS;AACpB,UAAI,CAACK,EAAI;AACT,YAAMC,IAAIjB,MAAc,gBAAgBgB,EAAG,eAAeA,EAAG,cACvDE,IAAIlB,MAAc,cAAcgB,EAAG,cAAcA,EAAG;AAC1D,MAAAF,EAAWI,KAAKD,CAAC;AAAA,IACnB;AAAA,EACF,CAAC;AAED,SAAAvB,EAAoBW,GAAA,OAAe;AAAA,IACjC,aAAaU,EAAU;AAAA,IAEvB,gBAAA,CAAiBI,GAAS,EAAE,OAAAC,IAAQ,UAAA,IAAc,CAAC,MAAM;AACvD,YAAMJ,IAAKL,EAAS,SACdU,IAAOL,EAAG,sBAAsB,GAChCM,IAAMH,EAAQ,sBAAsB,GAEpCI,IAAA,CAASC,GAAgBC,GAAcC,MAC3CpC,EAAc,GAAGoC,GAAMF,GAAQC,GAAML,CAAK;AAC5C,MAAIpB,MAAc,iBAChBgB,EAAG,aAAaO,EAAMD,EAAI,MAAMD,EAAK,MAAML,EAAG,WAAWM,EAAI,QAAQN,EAAG,YAAY,IAClFhB,MAAc,eAChBgB,EAAG,cAAcO,EAAMD,EAAI,OAAOD,EAAK,OAAOL,EAAG,YAAYM,EAAI,OAAON,EAAG,WAAW;AAAA,IAC1F;AAAA,EACF,EAAE,GAGA,gBAAAnB,EAACN,GAAD;AAAA,IACO,KAAAmB;AAAA,IACL,GAAID;AAAA,IACJ,WAAWH,IAAY,kBAAkBA,CAAA,KAAc;AAAA,IAChD,OAAAC;AAAA,IACE,SAAAH;AAAA,IAET,UAAA,gBAAAP,EAAC,OAAD;AAAA,MACE,KAAKc;AAAA,MACL,WAAU;AAAA,MACV,kBAAgBX;AAAA,MAEhB,GAAKD,IAAQ;AAAA,QAAE,MAAM;AAAA,QAAU,cAAcA;AAAA,QAAO,UAAUc,IAAU,IAAI;AAAA,MAAU,IAAI,CAAC;AAAA,MAC3F,UAAA,CAAWc,MAAU;AACnB,QAAAZ,EAAU,SAAS,GACnBb,IAAWyB,CAAK;AAAA,MAClB;AAAA,MAEA,UAAA,gBAAA9B,EAAC,OAAD;AAAA,QAAK,KAAKe;AAAA,QAAS,WAAU;AAAA,QAC1B,UAAAJ;AAAA,MACE,CAAA;AAAA,IACF,CAAA;AAAA,EACO,CAAA;AAElB,CAAC"}
@@ -0,0 +1 @@
1
+ export { ScrollArea, type ScrollAreaHandle, type ScrollAreaIntoViewOptions, type ScrollAreaProps, } from "./ScrollArea.js";
@@ -1,7 +1,24 @@
1
+ import { type ReactNode } from "react";
1
2
  import { type TextFieldProps } from "../TextField/TextField.js";
3
+ export interface SearchFieldTokens {
4
+ /** Colour of the trailing status text. */
5
+ trailingColor: string;
6
+ /** Font size of the trailing status text (a match count). */
7
+ trailingFontSize: string;
8
+ }
9
+ declare module "../../tokens/schema.js" {
10
+ interface ComponentTokens {
11
+ searchField: SearchFieldTokens;
12
+ }
13
+ }
2
14
  export interface SearchFieldProps extends Omit<TextFieldProps, "type" | "iconStart"> {
3
15
  /** Called with the current value on Enter (never while an IME composition is active). */
4
16
  onSubmit?: (value: string) => void;
17
+ /**
18
+ * Status text inside the field, at its end: a match count such as "3 of 12". When its text changes it is announced
19
+ * politely. Text only: put controls in `addonEnd`.
20
+ */
21
+ trailing?: ReactNode;
5
22
  }
6
23
  /** TextField preset for search: search icon, clearable, Enter submits, Escape clears then blurs. */
7
24
  export declare const SearchField: import("react").ForwardRefExoticComponent<SearchFieldProps & import("react").RefAttributes<HTMLInputElement>>;
@@ -1,28 +1,42 @@
1
1
  "use client";
2
- import { isComposing as p } from "../../foundations/keys.js";
3
- import { TextField as c } from "../TextField/TextField.js";
4
- import { search as f } from "../../icons/search.js";
5
- import { forwardRef as s, useRef as a } from "react";
6
- import { jsx as m } from "react/jsx-runtime";
7
- var g = s(function({ onSubmit: n, clearable: i = !0, onKeyDown: o, ...u }, r) {
8
- const l = a(null);
9
- return /* @__PURE__ */ m(c, {
10
- ...u,
11
- ref: (e) => {
12
- l.current = e, typeof r == "function" ? r(e) : r && (r.current = e);
13
- },
2
+ import { LiveRegion as v } from "../../foundations/LiveRegion/LiveRegion.js";
3
+ import { useClientLayoutEffect as y } from "../../foundations/client-layout-effect.js";
4
+ import { mergeRefs as E } from "../../foundations/refs.js";
5
+ import { isComposing as a } from "../../foundations/keys.js";
6
+ import { TextField as g } from "../TextField/TextField.js";
7
+ import { search as x } from "../../icons/search.js";
8
+ import { forwardRef as b, useRef as s, useState as w } from "react";
9
+ import { Fragment as F, jsx as n, jsxs as S } from "react/jsx-runtime";
10
+ var H = b(function({ onSubmit: c, clearable: l = !0, onKeyDown: f, trailing: r, addonEnd: u, ...p }, m) {
11
+ const d = s(null), o = s(null), [i, h] = w("");
12
+ return y(() => {
13
+ const e = o.current?.textContent ?? "";
14
+ e !== i && h(e);
15
+ }), /* @__PURE__ */ n(g, {
16
+ ...p,
17
+ ref: E(d, m),
14
18
  type: "search",
15
- iconStart: f,
16
- clearable: i,
19
+ iconStart: x,
20
+ clearable: l,
21
+ addonEnd: /* @__PURE__ */ S(F, { children: [
22
+ (!!r || r === 0) && /* @__PURE__ */ n("span", {
23
+ ref: o,
24
+ className: "cy-search-field-trailing",
25
+ "aria-hidden": "true",
26
+ children: r
27
+ }),
28
+ /* @__PURE__ */ n(v, { children: i }),
29
+ u
30
+ ] }),
17
31
  onKeyDown: (e) => {
18
- o?.(e);
32
+ f?.(e);
19
33
  const t = e.currentTarget;
20
- e.key === "Enter" && !p(e) && (e.preventDefault(), n?.(t.value)), e.key === "Escape" && (e.preventDefault(), t.value ? (Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set?.call(t, ""), t.dispatchEvent(new Event("input", { bubbles: !0 }))) : t.blur());
34
+ e.key === "Enter" && !a(e) && (e.preventDefault(), c?.(t.value)), e.key === "Escape" && !a(e) && (e.preventDefault(), t.value ? (Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set?.call(t, ""), t.dispatchEvent(new Event("input", { bubbles: !0 }))) : t.blur());
21
35
  }
22
36
  });
23
37
  });
24
38
  export {
25
- g as SearchField
39
+ H as SearchField
26
40
  };
27
41
 
28
42
  //# sourceMappingURL=SearchField.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"SearchField.js","names":["isComposing","TextField","search","forwardRef","useRef","jsx","SearchField","onSubmit","clearable","onKeyDown","rest","forwarded","local","node","input"],"sources":["../../../src/components/SearchField/SearchField.tsx"],"sourcesContent":["import { forwardRef, useRef } from \"react\";\nimport { isComposing } from \"../../foundations/keys.js\";\nimport { search } from \"../../icons/search.js\";\nimport { TextField, type TextFieldProps } from \"../TextField/TextField.js\";\n\nexport interface SearchFieldProps extends Omit<TextFieldProps, \"type\" | \"iconStart\"> {\n /** Called with the current value on Enter (never while an IME composition is active). */\n onSubmit?: (value: string) => void;\n}\n\n/** TextField preset for search: search icon, clearable, Enter submits, Escape clears then blurs. */\nexport const SearchField = forwardRef<HTMLInputElement, SearchFieldProps>(function SearchField(\n { onSubmit, clearable = true, onKeyDown, ...rest },\n forwarded,\n) {\n const local = useRef<HTMLInputElement | null>(null);\n return (\n <TextField\n {...rest}\n ref={(node) => {\n local.current = node;\n if (typeof forwarded === \"function\") forwarded(node);\n else if (forwarded) forwarded.current = node;\n }}\n type=\"search\"\n iconStart={search}\n clearable={clearable}\n onKeyDown={(e) => {\n onKeyDown?.(e);\n const input = e.currentTarget;\n if (e.key === \"Enter\" && !isComposing(e)) {\n e.preventDefault();\n onSubmit?.(input.value);\n }\n if (e.key === \"Escape\") {\n e.preventDefault();\n if (input.value) {\n Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, \"value\")?.set?.call(input, \"\");\n input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n } else input.blur();\n }\n }}\n />\n );\n});\n"],"mappings":";;;;;;AAWA,IAAaM,IAAcH,EAA+C,SACxE,EAAE,UAAAI,GAAU,WAAAC,IAAY,IAAM,WAAAC,GAAW,GAAGC,EAAA,GAC5CC,GACA;AACA,QAAMC,IAAQR,EAAgC,IAAI;AAClD,SACE,gBAAAC,EAACJ,GAAD;AAAA,IACE,GAAIS;AAAA,IACJ,KAAA,CAAMG,MAAS;AACb,MAAAD,EAAM,UAAUC,GACZ,OAAOF,KAAc,aAAYA,EAAUE,CAAI,IAC1CF,MAAWA,EAAU,UAAUE;AAAA,IAC1C;AAAA,IACA,MAAK;AAAA,IACL,WAAWX;AAAA,IACA,WAAAM;AAAA,IACX,WAAA,CAAY,MAAM;AAChB,MAAAC,IAAY,CAAC;AACb,YAAMK,IAAQ,EAAE;AAChB,MAAI,EAAE,QAAQ,WAAW,CAACd,EAAY,CAAC,MACrC,EAAE,eAAe,GACjBO,IAAWO,EAAM,KAAK,IAEpB,EAAE,QAAQ,aACZ,EAAE,eAAe,GACbA,EAAM,SACR,OAAO,yBAAyB,iBAAiB,WAAW,OAAO,GAAG,KAAK,KAAKA,GAAO,EAAE,GACzFA,EAAM,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,GAAK,CAAC,CAAC,KACpDA,EAAM,KAAK;AAAA,IAEtB;AAAA,EACD,CAAA;AAEL,CAAC"}
1
+ {"version":3,"file":"SearchField.js","names":["_Fragment","LiveRegion","useClientLayoutEffect","mergeRefs","isComposing","TextField","search","forwardRef","useRef","useState","Fragment$1","jsx","jsxs","SearchField","onSubmit","clearable","onKeyDown","trailing","addonEnd","rest","forwarded","local","shown","said","setSaid","text","input"],"sources":["../../../src/components/SearchField/SearchField.tsx"],"sourcesContent":["import { forwardRef, type ReactNode, useRef, useState } from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { isComposing } from \"../../foundations/keys.js\";\nimport { LiveRegion } from \"../../foundations/LiveRegion/LiveRegion.js\";\nimport { mergeRefs } from \"../../foundations/refs.js\";\nimport { search } from \"../../icons/search.js\";\nimport { TextField, type TextFieldProps } from \"../TextField/TextField.js\";\n\nexport interface SearchFieldTokens {\n /** Colour of the trailing status text. */\n trailingColor: string;\n /** Font size of the trailing status text (a match count). */\n trailingFontSize: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n searchField: SearchFieldTokens;\n }\n}\n\nexport interface SearchFieldProps extends Omit<TextFieldProps, \"type\" | \"iconStart\"> {\n /** Called with the current value on Enter (never while an IME composition is active). */\n onSubmit?: (value: string) => void;\n /**\n * Status text inside the field, at its end: a match count such as \"3 of 12\". When its text changes it is announced\n * politely. Text only: put controls in `addonEnd`.\n */\n trailing?: ReactNode;\n}\n\n/** TextField preset for search: search icon, clearable, Enter submits, Escape clears then blurs. */\nexport const SearchField = forwardRef<HTMLInputElement, SearchFieldProps>(function SearchField(\n { onSubmit, clearable = true, onKeyDown, trailing, addonEnd, ...rest },\n forwarded,\n) {\n const local = useRef<HTMLInputElement | null>(null);\n // The visible text is hidden from assistive technology; a live region always in the page reads it once per change.\n const shown = useRef<HTMLSpanElement>(null);\n const [said, setSaid] = useState(\"\");\n useClientLayoutEffect(() => {\n const text = shown.current?.textContent ?? \"\";\n if (text !== said) setSaid(text);\n });\n return (\n <TextField\n {...rest}\n ref={mergeRefs(local, forwarded)}\n type=\"search\"\n iconStart={search}\n clearable={clearable}\n addonEnd={\n <>\n {(Boolean(trailing) || trailing === 0) && (\n <span ref={shown} className=\"cy-search-field-trailing\" aria-hidden=\"true\">\n {trailing}\n </span>\n )}\n <LiveRegion>{said}</LiveRegion>\n {addonEnd}\n </>\n }\n onKeyDown={(e) => {\n onKeyDown?.(e);\n const input = e.currentTarget;\n if (e.key === \"Enter\" && !isComposing(e)) {\n e.preventDefault();\n onSubmit?.(input.value);\n }\n // Escape while an IME composes belongs to the IME (it cancels the composition), not to the field.\n if (e.key === \"Escape\" && !isComposing(e)) {\n e.preventDefault();\n if (input.value) {\n Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, \"value\")?.set?.call(input, \"\");\n input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n } else input.blur();\n }\n }}\n />\n );\n});\n"],"mappings":";;;;;;;;;AAgCA,IAAaa,IAAcN,EAA+C,SACxE,EAAE,UAAAO,GAAU,WAAAC,IAAY,IAAM,WAAAC,GAAW,UAAAC,GAAU,UAAAC,GAAU,GAAGC,EAAA,GAChEC,GACA;AACA,QAAMC,IAAQb,EAAgC,IAAI,GAE5Cc,IAAQd,EAAwB,IAAI,GACpC,CAACe,GAAMC,CAAA,IAAWf,EAAS,EAAE;AACnC,SAAAP,EAAA,MAA4B;AAC1B,UAAMuB,IAAOH,EAAM,SAAS,eAAe;AAC3C,IAAIG,MAASF,KAAMC,EAAQC,CAAI;AAAA,EACjC,CAAC,GAEC,gBAAAd,EAACN,GAAD;AAAA,IACE,GAAIc;AAAA,IACJ,KAAKhB,EAAUkB,GAAOD,CAAS;AAAA,IAC/B,MAAK;AAAA,IACL,WAAWd;AAAA,IACA,WAAAS;AAAA,IACX,UACE,gBAAAH,EAAAZ,GAAA,EAAA,UAAA;AAAA,OACI,EAAQiB,KAAaA,MAAa,MAClC,gBAAAN,EAAC,QAAD;AAAA,QAAM,KAAKW;AAAA,QAAO,WAAU;AAAA,QAA2B,eAAY;AAAA,QAChE,UAAAL;AAAA,MACG,CAAA;AAAA,MAER,gBAAAN,EAACV,GAAD,EAAA,UAAasB,EAAiB,CAAA;AAAA,MAC7BL;AAAA,IACD,EAAA,CAAA;AAAA,IAEJ,WAAA,CAAY,MAAM;AAChB,MAAAF,IAAY,CAAC;AACb,YAAMU,IAAQ,EAAE;AAChB,MAAI,EAAE,QAAQ,WAAW,CAACtB,EAAY,CAAC,MACrC,EAAE,eAAe,GACjBU,IAAWY,EAAM,KAAK,IAGpB,EAAE,QAAQ,YAAY,CAACtB,EAAY,CAAC,MACtC,EAAE,eAAe,GACbsB,EAAM,SACR,OAAO,yBAAyB,iBAAiB,WAAW,OAAO,GAAG,KAAK,KAAKA,GAAO,EAAE,GACzFA,EAAM,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,GAAK,CAAC,CAAC,KACpDA,EAAM,KAAK;AAAA,IAEtB;AAAA,EACD,CAAA;AAEL,CAAC"}
@@ -1 +1 @@
1
- export { SearchField, type SearchFieldProps } from "./SearchField.js";
1
+ export { SearchField, type SearchFieldProps, type SearchFieldTokens } from "./SearchField.js";
@@ -0,0 +1,57 @@
1
+ import { type AriaRole, type CSSProperties, type ReactNode } from "react";
2
+ import { type Space } from "../../foundations/layout.js";
3
+ import { type ContainerProps } from "../Container/Container.js";
4
+ export interface SectionTokens {
5
+ /** Space above and below the content when the `paddingBlock` prop is not set. */
6
+ paddingBlock: string;
7
+ /** Background of `variant="surface"`. */
8
+ surface: string;
9
+ /** Background of `variant="soft"`. */
10
+ soft: string;
11
+ /** Background of `variant="accent"`. */
12
+ accent: string;
13
+ }
14
+ declare module "../../tokens/schema.js" {
15
+ interface ComponentTokens {
16
+ section: SectionTokens;
17
+ }
18
+ }
19
+ export interface SectionProps {
20
+ /**
21
+ * The band's background: `plain` (none, the page shows through), `surface`, `soft` (a quiet tint) or `accent` (a
22
+ * soft tint of the accent colour). Text colours stay readable on each. Default "plain".
23
+ */
24
+ variant?: "plain" | "surface" | "soft" | "accent";
25
+ /** Space token for the padding above and below the content. Default: the `--cy-section-padding-block` token. */
26
+ paddingBlock?: Space | undefined;
27
+ /** Put the content in a centred Container (the page column). `false` lets it fill the band. Default true. */
28
+ contained?: boolean;
29
+ /** Widest the inner Container gets (its `size`). Ignored when `contained` is false. Default "lg". */
30
+ size?: ContainerProps["size"];
31
+ /**
32
+ * The element rendered. A `section` is a region landmark only when it has a name (`aria-labelledby` or
33
+ * `aria-label`). Default "section".
34
+ */
35
+ as?: "section" | "div" | "header" | "footer" | "aside" | "article";
36
+ /** Set on the root element: the target of in-page links such as `#pricing`. */
37
+ id?: string | undefined;
38
+ /** Names the section, usually the id of its heading. */
39
+ "aria-labelledby"?: string | undefined;
40
+ /** Names the section when it has no visible heading. */
41
+ "aria-label"?: string | undefined;
42
+ /** An ARIA role for the root, when the element's own role is not the right one. */
43
+ role?: AriaRole | undefined;
44
+ /** Added to the root element, for layout. */
45
+ className?: string | undefined;
46
+ /** Layout only. Restyle through --cy-section-* tokens. */
47
+ style?: CSSProperties;
48
+ /** The section's content. */
49
+ children?: ReactNode;
50
+ /** Set on the root element, for tests. */
51
+ "data-testid"?: string;
52
+ }
53
+ /**
54
+ * A full-width band of a page: a background, space above and below, and the content in the page column. Stack
55
+ * Sections to build a landing or documentation page.
56
+ */
57
+ export declare const Section: import("react").ForwardRefExoticComponent<SectionProps & import("react").RefAttributes<HTMLElement>>;
@@ -0,0 +1,27 @@
1
+ "use client";
2
+ import { space as u } from "../../foundations/layout.js";
3
+ import { Container as v } from "../Container/Container.js";
4
+ import { forwardRef as x } from "react";
5
+ import { jsx as e } from "react/jsx-runtime";
6
+ var g = x(function({ variant: n = "plain", paddingBlock: t, contained: i = !0, size: a = "lg", as: c = "section", className: o, style: s, children: r, ...m }, f) {
7
+ const p = c, l = t ? { "--_pad-block": u(t) } : {};
8
+ return /* @__PURE__ */ e(p, {
9
+ ref: f,
10
+ ...m,
11
+ className: `cy-section${o ? ` ${o}` : ""}`,
12
+ "data-variant": n,
13
+ style: {
14
+ ...l,
15
+ ...s
16
+ },
17
+ children: i ? /* @__PURE__ */ e(v, {
18
+ size: a,
19
+ children: r
20
+ }) : r
21
+ });
22
+ });
23
+ export {
24
+ g as Section
25
+ };
26
+
27
+ //# sourceMappingURL=Section.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Section.js","names":["space","Container","forwardRef","jsx","Section","variant","paddingBlock","contained","size","as","className","style","children","rest","ref","Tag","vars"],"sources":["../../../src/components/Section/Section.tsx"],"sourcesContent":["import { type AriaRole, type CSSProperties, forwardRef, type ReactNode } from \"react\";\nimport { type Space, space } from \"../../foundations/layout.js\";\nimport { Container, type ContainerProps } from \"../Container/Container.js\";\n\nexport interface SectionTokens {\n /** Space above and below the content when the `paddingBlock` prop is not set. */\n paddingBlock: string;\n /** Background of `variant=\"surface\"`. */\n surface: string;\n /** Background of `variant=\"soft\"`. */\n soft: string;\n /** Background of `variant=\"accent\"`. */\n accent: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n section: SectionTokens;\n }\n}\n\nexport interface SectionProps {\n /**\n * The band's background: `plain` (none, the page shows through), `surface`, `soft` (a quiet tint) or `accent` (a\n * soft tint of the accent colour). Text colours stay readable on each. Default \"plain\".\n */\n variant?: \"plain\" | \"surface\" | \"soft\" | \"accent\";\n /** Space token for the padding above and below the content. Default: the `--cy-section-padding-block` token. */\n paddingBlock?: Space | undefined;\n /** Put the content in a centred Container (the page column). `false` lets it fill the band. Default true. */\n contained?: boolean;\n /** Widest the inner Container gets (its `size`). Ignored when `contained` is false. Default \"lg\". */\n size?: ContainerProps[\"size\"];\n /**\n * The element rendered. A `section` is a region landmark only when it has a name (`aria-labelledby` or\n * `aria-label`). Default \"section\".\n */\n as?: \"section\" | \"div\" | \"header\" | \"footer\" | \"aside\" | \"article\";\n /** Set on the root element: the target of in-page links such as `#pricing`. */\n id?: string | undefined;\n /** Names the section, usually the id of its heading. */\n \"aria-labelledby\"?: string | undefined;\n /** Names the section when it has no visible heading. */\n \"aria-label\"?: string | undefined;\n /** An ARIA role for the root, when the element's own role is not the right one. */\n role?: AriaRole | undefined;\n /** Added to the root element, for layout. */\n className?: string | undefined;\n /** Layout only. Restyle through --cy-section-* tokens. */\n style?: CSSProperties;\n /** The section's content. */\n children?: ReactNode;\n /** Set on the root element, for tests. */\n \"data-testid\"?: string;\n}\n\n/**\n * A full-width band of a page: a background, space above and below, and the content in the page column. Stack\n * Sections to build a landing or documentation page.\n */\nexport const Section = forwardRef<HTMLElement, SectionProps>(function Section(\n {\n variant = \"plain\",\n paddingBlock,\n contained = true,\n size = \"lg\",\n as = \"section\",\n className,\n style,\n children,\n ...rest\n },\n ref,\n) {\n const Tag = as;\n const vars = paddingBlock ? { \"--_pad-block\": space(paddingBlock) } : {};\n return (\n <Tag\n // One component, several elements: the ref is the element's own, typed as the common HTMLElement.\n ref={ref as never}\n {...rest}\n className={`cy-section${className ? ` ${className}` : \"\"}`}\n data-variant={variant}\n style={{ ...vars, ...style } as CSSProperties}\n >\n {contained ? <Container size={size}>{children}</Container> : children}\n </Tag>\n );\n});\n"],"mappings":";;;;;AA4DA,IAAaI,IAAUF,EAAsC,SAC3D,EACE,SAAAG,IAAU,SACV,cAAAC,GACA,WAAAC,IAAY,IACZ,MAAAC,IAAO,MACP,IAAAC,IAAK,WACL,WAAAC,GACA,OAAAC,GACA,UAAAC,GACA,GAAGC,EAAA,GAELC,GACA;AACA,QAAMC,IAAMN,GACNO,IAAOV,IAAe,EAAE,gBAAgBN,EAAMM,CAAY,EAAE,IAAI,CAAC;AACvE,SACE,gBAAAH,EAACY,GAAD;AAAA,IAEO,KAAAD;AAAA,IACL,GAAID;AAAA,IACJ,WAAW,aAAaH,IAAY,IAAIA,CAAA,KAAc,EAAA;AAAA,IACtD,gBAAcL;AAAA,IACd,OAAO;AAAA,MAAE,GAAGW;AAAA,MAAM,GAAGL;AAAA,IAAM;AAAA,IAE1B,UAAAJ,IAAY,gBAAAJ,EAACF,GAAD;AAAA,MAAiB,MAAAO;AAAA,MAAO,UAAAI;AAAA,IAAoB,CAAA,IAAIA;AAAA,EAC1D,CAAA;AAET,CAAC"}
@@ -0,0 +1 @@
1
+ export { Section, type SectionProps, type SectionTokens } from "./Section.js";
@@ -1,6 +1,6 @@
1
1
  import { type CSSProperties } from "react";
2
2
  import type { IconData } from "../../icons/types.js";
3
- import type { Size, Tone } from "../../tokens/schema.js";
3
+ import type { DenseSize, Tone } from "../../tokens/schema.js";
4
4
  export interface SegmentedControlTokens {
5
5
  radius: string;
6
6
  trackBg: string;
@@ -38,8 +38,11 @@ export interface SegmentedControlProps {
38
38
  fullWidth?: boolean;
39
39
  /** Disables every segment; the value is not submitted. */
40
40
  disabled?: boolean;
41
- /** Height and text size of the segments. Default "md". */
42
- size?: Size;
41
+ /**
42
+ * Height and text size of the segments. Default "md". `xs` (about 20px) is for dense desktop chrome: each segment is
43
+ * still 24px to press (44px on coarse pointers).
44
+ */
45
+ size?: DenseSize;
43
46
  /** Colour of the active segment's content. */
44
47
  tone?: Tone;
45
48
  /** Added to the root element, for layout. */
@@ -1,17 +1,18 @@
1
1
  "use client";
2
2
  import { useControllableState as x } from "../../foundations/controllable.js";
3
3
  import { Icon as N } from "../../foundations/Icon/Icon.js";
4
+ import { iconSizeFor as S } from "../../foundations/icon-size.js";
4
5
  import { ChoiceBase as j } from "../../foundations/ChoiceBase/ChoiceBase.js";
5
6
  import { HiddenValue as k } from "../../foundations/HiddenValue/HiddenValue.js";
6
- import { useId as I } from "react";
7
- import { jsx as a, jsxs as t } from "react/jsx-runtime";
8
- function R({ label: i, options: n, name: u, value: o, defaultValue: s, onChange: v, iconOnly: c = !1, fullWidth: b = !1, disabled: l, size: f = "md", tone: g = "neutral", className: m, style: h }) {
9
- const r = `cy-seg-${I()}`, [d, $, y] = x(o, s, v);
10
- return /* @__PURE__ */ t("div", {
7
+ import { useId as p } from "react";
8
+ import { jsx as a, jsxs as m } from "react/jsx-runtime";
9
+ function q({ label: n, options: i, name: u, value: v, defaultValue: t, onChange: f, iconOnly: c = !1, fullWidth: b = !1, disabled: r, size: o = "md", tone: g = "neutral", className: s, style: h }) {
10
+ const l = `cy-seg-${p()}`, [d, $, y] = x(v, t, f);
11
+ return /* @__PURE__ */ m("div", {
11
12
  role: "radiogroup",
12
- "aria-label": i,
13
- className: `cy-segmented${m ? ` ${m}` : ""}`,
14
- "data-size": f,
13
+ "aria-label": n,
14
+ className: `cy-segmented-control${s ? ` ${s}` : ""}`,
15
+ "data-size": o,
15
16
  "data-tone": g,
16
17
  "data-full": b ? "" : void 0,
17
18
  "data-icon-only": c ? "" : void 0,
@@ -19,27 +20,30 @@ function R({ label: i, options: n, name: u, value: o, defaultValue: s, onChange:
19
20
  children: [/* @__PURE__ */ a(k, {
20
21
  name: u,
21
22
  value: d ?? "",
22
- disabled: l || d === void 0,
23
- onReset: () => y(s)
24
- }), n.map((e) => /* @__PURE__ */ t("label", {
25
- htmlFor: `${r}-${e.value}`,
26
- className: "cy-segment",
27
- "data-disabled": l || e.disabled ? "" : void 0,
23
+ disabled: r || d === void 0,
24
+ onReset: () => y(t)
25
+ }), i.map((e) => /* @__PURE__ */ m("label", {
26
+ htmlFor: `${l}-${e.value}`,
27
+ className: "cy-segmented-control-segment",
28
+ "data-disabled": r || e.disabled ? "" : void 0,
28
29
  children: [
29
30
  /* @__PURE__ */ a(j, {
30
- id: `${r}-${e.value}`,
31
+ id: `${l}-${e.value}`,
31
32
  type: "radio",
32
- name: r,
33
+ name: l,
33
34
  form: "",
34
35
  value: e.value,
35
- disabled: l || e.disabled,
36
+ disabled: r || e.disabled,
36
37
  "aria-label": e.label,
37
38
  checked: d === e.value,
38
39
  onChange: (C) => C.currentTarget.checked && $(e.value)
39
40
  }),
40
- e.icon && /* @__PURE__ */ a(N, { icon: e.icon }),
41
+ e.icon && /* @__PURE__ */ a(N, {
42
+ icon: e.icon,
43
+ size: S(o)
44
+ }),
41
45
  !c && /* @__PURE__ */ a("span", {
42
- className: "cy-segment-label",
46
+ className: "cy-segmented-control-label",
43
47
  children: e.label
44
48
  })
45
49
  ]
@@ -47,7 +51,7 @@ function R({ label: i, options: n, name: u, value: o, defaultValue: s, onChange:
47
51
  });
48
52
  }
49
53
  export {
50
- R as SegmentedControl
54
+ q as SegmentedControl
51
55
  };
52
56
 
53
57
  //# sourceMappingURL=SegmentedControl.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"SegmentedControl.js","names":["useControllableState","Icon","ChoiceBase","HiddenValue","useId","jsx","jsxs","SegmentedControl","label","options","name","value","defaultValue","onChange","iconOnly","fullWidth","disabled","size","tone","className","style","groupName","current","setCurrent","reset","option","e"],"sources":["../../../src/components/SegmentedControl/SegmentedControl.tsx"],"sourcesContent":["import { type CSSProperties, useId } from \"react\";\nimport { ChoiceBase } from \"../../foundations/ChoiceBase/ChoiceBase.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size, Tone } from \"../../tokens/schema.js\";\n\nexport interface SegmentedControlTokens {\n radius: string;\n trackBg: string;\n activeBg: string;\n padding: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n segmentedControl: SegmentedControlTokens;\n }\n}\n\nexport interface SegmentOption {\n value: string;\n /** Visible text, and always the accessible name (also for icon-only segments). */\n label: string;\n icon?: IconData;\n disabled?: boolean;\n}\n\nexport interface SegmentedControlProps {\n /** Accessible name of the group. */\n label: string;\n /** The segments: `{ value, label, icon?, disabled? }`. */\n options: SegmentOption[];\n /** Submits the value with its form under this name. Two controls may share a name and stay independent. */\n name?: string;\n /** Controlled selected value. */\n value?: string;\n /** Selected value at first, when uncontrolled. */\n defaultValue?: string;\n /** Called with the segment's value when it is chosen. */\n onChange?: (value: string) => void;\n /** Show icons only; labels stay as accessible names. */\n iconOnly?: boolean;\n /** Stretch to the full width of the container. */\n fullWidth?: boolean;\n /** Disables every segment; the value is not submitted. */\n disabled?: boolean;\n /** Height and text size of the segments. Default \"md\". */\n size?: Size;\n /** Colour of the active segment's content. */\n tone?: Tone;\n /** Added to the root element, for layout. */\n className?: string | undefined;\n /** Layout only. */\n style?: CSSProperties | undefined;\n}\n\n/** A compact single choice (view switchers, modes) on native radios. */\nexport function SegmentedControl({\n label,\n options,\n name,\n value,\n defaultValue,\n onChange,\n iconOnly = false,\n fullWidth = false,\n disabled,\n size = \"md\",\n tone = \"neutral\",\n className,\n style,\n}: SegmentedControlProps) {\n // The radios are grouped under a name of the control's own, never the caller's: two controls given the same\n // `name` (rows of a list, two panels) would otherwise be one native radio group with clashing ids, and choosing in\n // one would clear the other. The caller's `name` submits the value through a hidden field instead.\n const groupName = `cy-seg-${useId()}`;\n const [current, setCurrent, reset] = useControllableState<string, string | undefined>(\n value,\n defaultValue,\n onChange,\n );\n return (\n <div\n role=\"radiogroup\"\n aria-label={label}\n className={`cy-segmented${className ? ` ${className}` : \"\"}`}\n data-size={size}\n data-tone={tone}\n data-full={fullWidth ? \"\" : undefined}\n data-icon-only={iconOnly ? \"\" : undefined}\n style={style}\n >\n {/* Always present, so a form's reset restores the default; it submits only when there is a name and a value. */}\n <HiddenValue\n name={name}\n value={current ?? \"\"}\n disabled={disabled || current === undefined}\n onReset={() => reset(defaultValue)}\n />\n {options.map((option) => (\n <label\n key={option.value}\n htmlFor={`${groupName}-${option.value}`}\n className=\"cy-segment\"\n data-disabled={disabled || option.disabled ? \"\" : undefined}\n >\n <ChoiceBase\n id={`${groupName}-${option.value}`}\n type=\"radio\"\n name={groupName}\n // Belongs to no form: the hidden field above submits the value under the caller's name.\n form=\"\"\n value={option.value}\n disabled={disabled || option.disabled}\n aria-label={option.label}\n checked={current === option.value}\n onChange={(e) => e.currentTarget.checked && setCurrent(option.value)}\n />\n {option.icon && <Icon icon={option.icon} />}\n {!iconOnly && <span className=\"cy-segment-label\">{option.label}</span>}\n </label>\n ))}\n </div>\n );\n}\n"],"mappings":";;;;;;;AA2DA,SAAgBO,EAAiB,EAC/B,OAAAC,GACA,SAAAC,GACA,MAAAC,GACA,OAAAC,GACA,cAAAC,GACA,UAAAC,GACA,UAAAC,IAAW,IACX,WAAAC,IAAY,IACZ,UAAAC,GACA,MAAAC,IAAO,MACP,MAAAC,IAAO,WACP,WAAAC,GACA,OAAAC,EAAA,GACwB;AAIxB,QAAMC,IAAY,UAAUjB,EAAM,CAAA,IAC5B,CAACkB,GAASC,GAAYC,CAAA,IAASxB,EACnCW,GACAC,GACAC,CACF;AACA,SACE,gBAAAP,EAAC,OAAD;AAAA,IACE,MAAK;AAAA,IACL,cAAYE;AAAA,IACZ,WAAW,eAAeW,IAAY,IAAIA,CAAA,KAAc,EAAA;AAAA,IACxD,aAAWF;AAAA,IACX,aAAWC;AAAA,IACX,aAAWH,IAAY,KAAK;AAAA,IAC5B,kBAAgBD,IAAW,KAAK;AAAA,IACzB,OAAAM;AAAA,IART,UAAA,CAWE,gBAAAf,EAACF,GAAD;AAAA,MACQ,MAAAO;AAAA,MACN,OAAOY,KAAW;AAAA,MAClB,UAAUN,KAAYM,MAAY;AAAA,MAClC,SAAA,MAAeE,EAAMZ,CAAY;AAAA,IAClC,CAAA,GACAH,EAAQ,IAAA,CAAKgB,MACZ,gBAAAnB,EAAC,SAAD;AAAA,MAEE,SAAS,GAAGe,CAAA,IAAaI,EAAO,KAAA;AAAA,MAChC,WAAU;AAAA,MACV,iBAAeT,KAAYS,EAAO,WAAW,KAAK;AAAA,MAJpD,UAAA;AAAA,QAME,gBAAApB,EAACH,GAAD;AAAA,UACE,IAAI,GAAGmB,CAAA,IAAaI,EAAO,KAAA;AAAA,UAC3B,MAAK;AAAA,UACL,MAAMJ;AAAA,UAEN,MAAK;AAAA,UACL,OAAOI,EAAO;AAAA,UACd,UAAUT,KAAYS,EAAO;AAAA,UAC7B,cAAYA,EAAO;AAAA,UACnB,SAASH,MAAYG,EAAO;AAAA,UAC5B,UAAA,CAAWC,MAAMA,EAAE,cAAc,WAAWH,EAAWE,EAAO,KAAK;AAAA,QACpE,CAAA;AAAA,QACAA,EAAO,QAAQ,gBAAApB,EAACJ,GAAD,EAAM,MAAMwB,EAAO,KAAO,CAAA;AAAA,QACzC,CAACX,KAAY,gBAAAT,EAAC,QAAD;AAAA,UAAM,WAAU;AAAA,UAAoB,UAAAoB,EAAO;AAAA,QAAY,CAAA;AAAA,MAChE;AAAA,IAnBA,GAAAA,EAAO,KAmBP,CACR,CACE;AAAA,E;AAET"}
1
+ {"version":3,"file":"SegmentedControl.js","names":["useControllableState","Icon","iconSizeFor","ChoiceBase","HiddenValue","useId","jsx","jsxs","SegmentedControl","label","options","name","value","defaultValue","onChange","iconOnly","fullWidth","disabled","size","tone","className","style","groupName","current","setCurrent","reset","option","e"],"sources":["../../../src/components/SegmentedControl/SegmentedControl.tsx"],"sourcesContent":["import { type CSSProperties, useId } from \"react\";\nimport { ChoiceBase } from \"../../foundations/ChoiceBase/ChoiceBase.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { iconSizeFor } from \"../../foundations/icon-size.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { DenseSize, Tone } from \"../../tokens/schema.js\";\n\nexport interface SegmentedControlTokens {\n radius: string;\n trackBg: string;\n activeBg: string;\n padding: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n segmentedControl: SegmentedControlTokens;\n }\n}\n\nexport interface SegmentOption {\n value: string;\n /** Visible text, and always the accessible name (also for icon-only segments). */\n label: string;\n icon?: IconData;\n disabled?: boolean;\n}\n\nexport interface SegmentedControlProps {\n /** Accessible name of the group. */\n label: string;\n /** The segments: `{ value, label, icon?, disabled? }`. */\n options: SegmentOption[];\n /** Submits the value with its form under this name. Two controls may share a name and stay independent. */\n name?: string;\n /** Controlled selected value. */\n value?: string;\n /** Selected value at first, when uncontrolled. */\n defaultValue?: string;\n /** Called with the segment's value when it is chosen. */\n onChange?: (value: string) => void;\n /** Show icons only; labels stay as accessible names. */\n iconOnly?: boolean;\n /** Stretch to the full width of the container. */\n fullWidth?: boolean;\n /** Disables every segment; the value is not submitted. */\n disabled?: boolean;\n /**\n * Height and text size of the segments. Default \"md\". `xs` (about 20px) is for dense desktop chrome: each segment is\n * still 24px to press (44px on coarse pointers).\n */\n size?: DenseSize;\n /** Colour of the active segment's content. */\n tone?: Tone;\n /** Added to the root element, for layout. */\n className?: string | undefined;\n /** Layout only. */\n style?: CSSProperties | undefined;\n}\n\n/** A compact single choice (view switchers, modes) on native radios. */\nexport function SegmentedControl({\n label,\n options,\n name,\n value,\n defaultValue,\n onChange,\n iconOnly = false,\n fullWidth = false,\n disabled,\n size = \"md\",\n tone = \"neutral\",\n className,\n style,\n}: SegmentedControlProps) {\n // The radios are grouped under a name of the control's own, never the caller's: two controls given the same\n // `name` (rows of a list, two panels) would otherwise be one native radio group with clashing ids, and choosing in\n // one would clear the other. The caller's `name` submits the value through a hidden field instead.\n const groupName = `cy-seg-${useId()}`;\n const [current, setCurrent, reset] = useControllableState<string, string | undefined>(\n value,\n defaultValue,\n onChange,\n );\n return (\n <div\n role=\"radiogroup\"\n aria-label={label}\n className={`cy-segmented-control${className ? ` ${className}` : \"\"}`}\n data-size={size}\n data-tone={tone}\n data-full={fullWidth ? \"\" : undefined}\n data-icon-only={iconOnly ? \"\" : undefined}\n style={style}\n >\n {/* Always present, so a form's reset restores the default; it submits only when there is a name and a value. */}\n <HiddenValue\n name={name}\n value={current ?? \"\"}\n disabled={disabled || current === undefined}\n onReset={() => reset(defaultValue)}\n />\n {options.map((option) => (\n <label\n key={option.value}\n htmlFor={`${groupName}-${option.value}`}\n className=\"cy-segmented-control-segment\"\n data-disabled={disabled || option.disabled ? \"\" : undefined}\n >\n <ChoiceBase\n id={`${groupName}-${option.value}`}\n type=\"radio\"\n name={groupName}\n // Belongs to no form: the hidden field above submits the value under the caller's name.\n form=\"\"\n value={option.value}\n disabled={disabled || option.disabled}\n aria-label={option.label}\n checked={current === option.value}\n onChange={(e) => e.currentTarget.checked && setCurrent(option.value)}\n />\n {option.icon && <Icon icon={option.icon} size={iconSizeFor(size)} />}\n {!iconOnly && <span className=\"cy-segmented-control-label\">{option.label}</span>}\n </label>\n ))}\n </div>\n );\n}\n"],"mappings":";;;;;;;;AA+DA,SAAgBQ,EAAiB,EAC/B,OAAAC,GACA,SAAAC,GACA,MAAAC,GACA,OAAAC,GACA,cAAAC,GACA,UAAAC,GACA,UAAAC,IAAW,IACX,WAAAC,IAAY,IACZ,UAAAC,GACA,MAAAC,IAAO,MACP,MAAAC,IAAO,WACP,WAAAC,GACA,OAAAC,EAAA,GACwB;AAIxB,QAAMC,IAAY,UAAUjB,EAAM,CAAA,IAC5B,CAACkB,GAASC,GAAYC,CAAA,IAASzB,EACnCY,GACAC,GACAC,CACF;AACA,SACE,gBAAAP,EAAC,OAAD;AAAA,IACE,MAAK;AAAA,IACL,cAAYE;AAAA,IACZ,WAAW,uBAAuBW,IAAY,IAAIA,CAAA,KAAc,EAAA;AAAA,IAChE,aAAWF;AAAA,IACX,aAAWC;AAAA,IACX,aAAWH,IAAY,KAAK;AAAA,IAC5B,kBAAgBD,IAAW,KAAK;AAAA,IACzB,OAAAM;AAAA,IART,UAAA,CAWE,gBAAAf,EAACF,GAAD;AAAA,MACQ,MAAAO;AAAA,MACN,OAAOY,KAAW;AAAA,MAClB,UAAUN,KAAYM,MAAY;AAAA,MAClC,SAAA,MAAeE,EAAMZ,CAAY;AAAA,IAClC,CAAA,GACAH,EAAQ,IAAA,CAAKgB,MACZ,gBAAAnB,EAAC,SAAD;AAAA,MAEE,SAAS,GAAGe,CAAA,IAAaI,EAAO,KAAA;AAAA,MAChC,WAAU;AAAA,MACV,iBAAeT,KAAYS,EAAO,WAAW,KAAK;AAAA,MAJpD,UAAA;AAAA,QAME,gBAAApB,EAACH,GAAD;AAAA,UACE,IAAI,GAAGmB,CAAA,IAAaI,EAAO,KAAA;AAAA,UAC3B,MAAK;AAAA,UACL,MAAMJ;AAAA,UAEN,MAAK;AAAA,UACL,OAAOI,EAAO;AAAA,UACd,UAAUT,KAAYS,EAAO;AAAA,UAC7B,cAAYA,EAAO;AAAA,UACnB,SAASH,MAAYG,EAAO;AAAA,UAC5B,UAAA,CAAWC,MAAMA,EAAE,cAAc,WAAWH,EAAWE,EAAO,KAAK;AAAA,QACpE,CAAA;AAAA,QACAA,EAAO,QAAQ,gBAAApB,EAACL,GAAD;AAAA,UAAM,MAAMyB,EAAO;AAAA,UAAM,MAAMxB,EAAYgB,CAAI;AAAA,QAAI,CAAA;AAAA,QAClE,CAACH,KAAY,gBAAAT,EAAC,QAAD;AAAA,UAAM,WAAU;AAAA,UAA8B,UAAAoB,EAAO;AAAA,QAAY,CAAA;AAAA,MAC1E;AAAA,IAnBA,GAAAA,EAAO,KAmBP,CACR,CACE;AAAA,E;AAET"}
@@ -1,7 +1,9 @@
1
1
  import { type CSSProperties, type ReactNode } from "react";
2
2
  import { type OptionIconColor } from "../../foundations/option-icon.js";
3
3
  import type { IconData } from "../../icons/types.js";
4
- import type { Size } from "../../tokens/schema.js";
4
+ import type { DenseSize } from "../../tokens/schema.js";
5
+ import { type FieldLayoutProps } from "../Field/Field.js";
6
+ import { type OptionListAction } from "../OptionList/OptionList.js";
5
7
  export interface SelectTokens {
6
8
  radius: string;
7
9
  bg: string;
@@ -23,10 +25,14 @@ export interface SelectOption extends OptionIconColor {
23
25
  /** Icon before the label, in the list and in the trigger when chosen. Colour it with `iconTone` or `iconColor`. */
24
26
  icon?: IconData;
25
27
  disabled?: boolean;
28
+ /** Drawn muted in the list but still choosable: an option that is there but not in use. */
29
+ dimmed?: boolean;
30
+ /** At the end of the option's row in the list, smaller and muted: a shortcut, a count. */
31
+ trailing?: ReactNode;
26
32
  /** Options next to each other with the same `group` are listed under that heading. */
27
33
  group?: string;
28
34
  }
29
- export interface SelectProps {
35
+ export interface SelectProps extends FieldLayoutProps {
30
36
  /** Names the control, shown above it. */
31
37
  label: ReactNode;
32
38
  /** Visually hide the label (it still names the control). Prefer visible labels. */
@@ -35,8 +41,15 @@ export interface SelectProps {
35
41
  description?: ReactNode;
36
42
  /** Your own error; it replaces the built-in required message. */
37
43
  error?: ReactNode;
38
- /** The choices: `{ value, label, description?, icon?, iconTone?, iconColor?, disabled?, group? }`. */
44
+ /**
45
+ * The choices: `{ value, label, description?, icon?, iconTone?, iconColor?, disabled?, dimmed?, trailing?, group? }`.
46
+ */
39
47
  options: SelectOption[];
48
+ /**
49
+ * An action pinned under the options ("Manage connections…"): the arrow keys' last stop, run with Enter, Space or a
50
+ * press. The list closes, focus returns to the trigger, and the value does not change.
51
+ */
52
+ footer?: OptionListAction | undefined;
40
53
  /** Controlled selected value. */
41
54
  value?: string;
42
55
  /** Selected value at first, when uncontrolled. */
@@ -51,8 +64,11 @@ export interface SelectProps {
51
64
  required?: boolean;
52
65
  /** Cannot be opened or changed, and is not submitted. */
53
66
  disabled?: boolean;
54
- /** Height and text size of the control. Default "md". */
55
- size?: Size;
67
+ /**
68
+ * Height and text size of the control. Default "md". `xs` (about 20px) is for dense desktop chrome: the trigger is
69
+ * still 24px to press (44px on coarse pointers); its label is set as for `sm`.
70
+ */
71
+ size?: DenseSize;
56
72
  /** `outline`, or `soft` (tinted, no border). Default "outline". */
57
73
  variant?: "outline" | "soft";
58
74
  /** Replace the built-in English text: the placeholder, the empty list and the required message. */
@@ -66,4 +82,4 @@ export interface SelectProps {
66
82
  /** Layout only. */
67
83
  style?: CSSProperties;
68
84
  }
69
- export declare function Select({ label, labelHidden, description, error, options, value, defaultValue, onChange, placeholder, name, required, disabled, size, variant, labels, className, style, }: SelectProps): import("react").JSX.Element;
85
+ export declare function Select({ label, labelHidden, description, layout, width, error, options, footer, value, defaultValue, onChange, placeholder, name, required, disabled, size, variant, labels, className, style, }: SelectProps): import("react").JSX.Element;