@arshad-shah/cynosure 0.2.0 → 0.4.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 (441) hide show
  1. package/README.md +5 -5
  2. package/dist/adapters/astro/index.d.ts +52 -0
  3. package/dist/adapters/astro/index.js +27 -0
  4. package/dist/adapters/astro/index.js.map +1 -0
  5. package/dist/adapters/vite/index.d.ts +11 -0
  6. package/dist/adapters/vite/index.js +33 -12
  7. package/dist/adapters/vite/index.js.map +1 -1
  8. package/dist/brands/googleplay.d.ts +2 -0
  9. package/dist/brands/googleplay.js +17 -0
  10. package/dist/brands/googleplay.js.map +1 -0
  11. package/dist/brands/index.d.ts +1 -0
  12. package/dist/brands/index.js +132 -130
  13. package/dist/components/Accordion/Accordion.d.ts +14 -0
  14. package/dist/components/Accordion/Accordion.js.map +1 -1
  15. package/dist/components/Announcer/Announcer.d.ts +1 -0
  16. package/dist/components/Announcer/Announcer.js +5 -5
  17. package/dist/components/Announcer/Announcer.js.map +1 -1
  18. package/dist/components/AppShell/AppShell.d.ts +22 -1
  19. package/dist/components/AppShell/AppShell.js +92 -83
  20. package/dist/components/AppShell/AppShell.js.map +1 -1
  21. package/dist/components/AppShell/index.d.ts +1 -1
  22. package/dist/components/AspectRatio/AspectRatio.d.ts +29 -0
  23. package/dist/components/AspectRatio/AspectRatio.js +21 -0
  24. package/dist/components/AspectRatio/AspectRatio.js.map +1 -0
  25. package/dist/components/AspectRatio/index.d.ts +1 -0
  26. package/dist/components/Avatar/Avatar.d.ts +96 -0
  27. package/dist/components/Avatar/Avatar.js +90 -0
  28. package/dist/components/Avatar/Avatar.js.map +1 -0
  29. package/dist/components/Avatar/index.d.ts +1 -0
  30. package/dist/components/Badge/Badge.d.ts +6 -0
  31. package/dist/components/Badge/Badge.js.map +1 -1
  32. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +55 -0
  33. package/dist/components/Breadcrumbs/Breadcrumbs.js +85 -0
  34. package/dist/components/Breadcrumbs/Breadcrumbs.js.map +1 -0
  35. package/dist/components/Breadcrumbs/index.d.ts +1 -0
  36. package/dist/components/Button/Button.d.ts +27 -2
  37. package/dist/components/Button/Button.js +62 -53
  38. package/dist/components/Button/Button.js.map +1 -1
  39. package/dist/components/Calendar/Calendar.d.ts +65 -7
  40. package/dist/components/Calendar/Calendar.js +209 -97
  41. package/dist/components/Calendar/Calendar.js.map +1 -1
  42. package/dist/components/Calendar/dates.d.ts +4 -0
  43. package/dist/components/Calendar/dates.js +41 -27
  44. package/dist/components/Calendar/dates.js.map +1 -1
  45. package/dist/components/Calendar/index.d.ts +1 -1
  46. package/dist/components/Card/Card.d.ts +35 -1
  47. package/dist/components/Card/Card.js +48 -36
  48. package/dist/components/Card/Card.js.map +1 -1
  49. package/dist/components/Card/index.d.ts +1 -1
  50. package/dist/components/Checkbox/Checkbox.d.ts +11 -4
  51. package/dist/components/Checkbox/Checkbox.js +33 -7
  52. package/dist/components/Checkbox/Checkbox.js.map +1 -1
  53. package/dist/components/Checklist/Checklist.d.ts +65 -0
  54. package/dist/components/Checklist/Checklist.js +163 -0
  55. package/dist/components/Checklist/Checklist.js.map +1 -0
  56. package/dist/components/Checklist/index.d.ts +1 -0
  57. package/dist/components/Choice/Choice.d.ts +73 -0
  58. package/dist/components/Choice/Choice.js +41 -0
  59. package/dist/components/Choice/Choice.js.map +1 -0
  60. package/dist/components/Choice/index.d.ts +1 -0
  61. package/dist/components/CodeBlock/CodeBlock.d.ts +5 -0
  62. package/dist/components/CodeBlock/CodeBlock.js.map +1 -1
  63. package/dist/components/ColorField/ColorField.d.ts +12 -0
  64. package/dist/components/ColorField/ColorField.js +199 -208
  65. package/dist/components/ColorField/ColorField.js.map +1 -1
  66. package/dist/components/ColorSwatches/ColorSwatches.d.ts +5 -0
  67. package/dist/components/ColorSwatches/ColorSwatches.js +6 -6
  68. package/dist/components/ColorSwatches/ColorSwatches.js.map +1 -1
  69. package/dist/components/Combobox/Combobox.d.ts +20 -1
  70. package/dist/components/Combobox/Combobox.js +86 -111
  71. package/dist/components/Combobox/Combobox.js.map +1 -1
  72. package/dist/components/CommandPalette/CommandPalette.d.ts +9 -0
  73. package/dist/components/CommandPalette/CommandPalette.js +10 -10
  74. package/dist/components/CommandPalette/CommandPalette.js.map +1 -1
  75. package/dist/components/CompareSlider/CompareSlider.d.ts +4 -0
  76. package/dist/components/CompareSlider/CompareSlider.js +4 -4
  77. package/dist/components/CompareSlider/CompareSlider.js.map +1 -1
  78. package/dist/components/Container/Container.d.ts +44 -0
  79. package/dist/components/Container/Container.js +28 -0
  80. package/dist/components/Container/Container.js.map +1 -0
  81. package/dist/components/Container/index.d.ts +1 -0
  82. package/dist/components/ContextMenu/ContextMenu.d.ts +11 -0
  83. package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
  84. package/dist/components/CopyButton/CopyButton.d.ts +8 -0
  85. package/dist/components/CopyButton/CopyButton.js +29 -28
  86. package/dist/components/CopyButton/CopyButton.js.map +1 -1
  87. package/dist/components/DateField/DateField.d.ts +17 -0
  88. package/dist/components/DateField/DateField.js +6 -6
  89. package/dist/components/DateField/DateField.js.map +1 -1
  90. package/dist/components/DescriptionList/DescriptionList.d.ts +3 -0
  91. package/dist/components/DescriptionList/DescriptionList.js.map +1 -1
  92. package/dist/components/DeviceFrame/DeviceFrame.d.ts +63 -0
  93. package/dist/components/DeviceFrame/DeviceFrame.js +54 -0
  94. package/dist/components/DeviceFrame/DeviceFrame.js.map +1 -0
  95. package/dist/components/DeviceFrame/index.d.ts +1 -0
  96. package/dist/components/Dialog/Dialog.d.ts +25 -2
  97. package/dist/components/Dialog/Dialog.js +89 -72
  98. package/dist/components/Dialog/Dialog.js.map +1 -1
  99. package/dist/components/Disclosure/Disclosure.d.ts +7 -0
  100. package/dist/components/Disclosure/Disclosure.js.map +1 -1
  101. package/dist/components/Divider/Divider.d.ts +59 -0
  102. package/dist/components/Divider/Divider.js +32 -0
  103. package/dist/components/Divider/Divider.js.map +1 -0
  104. package/dist/components/Divider/index.d.ts +1 -0
  105. package/dist/components/DocumentViewport/DocumentViewport.d.ts +8 -0
  106. package/dist/components/DocumentViewport/DocumentViewport.js.map +1 -1
  107. package/dist/components/EmptyState/EmptyState.d.ts +8 -2
  108. package/dist/components/EmptyState/EmptyState.js.map +1 -1
  109. package/dist/components/Field/Field.d.ts +6 -0
  110. package/dist/components/Field/Field.js +31 -33
  111. package/dist/components/Field/Field.js.map +1 -1
  112. package/dist/components/FileDrop/FileDrop.d.ts +8 -0
  113. package/dist/components/FileDrop/FileDrop.js +14 -14
  114. package/dist/components/FileDrop/FileDrop.js.map +1 -1
  115. package/dist/components/FloatingToolbar/FloatingToolbar.d.ts +4 -0
  116. package/dist/components/FloatingToolbar/FloatingToolbar.js +11 -10
  117. package/dist/components/FloatingToolbar/FloatingToolbar.js.map +1 -1
  118. package/dist/components/Grid/Grid.d.ts +57 -10
  119. package/dist/components/Grid/Grid.js +71 -28
  120. package/dist/components/Grid/Grid.js.map +1 -1
  121. package/dist/components/Grid/index.d.ts +1 -1
  122. package/dist/components/Heading/Heading.d.ts +59 -0
  123. package/dist/components/Heading/Heading.js +33 -0
  124. package/dist/components/Heading/Heading.js.map +1 -0
  125. package/dist/components/Heading/index.d.ts +1 -0
  126. package/dist/components/HoverCard/HoverCard.d.ts +1 -0
  127. package/dist/components/HoverCard/HoverCard.js.map +1 -1
  128. package/dist/components/IconButton/IconButton.d.ts +17 -1
  129. package/dist/components/IconButton/IconButton.js +14 -10
  130. package/dist/components/IconButton/IconButton.js.map +1 -1
  131. package/dist/components/IconTile/IconTile.d.ts +45 -0
  132. package/dist/components/IconTile/IconTile.js +25 -0
  133. package/dist/components/IconTile/IconTile.js.map +1 -0
  134. package/dist/components/IconTile/index.d.ts +1 -0
  135. package/dist/components/Image/Image.d.ts +62 -0
  136. package/dist/components/Image/Image.js +75 -0
  137. package/dist/components/Image/Image.js.map +1 -0
  138. package/dist/components/Image/index.d.ts +1 -0
  139. package/dist/components/Inline/Inline.d.ts +8 -4
  140. package/dist/components/Inline/Inline.js +12 -16
  141. package/dist/components/Inline/Inline.js.map +1 -1
  142. package/dist/components/Kbd/Kbd.d.ts +2 -0
  143. package/dist/components/Kbd/Kbd.js.map +1 -1
  144. package/dist/components/KeyValueEditor/KeyValueEditor.d.ts +7 -0
  145. package/dist/components/KeyValueEditor/KeyValueEditor.js +43 -42
  146. package/dist/components/KeyValueEditor/KeyValueEditor.js.map +1 -1
  147. package/dist/components/Link/Link.d.ts +16 -1
  148. package/dist/components/Link/Link.js +20 -18
  149. package/dist/components/Link/Link.js.map +1 -1
  150. package/dist/components/List/List.d.ts +73 -0
  151. package/dist/components/List/List.js +64 -0
  152. package/dist/components/List/List.js.map +1 -0
  153. package/dist/components/List/index.d.ts +1 -0
  154. package/dist/components/LoadingDots/LoadingDots.d.ts +2 -0
  155. package/dist/components/LoadingDots/LoadingDots.js.map +1 -1
  156. package/dist/components/Menu/Menu.d.ts +13 -1
  157. package/dist/components/Menu/Menu.js +37 -35
  158. package/dist/components/Menu/Menu.js.map +1 -1
  159. package/dist/components/Notice/Notice.d.ts +5 -0
  160. package/dist/components/Notice/Notice.js +12 -11
  161. package/dist/components/Notice/Notice.js.map +1 -1
  162. package/dist/components/NumberField/NumberField.d.ts +17 -0
  163. package/dist/components/NumberField/NumberField.js +8 -8
  164. package/dist/components/NumberField/NumberField.js.map +1 -1
  165. package/dist/components/OptionList/OptionList.d.ts +69 -0
  166. package/dist/components/OptionList/OptionList.js +75 -0
  167. package/dist/components/OptionList/OptionList.js.map +1 -0
  168. package/dist/components/OptionList/index.d.ts +1 -0
  169. package/dist/components/PageHeader/PageHeader.d.ts +67 -0
  170. package/dist/components/PageHeader/PageHeader.js +63 -0
  171. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  172. package/dist/components/PageHeader/index.d.ts +1 -0
  173. package/dist/components/Pagination/Pagination.d.ts +77 -0
  174. package/dist/components/Pagination/Pagination.js +121 -0
  175. package/dist/components/Pagination/Pagination.js.map +1 -0
  176. package/dist/components/Pagination/index.d.ts +1 -0
  177. package/dist/components/PanZoomCanvas/PanZoomCanvas.d.ts +4 -0
  178. package/dist/components/PanZoomCanvas/PanZoomCanvas.js.map +1 -1
  179. package/dist/components/Popover/Popover.d.ts +10 -0
  180. package/dist/components/Popover/Popover.js.map +1 -1
  181. package/dist/components/ProgressBar/ProgressBar.d.ts +5 -0
  182. package/dist/components/ProgressBar/ProgressBar.js.map +1 -1
  183. package/dist/components/ProgressOverlay/ProgressOverlay.d.ts +3 -0
  184. package/dist/components/ProgressOverlay/ProgressOverlay.js.map +1 -1
  185. package/dist/components/Prose/Prose.d.ts +1 -0
  186. package/dist/components/Prose/Prose.js.map +1 -1
  187. package/dist/components/QRCode/QRCode.d.ts +56 -0
  188. package/dist/components/QRCode/QRCode.js +48 -0
  189. package/dist/components/QRCode/QRCode.js.map +1 -0
  190. package/dist/components/QRCode/index.d.ts +1 -0
  191. package/dist/components/RadioGroup/RadioGroup.d.ts +13 -0
  192. package/dist/components/RadioGroup/RadioGroup.js +32 -24
  193. package/dist/components/RadioGroup/RadioGroup.js.map +1 -1
  194. package/dist/components/Section/Section.d.ts +57 -0
  195. package/dist/components/Section/Section.js +27 -0
  196. package/dist/components/Section/Section.js.map +1 -0
  197. package/dist/components/Section/index.d.ts +1 -0
  198. package/dist/components/SegmentedControl/SegmentedControl.d.ts +9 -0
  199. package/dist/components/SegmentedControl/SegmentedControl.js +12 -12
  200. package/dist/components/SegmentedControl/SegmentedControl.js.map +1 -1
  201. package/dist/components/Select/Select.d.ts +18 -1
  202. package/dist/components/Select/Select.js +107 -125
  203. package/dist/components/Select/Select.js.map +1 -1
  204. package/dist/components/Select/index.d.ts +1 -0
  205. package/dist/components/SelectionFrame/SelectionFrame.d.ts +6 -0
  206. package/dist/components/SelectionFrame/SelectionFrame.js.map +1 -1
  207. package/dist/components/Sheet/Sheet.js +12 -7
  208. package/dist/components/Sheet/Sheet.js.map +1 -1
  209. package/dist/components/SideNav/SideNav.d.ts +37 -1
  210. package/dist/components/SideNav/SideNav.js +103 -74
  211. package/dist/components/SideNav/SideNav.js.map +1 -1
  212. package/dist/components/SideNav/index.d.ts +1 -1
  213. package/dist/components/SignaturePad/SignaturePad.d.ts +3 -0
  214. package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
  215. package/dist/components/SiteFooter/SiteFooter.d.ts +66 -0
  216. package/dist/components/SiteFooter/SiteFooter.js +80 -0
  217. package/dist/components/SiteFooter/SiteFooter.js.map +1 -0
  218. package/dist/components/SiteFooter/index.d.ts +1 -0
  219. package/dist/components/SiteHeader/SiteHeader.d.ts +78 -0
  220. package/dist/components/SiteHeader/SiteHeader.js +114 -0
  221. package/dist/components/SiteHeader/SiteHeader.js.map +1 -0
  222. package/dist/components/SiteHeader/index.d.ts +1 -0
  223. package/dist/components/Skeleton/Skeleton.d.ts +1 -0
  224. package/dist/components/Skeleton/Skeleton.js.map +1 -1
  225. package/dist/components/SkipLink/SkipLink.d.ts +42 -0
  226. package/dist/components/SkipLink/SkipLink.js +43 -0
  227. package/dist/components/SkipLink/SkipLink.js.map +1 -0
  228. package/dist/components/SkipLink/index.d.ts +1 -0
  229. package/dist/components/Slider/Slider.d.ts +11 -0
  230. package/dist/components/Slider/Slider.js +6 -6
  231. package/dist/components/Slider/Slider.js.map +1 -1
  232. package/dist/components/SortableList/SortableList.d.ts +6 -0
  233. package/dist/components/SortableList/SortableList.js +13 -13
  234. package/dist/components/SortableList/SortableList.js.map +1 -1
  235. package/dist/components/SplitPane/SplitPane.d.ts +5 -0
  236. package/dist/components/SplitPane/SplitPane.js +4 -4
  237. package/dist/components/SplitPane/SplitPane.js.map +1 -1
  238. package/dist/components/Stack/Stack.d.ts +19 -6
  239. package/dist/components/Stack/Stack.js +26 -13
  240. package/dist/components/Stack/Stack.js.map +1 -1
  241. package/dist/components/Stack/index.d.ts +1 -0
  242. package/dist/components/Stack/space.d.ts +47 -0
  243. package/dist/components/Stack/space.js +23 -0
  244. package/dist/components/Stack/space.js.map +1 -0
  245. package/dist/components/Stat/Stat.d.ts +88 -0
  246. package/dist/components/Stat/Stat.js +105 -0
  247. package/dist/components/Stat/Stat.js.map +1 -0
  248. package/dist/components/Stat/index.d.ts +1 -0
  249. package/dist/components/Steps/Steps.d.ts +14 -4
  250. package/dist/components/Steps/Steps.js +31 -30
  251. package/dist/components/Steps/Steps.js.map +1 -1
  252. package/dist/components/Switch/Switch.d.ts +4 -4
  253. package/dist/components/Switch/Switch.js +18 -7
  254. package/dist/components/Switch/Switch.js.map +1 -1
  255. package/dist/components/Table/Table.d.ts +12 -0
  256. package/dist/components/Table/Table.js +11 -12
  257. package/dist/components/Table/Table.js.map +1 -1
  258. package/dist/components/Tabs/Tabs.d.ts +18 -1
  259. package/dist/components/Tabs/Tabs.js +74 -73
  260. package/dist/components/Tabs/Tabs.js.map +1 -1
  261. package/dist/components/TagInput/TagInput.d.ts +18 -0
  262. package/dist/components/TagInput/TagInput.js +79 -100
  263. package/dist/components/TagInput/TagInput.js.map +1 -1
  264. package/dist/components/Text/Text.d.ts +72 -0
  265. package/dist/components/Text/Text.js +30 -0
  266. package/dist/components/Text/Text.js.map +1 -0
  267. package/dist/components/Text/index.d.ts +1 -0
  268. package/dist/components/TextArea/TextArea.d.ts +10 -0
  269. package/dist/components/TextArea/TextArea.js +4 -4
  270. package/dist/components/TextArea/TextArea.js.map +1 -1
  271. package/dist/components/TextField/TextField.d.ts +17 -0
  272. package/dist/components/TextField/TextField.js +28 -27
  273. package/dist/components/TextField/TextField.js.map +1 -1
  274. package/dist/components/ThemeToggle/ThemeToggle.d.ts +11 -1
  275. package/dist/components/ThemeToggle/ThemeToggle.js +33 -30
  276. package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
  277. package/dist/components/TimeField/TimeField.d.ts +62 -8
  278. package/dist/components/TimeField/TimeField.js +308 -72
  279. package/dist/components/TimeField/TimeField.js.map +1 -1
  280. package/dist/components/Toast/Toast.d.ts +25 -1
  281. package/dist/components/Toast/Toast.js +137 -126
  282. package/dist/components/Toast/Toast.js.map +1 -1
  283. package/dist/components/Toast/index.d.ts +1 -1
  284. package/dist/components/Toolbar/Toolbar.d.ts +3 -0
  285. package/dist/components/Toolbar/Toolbar.js.map +1 -1
  286. package/dist/components/Tooltip/Tooltip.d.ts +7 -1
  287. package/dist/components/Tooltip/Tooltip.js +19 -19
  288. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  289. package/dist/components/Tree/Tree.d.ts +8 -0
  290. package/dist/components/Tree/Tree.js.map +1 -1
  291. package/dist/components/VirtualList/VirtualList.d.ts +8 -0
  292. package/dist/components/VirtualList/VirtualList.js +4 -4
  293. package/dist/components/VirtualList/VirtualList.js.map +1 -1
  294. package/dist/components/VisuallyHidden/VisuallyHidden.d.ts +24 -0
  295. package/dist/components/VisuallyHidden/VisuallyHidden.js +17 -0
  296. package/dist/components/VisuallyHidden/VisuallyHidden.js.map +1 -0
  297. package/dist/components/VisuallyHidden/index.d.ts +1 -0
  298. package/dist/components/ZoomControls/ZoomControls.d.ts +4 -0
  299. package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
  300. package/dist/foundations/ChoiceBase/ChoiceBase.d.ts +1 -0
  301. package/dist/foundations/ChoiceBase/ChoiceBase.js +8 -8
  302. package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
  303. package/dist/foundations/HiddenValue/HiddenValue.d.ts +3 -0
  304. package/dist/foundations/HiddenValue/HiddenValue.js +5 -5
  305. package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
  306. package/dist/foundations/Icon/Icon.d.ts +9 -1
  307. package/dist/foundations/Icon/Icon.js +15 -14
  308. package/dist/foundations/Icon/Icon.js.map +1 -1
  309. package/dist/foundations/image-outcome.d.ts +20 -0
  310. package/dist/foundations/image-outcome.js +43 -0
  311. package/dist/foundations/image-outcome.js.map +1 -0
  312. package/dist/foundations/option-icon.d.ts +26 -0
  313. package/dist/foundations/option-icon.js +16 -0
  314. package/dist/foundations/option-icon.js.map +1 -0
  315. package/dist/foundations/printing.d.ts +6 -0
  316. package/dist/foundations/printing.js +17 -0
  317. package/dist/foundations/printing.js.map +1 -0
  318. package/dist/foundations/qr.d.ts +42 -0
  319. package/dist/foundations/qr.js +246 -0
  320. package/dist/foundations/qr.js.map +1 -0
  321. package/dist/icons/book-marked.d.ts +2 -0
  322. package/dist/icons/book-marked.js +14 -0
  323. package/dist/icons/book-marked.js.map +1 -0
  324. package/dist/icons/calendar-days.d.ts +2 -0
  325. package/dist/icons/calendar-days.js +24 -0
  326. package/dist/icons/calendar-days.js.map +1 -0
  327. package/dist/icons/check-square.d.ts +2 -0
  328. package/dist/icons/check-square.js +14 -0
  329. package/dist/icons/check-square.js.map +1 -0
  330. package/dist/icons/crescent.d.ts +2 -0
  331. package/dist/icons/crescent.js +14 -0
  332. package/dist/icons/crescent.js.map +1 -0
  333. package/dist/icons/index.d.ts +11 -0
  334. package/dist/icons/index.js +502 -480
  335. package/dist/icons/kaaba.d.ts +2 -0
  336. package/dist/icons/kaaba.js +14 -0
  337. package/dist/icons/kaaba.js.map +1 -0
  338. package/dist/icons/keywords.d.ts +259 -0
  339. package/dist/icons/keywords.js +1816 -0
  340. package/dist/icons/keywords.js.map +1 -0
  341. package/dist/icons/list-tree.d.ts +2 -0
  342. package/dist/icons/list-tree.js +14 -0
  343. package/dist/icons/list-tree.js.map +1 -0
  344. package/dist/icons/mosque.d.ts +2 -0
  345. package/dist/icons/mosque.js +14 -0
  346. package/dist/icons/mosque.js.map +1 -0
  347. package/dist/icons/prayer-beads.d.ts +2 -0
  348. package/dist/icons/prayer-beads.js +67 -0
  349. package/dist/icons/prayer-beads.js.map +1 -0
  350. package/dist/icons/qr-code.d.ts +2 -0
  351. package/dist/icons/qr-code.js +38 -0
  352. package/dist/icons/qr-code.js.map +1 -0
  353. package/dist/icons/refresh-cw.d.ts +2 -0
  354. package/dist/icons/refresh-cw.js +14 -0
  355. package/dist/icons/refresh-cw.js.map +1 -0
  356. package/dist/icons/types.d.ts +1 -1
  357. package/dist/icons/types.js +2 -1
  358. package/dist/icons/types.js.map +1 -1
  359. package/dist/index.d.ts +35 -10
  360. package/dist/index.js +280 -220
  361. package/dist/styles/announcer.css +1 -1
  362. package/dist/styles/app-shell.css +1 -1
  363. package/dist/styles/aspect-ratio.css +1 -0
  364. package/dist/styles/avatar.css +1 -0
  365. package/dist/styles/base.css +1 -1
  366. package/dist/styles/breadcrumbs.css +1 -0
  367. package/dist/styles/button.css +1 -1
  368. package/dist/styles/calendar.css +1 -1
  369. package/dist/styles/card.css +1 -1
  370. package/dist/styles/checkbox.css +1 -1
  371. package/dist/styles/checklist.css +1 -0
  372. package/dist/styles/choice-base.css +1 -0
  373. package/dist/styles/choice.css +1 -1
  374. package/dist/styles/color-field.css +1 -1
  375. package/dist/styles/combobox.css +1 -1
  376. package/dist/styles/container.css +1 -0
  377. package/dist/styles/copy-button.css +1 -1
  378. package/dist/styles/date-field.css +1 -1
  379. package/dist/styles/device-frame.css +1 -0
  380. package/dist/styles/dialog.css +1 -1
  381. package/dist/styles/disclosure.css +1 -1
  382. package/dist/styles/divider.css +1 -0
  383. package/dist/styles/field.css +1 -1
  384. package/dist/styles/file-drop.css +1 -1
  385. package/dist/styles/floating-toolbar.css +1 -1
  386. package/dist/styles/generated-css.d.ts +1 -1
  387. package/dist/styles/generated-css.js +1 -1
  388. package/dist/styles/generated-css.js.map +1 -1
  389. package/dist/styles/grid.css +1 -1
  390. package/dist/styles/heading.css +1 -0
  391. package/dist/styles/icon-tile.css +1 -0
  392. package/dist/styles/icon.css +1 -1
  393. package/dist/styles/image.css +1 -0
  394. package/dist/styles/inline.css +1 -0
  395. package/dist/styles/key-value-editor.css +1 -1
  396. package/dist/styles/link.css +1 -1
  397. package/dist/styles/list.css +1 -0
  398. package/dist/styles/manifest.json +715 -0
  399. package/dist/styles/menu.css +1 -1
  400. package/dist/styles/notice.css +1 -1
  401. package/dist/styles/number-field.css +1 -1
  402. package/dist/styles/option-list.css +1 -0
  403. package/dist/styles/page-header.css +1 -0
  404. package/dist/styles/pagination.css +1 -0
  405. package/dist/styles/qr-code.css +1 -0
  406. package/dist/styles/radio-group.css +1 -1
  407. package/dist/styles/section.css +1 -0
  408. package/dist/styles/segmented-control.css +1 -1
  409. package/dist/styles/select.css +1 -1
  410. package/dist/styles/sheet.css +1 -1
  411. package/dist/styles/side-nav.css +1 -1
  412. package/dist/styles/site-footer.css +1 -0
  413. package/dist/styles/site-header.css +1 -0
  414. package/dist/styles/skip-link.css +1 -0
  415. package/dist/styles/sortable-list.css +1 -1
  416. package/dist/styles/stack.css +1 -1
  417. package/dist/styles/stat.css +1 -0
  418. package/dist/styles/steps.css +1 -1
  419. package/dist/styles/switch.css +1 -0
  420. package/dist/styles/table.css +1 -1
  421. package/dist/styles/tabs.css +1 -1
  422. package/dist/styles/tag-input.css +1 -1
  423. package/dist/styles/text-field.css +1 -1
  424. package/dist/styles/text.css +1 -0
  425. package/dist/styles/time-field.css +1 -1
  426. package/dist/styles/toast.css +1 -1
  427. package/dist/styles/visually-hidden.css +1 -0
  428. package/dist/styles.css +1 -1
  429. package/dist/theme/CynosureTheme.d.ts +4 -0
  430. package/dist/theme/CynosureTheme.js.map +1 -1
  431. package/dist/tokens/create-theme.js +137 -108
  432. package/dist/tokens/create-theme.js.map +1 -1
  433. package/dist/tokens/to-css.js +12 -12
  434. package/dist/tokens/to-css.js.map +1 -1
  435. package/package.json +8 -3
  436. package/dist/components/Checkbox/ChoiceRow.d.ts +0 -23
  437. package/dist/components/Checkbox/ChoiceRow.js +0 -57
  438. package/dist/components/Checkbox/ChoiceRow.js.map +0 -1
  439. package/dist/styles/hidden-value.css +0 -1
  440. package/dist/styles/iconbutton.css +0 -1
  441. package/dist/styles/search-field.css +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"Disclosure.js","names":["useControllableState","ButtonBase","Icon","chevronDown","useId","jsx","jsxs","Disclosure","summary","open","defaultOpen","onOpenChange","variant","size","headingLevel","region","locked","onTriggerKeyDown","className","style","children","rest","id","isOpen","setOpen","toggle","trigger","Heading"],"sources":["../../../src/components/Disclosure/Disclosure.tsx"],"sourcesContent":["import { type CSSProperties, type KeyboardEvent, type ReactNode, useId } from \"react\";\nimport { ButtonBase } from \"../../foundations/ButtonBase/ButtonBase.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { chevronDown } from \"../../icons/chevron-down.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface DisclosureTokens {\n gap: string;\n radius: string;\n paddingInline: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n disclosure: DisclosureTokens;\n }\n}\n\nexport interface DisclosureProps {\n /** The always-visible trigger text. */\n summary: ReactNode;\n open?: boolean;\n defaultOpen?: boolean;\n onOpenChange?: (open: boolean) => void;\n /** `plain` no chrome, `line` bottom divider, `card` bordered surface. */\n variant?: \"plain\" | \"line\" | \"card\";\n size?: Size;\n /** Wrap the trigger in a heading of this level (accordion sections in a document outline). */\n headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;\n /** Expose the content as a labelled region (for a few large sections). */\n region?: boolean;\n /** The trigger cannot close the content right now (non-collapsible accordion). Sets aria-disabled. */\n locked?: boolean;\n /** Keyboard handler on the trigger (Accordion uses it for arrow navigation). */\n onTriggerKeyDown?: (event: KeyboardEvent<HTMLButtonElement>) => void;\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n children?: ReactNode;\n \"data-testid\"?: string;\n}\n\n/** Show and hide a section behind a button. Replaces native <details> with an animated, themeable version. */\nexport function Disclosure({\n summary,\n open,\n defaultOpen = false,\n onOpenChange,\n variant = \"plain\",\n size = \"md\",\n headingLevel,\n region = false,\n locked = false,\n onTriggerKeyDown,\n className,\n style,\n children,\n ...rest\n}: DisclosureProps) {\n const id = useId();\n const [isOpen, setOpen] = useControllableState(open, defaultOpen, onOpenChange);\n const toggle = () => {\n if (locked) return;\n setOpen(!isOpen);\n };\n const trigger = (\n <ButtonBase\n id={`${id}-trigger`}\n className=\"cy-disclosure-trigger\"\n aria-expanded={isOpen}\n aria-controls={`${id}-content`}\n aria-disabled={locked || undefined}\n onClick={toggle}\n onKeyDown={onTriggerKeyDown}\n >\n <span className=\"cy-disclosure-summary\">{summary}</span>\n <Icon icon={chevronDown} className=\"cy-disclosure-chevron\" />\n </ButtonBase>\n );\n const Heading = headingLevel ? (`h${headingLevel}` as const) : null;\n return (\n <div\n {...rest}\n className={className ? `cy-disclosure ${className}` : \"cy-disclosure\"}\n data-variant={variant}\n data-size={size}\n data-open={isOpen ? \"\" : undefined}\n style={style}\n >\n {Heading ? <Heading className=\"cy-disclosure-heading\">{trigger}</Heading> : trigger}\n <div\n id={`${id}-content`}\n className=\"cy-disclosure-content\"\n {...(region ? { role: \"region\", \"aria-labelledby\": `${id}-trigger` } : {})}\n >\n <div className=\"cy-disclosure-clip\">\n <div className=\"cy-disclosure-body\">{children}</div>\n </div>\n </div>\n </div>\n );\n}\n"],"mappings":";;;;;;;AA4CA,SAAgBO,EAAW,EACzB,SAAAC,GACA,MAAAC,GACA,aAAAC,IAAc,IACd,cAAAC,GACA,SAAAC,IAAU,SACV,MAAAC,IAAO,MACP,cAAAC,GACA,QAAAC,IAAS,IACT,QAAAC,IAAS,IACT,kBAAAC,GACA,WAAAC,GACA,OAAAC,GACA,UAAAC,GACA,GAAGC,EAAA,GACe;AAClB,QAAMC,IAAKlB,EAAM,GACX,CAACmB,GAAQC,CAAA,IAAWxB,EAAqBS,GAAMC,GAAaC,CAAY,GACxEc,IAAA,MAAe;AACnB,IAAIT,KACJQ,EAAQ,CAACD,CAAM;AAAA,EACjB,GACMG,IACJ,gBAAApB,EAACL,GAAD;AAAA,IACE,IAAI,GAAGqB,CAAA;AAAA,IACP,WAAU;AAAA,IACV,iBAAeC;AAAA,IACf,iBAAe,GAAGD,CAAA;AAAA,IAClB,iBAAeN,KAAU;AAAA,IACzB,SAASS;AAAA,IACT,WAAWR;AAAA,IAPb,UAAA,CASE,gBAAAZ,EAAC,QAAD;AAAA,MAAM,WAAU;AAAA,MAAyB,UAAAG;AAAA,IAAc,CAAA,GACvD,gBAAAH,EAACH,GAAD;AAAA,MAAM,MAAMC;AAAA,MAAa,WAAU;AAAA,IAAyB,CAAA,CAClD;AAAA,E,IAERwB,IAAUb,IAAgB,IAAIA,CAAA,KAA2B;AAC/D,SACE,gBAAAR,EAAC,OAAD;AAAA,IACE,GAAIe;AAAA,IACJ,WAAWH,IAAY,iBAAiBA,CAAA,KAAc;AAAA,IACtD,gBAAcN;AAAA,IACd,aAAWC;AAAA,IACX,aAAWU,IAAS,KAAK;AAAA,IAClB,OAAAJ;AAAA,IANT,UAAA,CAQGQ,IAAU,gBAAAtB,EAACsB,GAAD;AAAA,MAAS,WAAU;AAAA,MAAyB,UAAAD;AAAA,IAAiB,CAAA,IAAIA,GAC5E,gBAAArB,EAAC,OAAD;AAAA,MACE,IAAI,GAAGiB,CAAA;AAAA,MACP,WAAU;AAAA,MACV,GAAKP,IAAS;AAAA,QAAE,MAAM;AAAA,QAAU,mBAAmB,GAAGO,CAAA;AAAA,MAAa,IAAI,CAAC;AAAA,MAExE,UAAA,gBAAAjB,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QACb,UAAA,gBAAAA,EAAC,OAAD;AAAA,UAAK,WAAU;AAAA,UAAsB,UAAAe;AAAA,QAAc,CAAA;AAAA,MAChD,CAAA;AAAA,IACF,CAAA,CACF;AAAA,E;AAET"}
1
+ {"version":3,"file":"Disclosure.js","names":["useControllableState","ButtonBase","Icon","chevronDown","useId","jsx","jsxs","Disclosure","summary","open","defaultOpen","onOpenChange","variant","size","headingLevel","region","locked","onTriggerKeyDown","className","style","children","rest","id","isOpen","setOpen","toggle","trigger","Heading"],"sources":["../../../src/components/Disclosure/Disclosure.tsx"],"sourcesContent":["import { type CSSProperties, type KeyboardEvent, type ReactNode, useId } from \"react\";\nimport { ButtonBase } from \"../../foundations/ButtonBase/ButtonBase.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { chevronDown } from \"../../icons/chevron-down.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface DisclosureTokens {\n gap: string;\n radius: string;\n paddingInline: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n disclosure: DisclosureTokens;\n }\n}\n\nexport interface DisclosureProps {\n /** The always-visible trigger text. */\n summary: ReactNode;\n /** Whether the content is shown, when you control it. */\n open?: boolean;\n /** Shown on first render when uncontrolled. */\n defaultOpen?: boolean;\n /** Called with the new state when the trigger is pressed. */\n onOpenChange?: (open: boolean) => void;\n /** `plain` no chrome, `line` bottom divider, `card` bordered surface. */\n variant?: \"plain\" | \"line\" | \"card\";\n /** Height of the trigger and size of the text. Default \"md\". */\n size?: Size;\n /** Wrap the trigger in a heading of this level (accordion sections in a document outline). */\n headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;\n /** Expose the content as a labelled region (for a few large sections). */\n region?: boolean;\n /** The trigger cannot close the content right now (non-collapsible accordion). Sets aria-disabled. */\n locked?: boolean;\n /** Keyboard handler on the trigger (Accordion uses it for arrow navigation). */\n onTriggerKeyDown?: (event: KeyboardEvent<HTMLButtonElement>) => void;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n /** The content that is shown and hidden. */\n children?: ReactNode;\n /** Set on the root element, for tests. */\n \"data-testid\"?: string;\n}\n\n/** Show and hide a section behind a button. Replaces native <details> with an animated, themeable version. */\nexport function Disclosure({\n summary,\n open,\n defaultOpen = false,\n onOpenChange,\n variant = \"plain\",\n size = \"md\",\n headingLevel,\n region = false,\n locked = false,\n onTriggerKeyDown,\n className,\n style,\n children,\n ...rest\n}: DisclosureProps) {\n const id = useId();\n const [isOpen, setOpen] = useControllableState(open, defaultOpen, onOpenChange);\n const toggle = () => {\n if (locked) return;\n setOpen(!isOpen);\n };\n const trigger = (\n <ButtonBase\n id={`${id}-trigger`}\n className=\"cy-disclosure-trigger\"\n aria-expanded={isOpen}\n aria-controls={`${id}-content`}\n aria-disabled={locked || undefined}\n onClick={toggle}\n onKeyDown={onTriggerKeyDown}\n >\n <span className=\"cy-disclosure-summary\">{summary}</span>\n <Icon icon={chevronDown} className=\"cy-disclosure-chevron\" />\n </ButtonBase>\n );\n const Heading = headingLevel ? (`h${headingLevel}` as const) : null;\n return (\n <div\n {...rest}\n className={className ? `cy-disclosure ${className}` : \"cy-disclosure\"}\n data-variant={variant}\n data-size={size}\n data-open={isOpen ? \"\" : undefined}\n style={style}\n >\n {Heading ? <Heading className=\"cy-disclosure-heading\">{trigger}</Heading> : trigger}\n <div\n id={`${id}-content`}\n className=\"cy-disclosure-content\"\n {...(region ? { role: \"region\", \"aria-labelledby\": `${id}-trigger` } : {})}\n >\n <div className=\"cy-disclosure-clip\">\n <div className=\"cy-disclosure-body\">{children}</div>\n </div>\n </div>\n </div>\n );\n}\n"],"mappings":";;;;;;;AAmDA,SAAgBO,EAAW,EACzB,SAAAC,GACA,MAAAC,GACA,aAAAC,IAAc,IACd,cAAAC,GACA,SAAAC,IAAU,SACV,MAAAC,IAAO,MACP,cAAAC,GACA,QAAAC,IAAS,IACT,QAAAC,IAAS,IACT,kBAAAC,GACA,WAAAC,GACA,OAAAC,GACA,UAAAC,GACA,GAAGC,EAAA,GACe;AAClB,QAAMC,IAAKlB,EAAM,GACX,CAACmB,GAAQC,CAAA,IAAWxB,EAAqBS,GAAMC,GAAaC,CAAY,GACxEc,IAAA,MAAe;AACnB,IAAIT,KACJQ,EAAQ,CAACD,CAAM;AAAA,EACjB,GACMG,IACJ,gBAAApB,EAACL,GAAD;AAAA,IACE,IAAI,GAAGqB,CAAA;AAAA,IACP,WAAU;AAAA,IACV,iBAAeC;AAAA,IACf,iBAAe,GAAGD,CAAA;AAAA,IAClB,iBAAeN,KAAU;AAAA,IACzB,SAASS;AAAA,IACT,WAAWR;AAAA,IAPb,UAAA,CASE,gBAAAZ,EAAC,QAAD;AAAA,MAAM,WAAU;AAAA,MAAyB,UAAAG;AAAA,IAAc,CAAA,GACvD,gBAAAH,EAACH,GAAD;AAAA,MAAM,MAAMC;AAAA,MAAa,WAAU;AAAA,IAAyB,CAAA,CAClD;AAAA,E,IAERwB,IAAUb,IAAgB,IAAIA,CAAA,KAA2B;AAC/D,SACE,gBAAAR,EAAC,OAAD;AAAA,IACE,GAAIe;AAAA,IACJ,WAAWH,IAAY,iBAAiBA,CAAA,KAAc;AAAA,IACtD,gBAAcN;AAAA,IACd,aAAWC;AAAA,IACX,aAAWU,IAAS,KAAK;AAAA,IAClB,OAAAJ;AAAA,IANT,UAAA,CAQGQ,IAAU,gBAAAtB,EAACsB,GAAD;AAAA,MAAS,WAAU;AAAA,MAAyB,UAAAD;AAAA,IAAiB,CAAA,IAAIA,GAC5E,gBAAArB,EAAC,OAAD;AAAA,MACE,IAAI,GAAGiB,CAAA;AAAA,MACP,WAAU;AAAA,MACV,GAAKP,IAAS;AAAA,QAAE,MAAM;AAAA,QAAU,mBAAmB,GAAGO,CAAA;AAAA,MAAa,IAAI,CAAC;AAAA,MAExE,UAAA,gBAAAjB,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QACb,UAAA,gBAAAA,EAAC,OAAD;AAAA,UAAK,WAAU;AAAA,UAAsB,UAAAe;AAAA,QAAc,CAAA;AAAA,MAChD,CAAA;AAAA,IACF,CAAA,CACF;AAAA,E;AAET"}
@@ -0,0 +1,59 @@
1
+ import { type CSSProperties, type ReactNode } from "react";
2
+ export interface DividerTokens {
3
+ /** Thickness of the line. */
4
+ thickness: string;
5
+ /** Line colour of the neutral tone. */
6
+ color: string;
7
+ /** Line colour of the strong tone. */
8
+ colorStrong: string;
9
+ /** Space between the label and the line on each side of it. */
10
+ labelGap: string;
11
+ /** Text colour of the label. */
12
+ labelColor: string;
13
+ /** Text size of the label. */
14
+ labelSize: string;
15
+ /** Space around the line with `spacing="sm"`. */
16
+ spacingSm: string;
17
+ /** Space around the line with `spacing="md"`. */
18
+ spacingMd: string;
19
+ /** Space around the line with `spacing="lg"`. */
20
+ spacingLg: string;
21
+ }
22
+ declare module "../../tokens/schema.js" {
23
+ interface ComponentTokens {
24
+ divider: DividerTokens;
25
+ }
26
+ }
27
+ export interface DividerProps {
28
+ /**
29
+ * Direction of the line. A horizontal divider fills the width of its container; a vertical one stretches to the
30
+ * height of its flex row (Inline, Toolbar). Default "horizontal".
31
+ */
32
+ orientation?: "horizontal" | "vertical";
33
+ /** Line style. Default "solid". */
34
+ variant?: "solid" | "dashed";
35
+ /** Line colour: the quiet line colour, or a stronger one for emphasis. Default "neutral". */
36
+ tone?: "neutral" | "strong";
37
+ /**
38
+ * Space around the line along the flow: above and below a horizontal divider, before and after a vertical one.
39
+ * Stack and Inline gaps usually provide it. Default "none".
40
+ */
41
+ spacing?: "none" | "sm" | "md" | "lg";
42
+ /** Where the label sits along a horizontal line (follows the text direction). Default "center". */
43
+ labelAlign?: "start" | "center" | "end";
44
+ /**
45
+ * Purely visual: not exposed as a separator. With `false` it has `role="separator"` and its label is its
46
+ * accessible name. Default true.
47
+ */
48
+ decorative?: boolean;
49
+ /** Added to the root element, for layout. */
50
+ className?: string;
51
+ /** Layout only. Restyle through `--cy-divider-*` tokens. */
52
+ style?: CSSProperties;
53
+ /** A short label drawn in the line ("or"). Horizontal only: a vertical divider ignores it. */
54
+ children?: ReactNode;
55
+ /** Set on the root element, to find it in tests. */
56
+ "data-testid"?: string;
57
+ }
58
+ /** A line that separates content, horizontal or vertical, with an optional label in the middle. */
59
+ export declare const Divider: import("react").ForwardRefExoticComponent<DividerProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -0,0 +1,32 @@
1
+ "use client";
2
+ import { forwardRef as f, useId as p } from "react";
3
+ import { jsx as l } from "react/jsx-runtime";
4
+ var $ = f(function({ orientation: t = "horizontal", variant: n = "solid", tone: d = "neutral", spacing: s = "none", labelAlign: c = "center", decorative: v = !0, className: i, style: m, children: a, ...u }, b) {
5
+ const r = p(), o = t === "vertical", e = !o && a != null && a !== !1 && a !== "";
6
+ return /* @__PURE__ */ l("div", {
7
+ ref: b,
8
+ ...u,
9
+ ...v ? { role: "none" } : {
10
+ role: "separator",
11
+ "aria-orientation": o ? "vertical" : void 0,
12
+ "aria-labelledby": e ? r : void 0
13
+ },
14
+ className: `cy-divider${i ? ` ${i}` : ""}`,
15
+ "data-orientation": t,
16
+ "data-variant": n,
17
+ "data-tone": d,
18
+ "data-spacing": s,
19
+ "data-label": e ? c : void 0,
20
+ style: m,
21
+ children: e && /* @__PURE__ */ l("span", {
22
+ id: r,
23
+ className: "cy-reset cy-divider-label",
24
+ children: a
25
+ })
26
+ });
27
+ });
28
+ export {
29
+ $ as Divider
30
+ };
31
+
32
+ //# sourceMappingURL=Divider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Divider.js","names":["forwardRef","useId","jsx","Divider","orientation","variant","tone","spacing","labelAlign","decorative","className","style","children","rest","ref","labelId","vertical","labelled"],"sources":["../../../src/components/Divider/Divider.tsx"],"sourcesContent":["import { type CSSProperties, forwardRef, type ReactNode, useId } from \"react\";\n\nexport interface DividerTokens {\n /** Thickness of the line. */\n thickness: string;\n /** Line colour of the neutral tone. */\n color: string;\n /** Line colour of the strong tone. */\n colorStrong: string;\n /** Space between the label and the line on each side of it. */\n labelGap: string;\n /** Text colour of the label. */\n labelColor: string;\n /** Text size of the label. */\n labelSize: string;\n /** Space around the line with `spacing=\"sm\"`. */\n spacingSm: string;\n /** Space around the line with `spacing=\"md\"`. */\n spacingMd: string;\n /** Space around the line with `spacing=\"lg\"`. */\n spacingLg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n divider: DividerTokens;\n }\n}\n\nexport interface DividerProps {\n /**\n * Direction of the line. A horizontal divider fills the width of its container; a vertical one stretches to the\n * height of its flex row (Inline, Toolbar). Default \"horizontal\".\n */\n orientation?: \"horizontal\" | \"vertical\";\n /** Line style. Default \"solid\". */\n variant?: \"solid\" | \"dashed\";\n /** Line colour: the quiet line colour, or a stronger one for emphasis. Default \"neutral\". */\n tone?: \"neutral\" | \"strong\";\n /**\n * Space around the line along the flow: above and below a horizontal divider, before and after a vertical one.\n * Stack and Inline gaps usually provide it. Default \"none\".\n */\n spacing?: \"none\" | \"sm\" | \"md\" | \"lg\";\n /** Where the label sits along a horizontal line (follows the text direction). Default \"center\". */\n labelAlign?: \"start\" | \"center\" | \"end\";\n /**\n * Purely visual: not exposed as a separator. With `false` it has `role=\"separator\"` and its label is its\n * accessible name. Default true.\n */\n decorative?: boolean;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through `--cy-divider-*` tokens. */\n style?: CSSProperties;\n /** A short label drawn in the line (\"or\"). Horizontal only: a vertical divider ignores it. */\n children?: ReactNode;\n /** Set on the root element, to find it in tests. */\n \"data-testid\"?: string;\n}\n\n/** A line that separates content, horizontal or vertical, with an optional label in the middle. */\nexport const Divider = forwardRef<HTMLDivElement, DividerProps>(function Divider(\n {\n orientation = \"horizontal\",\n variant = \"solid\",\n tone = \"neutral\",\n spacing = \"none\",\n labelAlign = \"center\",\n decorative = true,\n className,\n style,\n children,\n ...rest\n },\n ref,\n) {\n const labelId = useId();\n const vertical = orientation === \"vertical\";\n const labelled = !vertical && children != null && children !== false && children !== \"\";\n // A separator's content is presentational, so its label is given as its name. Horizontal is the role's default\n // orientation, so only vertical is stated.\n const semantics = decorative\n ? ({ role: \"none\" } as const)\n : ({\n role: \"separator\",\n \"aria-orientation\": vertical ? \"vertical\" : undefined,\n \"aria-labelledby\": labelled ? labelId : undefined,\n } as const);\n return (\n <div\n ref={ref}\n {...rest}\n {...semantics}\n className={`cy-divider${className ? ` ${className}` : \"\"}`}\n data-orientation={orientation}\n data-variant={variant}\n data-tone={tone}\n data-spacing={spacing}\n data-label={labelled ? labelAlign : undefined}\n style={style}\n >\n {labelled && (\n <span id={labelId} className=\"cy-reset cy-divider-label\">\n {children}\n </span>\n )}\n </div>\n );\n});\n"],"mappings":";;;AA8DA,IAAaG,IAAUH,EAAyC,SAC9D,EACE,aAAAI,IAAc,cACd,SAAAC,IAAU,SACV,MAAAC,IAAO,WACP,SAAAC,IAAU,QACV,YAAAC,IAAa,UACb,YAAAC,IAAa,IACb,WAAAC,GACA,OAAAC,GACA,UAAAC,GACA,GAAGC,EAAA,GAELC,GACA;AACA,QAAMC,IAAUd,EAAM,GAChBe,IAAWZ,MAAgB,YAC3Ba,IAAW,CAACD,KAAYJ,KAAY,QAAQA,MAAa,MAASA,MAAa;AAUrF,SACE,gBAAAV,EAAC,OAAD;AAAA,IACO,KAAAY;AAAA,IACL,GAAID;AAAA,IACJ,GAXcJ,IACb,EAAE,MAAM,OAAO,IACf;AAAA,MACC,MAAM;AAAA,MACN,oBAAoBO,IAAW,aAAa;AAAA,MAC5C,mBAAmBC,IAAWF,IAAU;AAAA,IAC1C;AAAA,IAMA,WAAW,aAAaL,IAAY,IAAIA,CAAA,KAAc,EAAA;AAAA,IACtD,oBAAkBN;AAAA,IAClB,gBAAcC;AAAA,IACd,aAAWC;AAAA,IACX,gBAAcC;AAAA,IACd,cAAYU,IAAWT,IAAa;AAAA,IAC7B,OAAAG;AAAA,IAEN,UAAAM,KACC,gBAAAf,EAAC,QAAD;AAAA,MAAM,IAAIa;AAAA,MAAS,WAAU;AAAA,MAC1B,UAAAH;AAAA,IACG,CAAA;AAAA,EAEL,CAAA;AAET,CAAC"}
@@ -0,0 +1 @@
1
+ export { Divider, type DividerProps, type DividerTokens } from "./Divider.js";
@@ -27,7 +27,9 @@ export interface PageRect {
27
27
  height: number;
28
28
  }
29
29
  export interface RenderPageProps {
30
+ /** The page's `id` from `pages`. */
30
31
  id: string;
32
+ /** Position of the page in `pages`, from 0. */
31
33
  index: number;
32
34
  /** 1 = 100%. Draw at `width` by `height` times `scale`. */
33
35
  scale: number;
@@ -53,12 +55,15 @@ export interface DocumentViewportLabels {
53
55
  export interface DocumentViewportProps {
54
56
  /** Names the viewport ("Document", "Contract.pdf"). */
55
57
  label: string;
58
+ /** The pages, top to bottom, each with its size at 100%. */
56
59
  pages: readonly ViewportPage[];
60
+ /** The zoom setting, when you control it: fit width, fit page or a percent. */
57
61
  zoom?: ZoomSetting | undefined;
58
62
  /** Default fit-width. */
59
63
  defaultZoom?: ZoomSetting;
60
64
  /** Gestures and keys ask for a percent. */
61
65
  onZoomChange?: ((zoom: ZoomSetting) => void) | undefined;
66
+ /** Draws one page. Called for each page in or near the view. */
62
67
  renderPage: (page: RenderPageProps) => ReactNode;
63
68
  /** The pages in view, top to bottom. */
64
69
  onVisiblePagesChange?: ((ids: string[]) => void) | undefined;
@@ -66,8 +71,11 @@ export interface DocumentViewportProps {
66
71
  onCurrentPageChange?: ((id: string | null) => void) | undefined;
67
72
  /** The scale the zoom came to (fit modes depend on the viewport). */
68
73
  onScaleChange?: ((scale: number) => void) | undefined;
74
+ /** Scrolls to a page, or to a rect on it. A new `nonce` scrolls again. */
69
75
  scrollTo?: ScrollRequest | undefined;
76
+ /** Replace the built-in English text: page names and the zoom announcement. */
70
77
  labels?: Partial<DocumentViewportLabels>;
78
+ /** Added to the scrolling root element, for layout. */
71
79
  className?: string;
72
80
  /** Layout only (give it a height). Restyle through --cy-document-viewport-* tokens. */
73
81
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"DocumentViewport.js","names":["_Fragment","useControllableState","useClientLayoutEffect","useVirtualWindow","anchoredScroll","zoomScale","useZoomGestures","useEffect","useRef","useState","Fragment$1","jsx","jsxs","DEFAULT_LABELS","n","total","percent","useReport","value","key","callback","latest","last","DocumentViewport","label","pages","zoom","defaultZoom","onZoomChange","renderPage","onVisiblePagesChange","onCurrentPageChange","onScaleChange","scrollTo","labels","className","style","text","scroller","setting","setSetting","gap","setGap","g","sizesAt","scale","p","setScale","win","next","scrollLeft","setScrollLeft","widest","contentWidth","anchor","gestures","at","lastScale","el","a","to","top","height","view","placed","i","page","w","h","x","y","l","t","r","b","rect","inView","current","best","lastNonce","pendingFocus","id","slot","said","setSaid","e"],"sources":["../../../src/components/DocumentViewport/DocumentViewport.tsx"],"sourcesContent":["import { type CSSProperties, type ReactNode, useEffect, useRef, useState } from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { useVirtualWindow } from \"../../foundations/virtual-window.js\";\nimport { anchoredScroll, type ZoomSetting, zoomScale } from \"../../foundations/zoom.js\";\nimport { useZoomGestures, type ZoomAnchor } from \"../../foundations/zoom-gestures.js\";\n\nexport type { ZoomSetting };\n\nexport interface DocumentViewportTokens {\n /** Behind the pages. */\n background: string;\n /** Space between and around pages. */\n gap: string;\n /** A page's shadow. */\n pageShadow: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n documentViewport: DocumentViewportTokens;\n }\n}\n\nexport interface ViewportPage {\n id: string;\n /** Size at 100%, in CSS pixels (a PDF point is one). */\n width: number;\n height: number;\n}\n\nexport interface PageRect {\n left: number;\n top: number;\n width: number;\n height: number;\n}\n\nexport interface RenderPageProps {\n id: string;\n index: number;\n /** 1 = 100%. Draw at `width` by `height` times `scale`. */\n scale: number;\n /** In view now (pages just outside are rendered too, so scrolling is seamless). */\n visible: boolean;\n /** The part of the page in view, in its own scaled pixels; null when none is. Render only that, for huge pages. */\n visibleRect: PageRect | null;\n}\n\n/** Scroll to a page, or to a rect on it (centred), at 100% units. A new `nonce` scrolls again. */\nexport interface ScrollRequest {\n id: string;\n nonce: number;\n rect?: PageRect;\n /** Move focus to the page afterwards (go-to-page). */\n focus?: boolean;\n}\n\nexport interface DocumentViewportLabels {\n /** A page's name. Default \"Page 3 of 12\". */\n page: (number: number, total: number) => string;\n /** Announced when the zoom changes. Default \"Zoom 125%\". */\n zoom: (percent: number) => string;\n}\n\nexport interface DocumentViewportProps {\n /** Names the viewport (\"Document\", \"Contract.pdf\"). */\n label: string;\n pages: readonly ViewportPage[];\n zoom?: ZoomSetting | undefined;\n /** Default fit-width. */\n defaultZoom?: ZoomSetting;\n /** Gestures and keys ask for a percent. */\n onZoomChange?: ((zoom: ZoomSetting) => void) | undefined;\n renderPage: (page: RenderPageProps) => ReactNode;\n /** The pages in view, top to bottom. */\n onVisiblePagesChange?: ((ids: string[]) => void) | undefined;\n /** The page with the most of itself in view. */\n onCurrentPageChange?: ((id: string | null) => void) | undefined;\n /** The scale the zoom came to (fit modes depend on the viewport). */\n onScaleChange?: ((scale: number) => void) | undefined;\n scrollTo?: ScrollRequest | undefined;\n labels?: Partial<DocumentViewportLabels>;\n className?: string;\n /** Layout only (give it a height). Restyle through --cy-document-viewport-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: DocumentViewportLabels = {\n page: (n, total) => `Page ${n} of ${total}`,\n zoom: (percent) => `Zoom ${percent}%`,\n};\n\n/** Calls the latest `callback` with `value` whenever `value` (compared by `key`) changes. */\nfunction useReport<T>(value: T, key: string, callback: ((v: T) => void) | undefined) {\n const latest = useRef(callback);\n latest.current = callback;\n const last = useRef<string | null>(null);\n useEffect(() => {\n if (last.current === key) return;\n last.current = key;\n latest.current?.(value);\n });\n}\n\n/**\n * A scrolling, zoomable document: pages one under another, only those near the view rendered, zoomed by setting\n * (fit width, fit page, a percent), Ctrl/Cmd+wheel or a pinch around the pointer, panned with Space+drag. It reports\n * the pages in view and the current page, scrolls to a page or a spot on it on request, and announces zoom changes.\n */\nexport function DocumentViewport({\n label,\n pages,\n zoom,\n defaultZoom = { kind: \"fit-width\" },\n onZoomChange,\n renderPage,\n onVisiblePagesChange,\n onCurrentPageChange,\n onScaleChange,\n scrollTo,\n labels,\n className,\n style,\n}: DocumentViewportProps) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const scroller = useRef<HTMLElement>(null);\n const [setting, setSetting] = useControllableState(zoom, defaultZoom, onZoomChange);\n // The gap comes from the token, in pixels, for the layout maths.\n const [gap, setGap] = useState(16);\n useClientLayoutEffect(() => {\n const g = Number.parseFloat(getComputedStyle(scroller.current as HTMLElement).getPropertyValue(\"--_gap\"));\n if (g !== gap) setGap(g);\n });\n\n // The viewport's size feeds the fit modes; the windowing measures it.\n const sizesAt = (scale: number) => pages.map((p) => p.height * scale);\n const [scale, setScale] = useState(1);\n const win = useVirtualWindow(scroller, { count: pages.length, sizes: sizesAt(scale), gap, overscan: 1 });\n const next = zoomScale(setting, pages, win.view, gap);\n if (next !== scale) setScale(next);\n const percent = Math.round(scale * 100);\n\n const [scrollLeft, setScrollLeft] = useState(0);\n const widest = Math.max(0, ...pages.map((p) => p.width * scale));\n const contentWidth = Math.max(win.view.width, widest + 2 * gap);\n\n // Zooming keeps the point under the pointer (or the viewport's centre) where it is.\n const anchor = useRef<{ at: { x: number; y: number }; from: number } | null>(null);\n const gestures = useZoomGestures(scroller, {\n percent,\n onZoom: (value, at: ZoomAnchor) => {\n anchor.current = { at: at ?? { x: win.view.width / 2, y: win.view.height / 2 }, from: scale };\n setSetting({ kind: \"percent\", value });\n },\n });\n const lastScale = useRef(scale);\n useClientLayoutEffect(() => {\n const el = scroller.current as HTMLElement;\n if (lastScale.current === scale) return;\n const a = anchor.current ?? {\n at: { x: el.clientWidth / 2, y: el.clientHeight / 2 },\n from: lastScale.current,\n };\n anchor.current = null;\n lastScale.current = scale;\n const to = anchoredScroll({ left: el.scrollLeft, top: el.scrollTop }, a.at, scale / a.from);\n el.scrollLeft = to.left;\n el.scrollTop = to.top;\n win.onScroll(el.scrollTop);\n setScrollLeft(el.scrollLeft);\n });\n\n // In view: which pages, and how much of each.\n const { top, height } = win.view;\n const view = { left: scrollLeft, right: scrollLeft + win.view.width, top, bottom: top + height };\n const placed = win.indices.map((i) => {\n const page = pages[i] as ViewportPage;\n const w = page.width * scale;\n const h = page.height * scale;\n const x = (contentWidth - w) / 2;\n const y = win.offsetOf(i);\n const l = Math.max(0, view.left - x);\n const t = Math.max(0, view.top - y);\n const r = Math.min(w, view.right - x);\n const b = Math.min(h, view.bottom - y);\n const rect = height > 0 && r > l && b > t ? { left: l, top: t, width: r - l, height: b - t } : null;\n return { page, i, w, h, x, y, rect, area: rect ? rect.width * rect.height : 0 };\n });\n const inView = placed.filter((p) => p.rect).sort((a, b) => a.i - b.i);\n const current = inView.reduce<(typeof placed)[number] | null>(\n (best, p) => (!best || p.area > best.area ? p : best),\n null,\n );\n useReport(\n inView.map((p) => p.page.id),\n inView.map((p) => p.page.id).join(\" \"),\n onVisiblePagesChange,\n );\n useReport(current?.page.id ?? null, current?.page.id ?? \"\", onCurrentPageChange);\n useReport(scale, String(scale), onScaleChange);\n\n // Scroll requests: only a new nonce scrolls; focus waits for the page to be rendered there.\n const lastNonce = useRef<number | null>(null);\n const pendingFocus = useRef<string | null>(null);\n useClientLayoutEffect(() => {\n const el = scroller.current as HTMLElement;\n if (!scrollTo || scrollTo.nonce === lastNonce.current) return;\n const i = pages.findIndex((p) => p.id === scrollTo.id);\n if (i < 0) return;\n lastNonce.current = scrollTo.nonce;\n const page = pages[i] as ViewportPage;\n const { rect } = scrollTo;\n if (rect) {\n el.scrollTop = win.offsetOf(i) + rect.top * scale - (el.clientHeight - rect.height * scale) / 2;\n el.scrollLeft =\n (contentWidth - page.width * scale) / 2 +\n rect.left * scale -\n (el.clientWidth - rect.width * scale) / 2;\n } else el.scrollTop = win.offsetOf(i) - gap;\n win.onScroll(el.scrollTop);\n setScrollLeft(el.scrollLeft);\n pendingFocus.current = scrollTo.focus ? scrollTo.id : null;\n });\n useClientLayoutEffect(() => {\n const id = pendingFocus.current;\n const slot = id && scroller.current?.querySelector<HTMLElement>(`[data-page=\"${CSS.escape(id)}\"]`);\n if (!slot) return;\n pendingFocus.current = null;\n slot.focus({ preventScroll: true });\n });\n\n // Zoom changes are announced; the first value is not.\n const [said, setSaid] = useState({ percent, text: \"\" });\n if (said.percent !== percent) setSaid({ percent, text: text.zoom(percent) });\n\n return (\n <>\n <section\n ref={scroller}\n aria-label={label}\n // biome-ignore lint/a11y/noNoninteractiveTabindex: the document scrolls and zooms from the keyboard, so it is a tab stop\n tabIndex={0}\n className={className ? `cy-document-viewport ${className}` : \"cy-document-viewport\"}\n data-panning={gestures.panning ? \"\" : undefined}\n style={style}\n onKeyDown={gestures.onKeyDown}\n onKeyUp={gestures.onKeyUp}\n onBlur={gestures.onBlur}\n onScroll={(e) => {\n win.onScroll(e.currentTarget.scrollTop);\n setScrollLeft(e.currentTarget.scrollLeft);\n }}\n >\n <div\n className=\"cy-document-viewport-content cy-reset\"\n style={{ inlineSize: contentWidth, blockSize: win.total }}\n >\n {placed.map(({ page, i, w, h, x, y, rect }) => (\n // biome-ignore lint/a11y/useSemanticElements: a page is a named group of whatever it shows, not a form fieldset\n <div\n key={page.id}\n role=\"group\"\n aria-label={text.page(i + 1, pages.length)}\n data-page={page.id}\n // Reached by go-to-page (focus), not in the Tab order.\n tabIndex={-1}\n className=\"cy-document-viewport-page cy-reset\"\n style={{ insetInlineStart: x, insetBlockStart: y, inlineSize: w, blockSize: h }}\n >\n {renderPage({ id: page.id, index: i, scale, visible: rect !== null, visibleRect: rect })}\n </div>\n ))}\n </div>\n </section>\n <span className=\"cy-visually-hidden\" role=\"status\">\n {said.text}\n </span>\n </>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"DocumentViewport.js","names":["_Fragment","useControllableState","useClientLayoutEffect","useVirtualWindow","anchoredScroll","zoomScale","useZoomGestures","useEffect","useRef","useState","Fragment$1","jsx","jsxs","DEFAULT_LABELS","n","total","percent","useReport","value","key","callback","latest","last","DocumentViewport","label","pages","zoom","defaultZoom","onZoomChange","renderPage","onVisiblePagesChange","onCurrentPageChange","onScaleChange","scrollTo","labels","className","style","text","scroller","setting","setSetting","gap","setGap","g","sizesAt","scale","p","setScale","win","next","scrollLeft","setScrollLeft","widest","contentWidth","anchor","gestures","at","lastScale","el","a","to","top","height","view","placed","i","page","w","h","x","y","l","t","r","b","rect","inView","current","best","lastNonce","pendingFocus","id","slot","said","setSaid","e"],"sources":["../../../src/components/DocumentViewport/DocumentViewport.tsx"],"sourcesContent":["import { type CSSProperties, type ReactNode, useEffect, useRef, useState } from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { useVirtualWindow } from \"../../foundations/virtual-window.js\";\nimport { anchoredScroll, type ZoomSetting, zoomScale } from \"../../foundations/zoom.js\";\nimport { useZoomGestures, type ZoomAnchor } from \"../../foundations/zoom-gestures.js\";\n\nexport type { ZoomSetting };\n\nexport interface DocumentViewportTokens {\n /** Behind the pages. */\n background: string;\n /** Space between and around pages. */\n gap: string;\n /** A page's shadow. */\n pageShadow: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n documentViewport: DocumentViewportTokens;\n }\n}\n\nexport interface ViewportPage {\n id: string;\n /** Size at 100%, in CSS pixels (a PDF point is one). */\n width: number;\n height: number;\n}\n\nexport interface PageRect {\n left: number;\n top: number;\n width: number;\n height: number;\n}\n\nexport interface RenderPageProps {\n /** The page's `id` from `pages`. */\n id: string;\n /** Position of the page in `pages`, from 0. */\n index: number;\n /** 1 = 100%. Draw at `width` by `height` times `scale`. */\n scale: number;\n /** In view now (pages just outside are rendered too, so scrolling is seamless). */\n visible: boolean;\n /** The part of the page in view, in its own scaled pixels; null when none is. Render only that, for huge pages. */\n visibleRect: PageRect | null;\n}\n\n/** Scroll to a page, or to a rect on it (centred), at 100% units. A new `nonce` scrolls again. */\nexport interface ScrollRequest {\n id: string;\n nonce: number;\n rect?: PageRect;\n /** Move focus to the page afterwards (go-to-page). */\n focus?: boolean;\n}\n\nexport interface DocumentViewportLabels {\n /** A page's name. Default \"Page 3 of 12\". */\n page: (number: number, total: number) => string;\n /** Announced when the zoom changes. Default \"Zoom 125%\". */\n zoom: (percent: number) => string;\n}\n\nexport interface DocumentViewportProps {\n /** Names the viewport (\"Document\", \"Contract.pdf\"). */\n label: string;\n /** The pages, top to bottom, each with its size at 100%. */\n pages: readonly ViewportPage[];\n /** The zoom setting, when you control it: fit width, fit page or a percent. */\n zoom?: ZoomSetting | undefined;\n /** Default fit-width. */\n defaultZoom?: ZoomSetting;\n /** Gestures and keys ask for a percent. */\n onZoomChange?: ((zoom: ZoomSetting) => void) | undefined;\n /** Draws one page. Called for each page in or near the view. */\n renderPage: (page: RenderPageProps) => ReactNode;\n /** The pages in view, top to bottom. */\n onVisiblePagesChange?: ((ids: string[]) => void) | undefined;\n /** The page with the most of itself in view. */\n onCurrentPageChange?: ((id: string | null) => void) | undefined;\n /** The scale the zoom came to (fit modes depend on the viewport). */\n onScaleChange?: ((scale: number) => void) | undefined;\n /** Scrolls to a page, or to a rect on it. A new `nonce` scrolls again. */\n scrollTo?: ScrollRequest | undefined;\n /** Replace the built-in English text: page names and the zoom announcement. */\n labels?: Partial<DocumentViewportLabels>;\n /** Added to the scrolling root element, for layout. */\n className?: string;\n /** Layout only (give it a height). Restyle through --cy-document-viewport-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: DocumentViewportLabels = {\n page: (n, total) => `Page ${n} of ${total}`,\n zoom: (percent) => `Zoom ${percent}%`,\n};\n\n/** Calls the latest `callback` with `value` whenever `value` (compared by `key`) changes. */\nfunction useReport<T>(value: T, key: string, callback: ((v: T) => void) | undefined) {\n const latest = useRef(callback);\n latest.current = callback;\n const last = useRef<string | null>(null);\n useEffect(() => {\n if (last.current === key) return;\n last.current = key;\n latest.current?.(value);\n });\n}\n\n/**\n * A scrolling, zoomable document: pages one under another, only those near the view rendered, zoomed by setting\n * (fit width, fit page, a percent), Ctrl/Cmd+wheel or a pinch around the pointer, panned with Space+drag. It reports\n * the pages in view and the current page, scrolls to a page or a spot on it on request, and announces zoom changes.\n */\nexport function DocumentViewport({\n label,\n pages,\n zoom,\n defaultZoom = { kind: \"fit-width\" },\n onZoomChange,\n renderPage,\n onVisiblePagesChange,\n onCurrentPageChange,\n onScaleChange,\n scrollTo,\n labels,\n className,\n style,\n}: DocumentViewportProps) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const scroller = useRef<HTMLElement>(null);\n const [setting, setSetting] = useControllableState(zoom, defaultZoom, onZoomChange);\n // The gap comes from the token, in pixels, for the layout maths.\n const [gap, setGap] = useState(16);\n useClientLayoutEffect(() => {\n const g = Number.parseFloat(getComputedStyle(scroller.current as HTMLElement).getPropertyValue(\"--_gap\"));\n if (g !== gap) setGap(g);\n });\n\n // The viewport's size feeds the fit modes; the windowing measures it.\n const sizesAt = (scale: number) => pages.map((p) => p.height * scale);\n const [scale, setScale] = useState(1);\n const win = useVirtualWindow(scroller, { count: pages.length, sizes: sizesAt(scale), gap, overscan: 1 });\n const next = zoomScale(setting, pages, win.view, gap);\n if (next !== scale) setScale(next);\n const percent = Math.round(scale * 100);\n\n const [scrollLeft, setScrollLeft] = useState(0);\n const widest = Math.max(0, ...pages.map((p) => p.width * scale));\n const contentWidth = Math.max(win.view.width, widest + 2 * gap);\n\n // Zooming keeps the point under the pointer (or the viewport's centre) where it is.\n const anchor = useRef<{ at: { x: number; y: number }; from: number } | null>(null);\n const gestures = useZoomGestures(scroller, {\n percent,\n onZoom: (value, at: ZoomAnchor) => {\n anchor.current = { at: at ?? { x: win.view.width / 2, y: win.view.height / 2 }, from: scale };\n setSetting({ kind: \"percent\", value });\n },\n });\n const lastScale = useRef(scale);\n useClientLayoutEffect(() => {\n const el = scroller.current as HTMLElement;\n if (lastScale.current === scale) return;\n const a = anchor.current ?? {\n at: { x: el.clientWidth / 2, y: el.clientHeight / 2 },\n from: lastScale.current,\n };\n anchor.current = null;\n lastScale.current = scale;\n const to = anchoredScroll({ left: el.scrollLeft, top: el.scrollTop }, a.at, scale / a.from);\n el.scrollLeft = to.left;\n el.scrollTop = to.top;\n win.onScroll(el.scrollTop);\n setScrollLeft(el.scrollLeft);\n });\n\n // In view: which pages, and how much of each.\n const { top, height } = win.view;\n const view = { left: scrollLeft, right: scrollLeft + win.view.width, top, bottom: top + height };\n const placed = win.indices.map((i) => {\n const page = pages[i] as ViewportPage;\n const w = page.width * scale;\n const h = page.height * scale;\n const x = (contentWidth - w) / 2;\n const y = win.offsetOf(i);\n const l = Math.max(0, view.left - x);\n const t = Math.max(0, view.top - y);\n const r = Math.min(w, view.right - x);\n const b = Math.min(h, view.bottom - y);\n const rect = height > 0 && r > l && b > t ? { left: l, top: t, width: r - l, height: b - t } : null;\n return { page, i, w, h, x, y, rect, area: rect ? rect.width * rect.height : 0 };\n });\n const inView = placed.filter((p) => p.rect).sort((a, b) => a.i - b.i);\n const current = inView.reduce<(typeof placed)[number] | null>(\n (best, p) => (!best || p.area > best.area ? p : best),\n null,\n );\n useReport(\n inView.map((p) => p.page.id),\n inView.map((p) => p.page.id).join(\" \"),\n onVisiblePagesChange,\n );\n useReport(current?.page.id ?? null, current?.page.id ?? \"\", onCurrentPageChange);\n useReport(scale, String(scale), onScaleChange);\n\n // Scroll requests: only a new nonce scrolls; focus waits for the page to be rendered there.\n const lastNonce = useRef<number | null>(null);\n const pendingFocus = useRef<string | null>(null);\n useClientLayoutEffect(() => {\n const el = scroller.current as HTMLElement;\n if (!scrollTo || scrollTo.nonce === lastNonce.current) return;\n const i = pages.findIndex((p) => p.id === scrollTo.id);\n if (i < 0) return;\n lastNonce.current = scrollTo.nonce;\n const page = pages[i] as ViewportPage;\n const { rect } = scrollTo;\n if (rect) {\n el.scrollTop = win.offsetOf(i) + rect.top * scale - (el.clientHeight - rect.height * scale) / 2;\n el.scrollLeft =\n (contentWidth - page.width * scale) / 2 +\n rect.left * scale -\n (el.clientWidth - rect.width * scale) / 2;\n } else el.scrollTop = win.offsetOf(i) - gap;\n win.onScroll(el.scrollTop);\n setScrollLeft(el.scrollLeft);\n pendingFocus.current = scrollTo.focus ? scrollTo.id : null;\n });\n useClientLayoutEffect(() => {\n const id = pendingFocus.current;\n const slot = id && scroller.current?.querySelector<HTMLElement>(`[data-page=\"${CSS.escape(id)}\"]`);\n if (!slot) return;\n pendingFocus.current = null;\n slot.focus({ preventScroll: true });\n });\n\n // Zoom changes are announced; the first value is not.\n const [said, setSaid] = useState({ percent, text: \"\" });\n if (said.percent !== percent) setSaid({ percent, text: text.zoom(percent) });\n\n return (\n <>\n <section\n ref={scroller}\n aria-label={label}\n // biome-ignore lint/a11y/noNoninteractiveTabindex: the document scrolls and zooms from the keyboard, so it is a tab stop\n tabIndex={0}\n className={className ? `cy-document-viewport ${className}` : \"cy-document-viewport\"}\n data-panning={gestures.panning ? \"\" : undefined}\n style={style}\n onKeyDown={gestures.onKeyDown}\n onKeyUp={gestures.onKeyUp}\n onBlur={gestures.onBlur}\n onScroll={(e) => {\n win.onScroll(e.currentTarget.scrollTop);\n setScrollLeft(e.currentTarget.scrollLeft);\n }}\n >\n <div\n className=\"cy-document-viewport-content cy-reset\"\n style={{ inlineSize: contentWidth, blockSize: win.total }}\n >\n {placed.map(({ page, i, w, h, x, y, rect }) => (\n // biome-ignore lint/a11y/useSemanticElements: a page is a named group of whatever it shows, not a form fieldset\n <div\n key={page.id}\n role=\"group\"\n aria-label={text.page(i + 1, pages.length)}\n data-page={page.id}\n // Reached by go-to-page (focus), not in the Tab order.\n tabIndex={-1}\n className=\"cy-document-viewport-page cy-reset\"\n style={{ insetInlineStart: x, insetBlockStart: y, inlineSize: w, blockSize: h }}\n >\n {renderPage({ id: page.id, index: i, scale, visible: rect !== null, visibleRect: rect })}\n </div>\n ))}\n </div>\n </section>\n <span className=\"cy-visually-hidden\" role=\"status\">\n {said.text}\n </span>\n </>\n );\n}\n"],"mappings":"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"}
@@ -14,14 +14,20 @@ declare module "../../tokens/schema.js" {
14
14
  export interface EmptyStateProps {
15
15
  /** A Facet icon shown above the title (decorative). */
16
16
  icon?: IconData | undefined;
17
+ /** The heading: what is empty or missing. */
17
18
  title: ReactNode;
19
+ /** A sentence under the title. */
18
20
  description?: ReactNode | undefined;
19
21
  /** Buttons for the next step ("Create a project", "Clear filters"). */
20
22
  actions?: ReactNode | undefined;
21
- /** Heading level of the title, to fit the page outline (default 3). */
22
- headingLevel?: 2 | 3 | 4 | 5 | 6;
23
+ /**
24
+ * Heading level of the title, to fit the page outline (default 3). 1 when the empty state is the page itself (a
25
+ * not-found page): the look stays the same.
26
+ */
27
+ headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
23
28
  /** `sm` for panels and popups, `md` for page areas. */
24
29
  size?: Extract<Size, "sm" | "md">;
30
+ /** Added to the root element, for layout. */
25
31
  className?: string;
26
32
  /** Layout only. Restyle through --cy-empty-state-* tokens. */
27
33
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"EmptyState.js","names":["Icon","createElement","jsx","jsxs","EmptyState","icon","title","description","actions","headingLevel","size","className","style"],"sources":["../../../src/components/EmptyState/EmptyState.tsx"],"sourcesContent":["import { type CSSProperties, createElement, type ReactNode } from \"react\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface EmptyStateTokens {\n gap: string;\n padding: string;\n maxWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n emptyState: EmptyStateTokens;\n }\n}\n\nexport interface EmptyStateProps {\n /** A Facet icon shown above the title (decorative). */\n icon?: IconData | undefined;\n title: ReactNode;\n description?: ReactNode | undefined;\n /** Buttons for the next step (\"Create a project\", \"Clear filters\"). */\n actions?: ReactNode | undefined;\n /** Heading level of the title, to fit the page outline (default 3). */\n headingLevel?: 2 | 3 | 4 | 5 | 6;\n /** `sm` for panels and popups, `md` for page areas. */\n size?: Extract<Size, \"sm\" | \"md\">;\n className?: string;\n /** Layout only. Restyle through --cy-empty-state-* tokens. */\n style?: CSSProperties;\n}\n\n/** What to show where content will be: no items yet, no search results, nothing selected. */\nexport function EmptyState({\n icon,\n title,\n description,\n actions,\n headingLevel = 3,\n size = \"md\",\n className,\n style,\n}: EmptyStateProps) {\n return (\n <div\n className={className ? `cy-empty-state ${className}` : \"cy-empty-state\"}\n data-size={size}\n style={style}\n >\n {icon && (\n <span className=\"cy-empty-state-icon cy-reset\">\n <Icon icon={icon} size=\"lg\" />\n </span>\n )}\n {createElement(`h${headingLevel}`, { className: \"cy-empty-state-title cy-reset\" }, title)}\n {description && <p className=\"cy-empty-state-description cy-reset\">{description}</p>}\n {actions && <div className=\"cy-empty-state-actions cy-reset\">{actions}</div>}\n </div>\n );\n}\n"],"mappings":";;;;AAkCA,SAAgBI,EAAW,EACzB,MAAAC,GACA,OAAAC,GACA,aAAAC,GACA,SAAAC,GACA,cAAAC,IAAe,GACf,MAAAC,IAAO,MACP,WAAAC,GACA,OAAAC,EAAA,GACkB;AAClB,SACE,gBAAAT,EAAC,OAAD;AAAA,IACE,WAAWQ,IAAY,kBAAkBA,CAAA,KAAc;AAAA,IACvD,aAAWD;AAAA,IACJ,OAAAE;AAAA,IAHT,UAAA;AAAA,MAKGP,KACC,gBAAAH,EAAC,QAAD;AAAA,QAAM,WAAU;AAAA,QACd,UAAA,gBAAAA,EAACF,GAAD;AAAA,UAAY,MAAAK;AAAA,UAAM,MAAK;AAAA,QAAM,CAAA;AAAA,MACzB,CAAA;AAAA,MAEPJ,EAAc,IAAIQ,CAAA,IAAgB,EAAE,WAAW,gCAAgC,GAAGH,CAAK;AAAA,MACvFC,KAAe,gBAAAL,EAAC,KAAD;AAAA,QAAG,WAAU;AAAA,QAAuC,UAAAK;AAAA,MAAe,CAAA;AAAA,MAClFC,KAAW,gBAAAN,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QAAmC,UAAAM;AAAA,MAAa,CAAA;AAAA,IACxE;AAAA,E;AAET"}
1
+ {"version":3,"file":"EmptyState.js","names":["Icon","createElement","jsx","jsxs","EmptyState","icon","title","description","actions","headingLevel","size","className","style"],"sources":["../../../src/components/EmptyState/EmptyState.tsx"],"sourcesContent":["import { type CSSProperties, createElement, type ReactNode } from \"react\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface EmptyStateTokens {\n gap: string;\n padding: string;\n maxWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n emptyState: EmptyStateTokens;\n }\n}\n\nexport interface EmptyStateProps {\n /** A Facet icon shown above the title (decorative). */\n icon?: IconData | undefined;\n /** The heading: what is empty or missing. */\n title: ReactNode;\n /** A sentence under the title. */\n description?: ReactNode | undefined;\n /** Buttons for the next step (\"Create a project\", \"Clear filters\"). */\n actions?: ReactNode | undefined;\n /**\n * Heading level of the title, to fit the page outline (default 3). 1 when the empty state is the page itself (a\n * not-found page): the look stays the same.\n */\n headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;\n /** `sm` for panels and popups, `md` for page areas. */\n size?: Extract<Size, \"sm\" | \"md\">;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-empty-state-* tokens. */\n style?: CSSProperties;\n}\n\n/** What to show where content will be: no items yet, no search results, nothing selected. */\nexport function EmptyState({\n icon,\n title,\n description,\n actions,\n headingLevel = 3,\n size = \"md\",\n className,\n style,\n}: EmptyStateProps) {\n return (\n <div\n className={className ? `cy-empty-state ${className}` : \"cy-empty-state\"}\n data-size={size}\n style={style}\n >\n {icon && (\n <span className=\"cy-empty-state-icon cy-reset\">\n <Icon icon={icon} size=\"lg\" />\n </span>\n )}\n {createElement(`h${headingLevel}`, { className: \"cy-empty-state-title cy-reset\" }, title)}\n {description && <p className=\"cy-empty-state-description cy-reset\">{description}</p>}\n {actions && <div className=\"cy-empty-state-actions cy-reset\">{actions}</div>}\n </div>\n );\n}\n"],"mappings":";;;;AAwCA,SAAgBI,EAAW,EACzB,MAAAC,GACA,OAAAC,GACA,aAAAC,GACA,SAAAC,GACA,cAAAC,IAAe,GACf,MAAAC,IAAO,MACP,WAAAC,GACA,OAAAC,EAAA,GACkB;AAClB,SACE,gBAAAT,EAAC,OAAD;AAAA,IACE,WAAWQ,IAAY,kBAAkBA,CAAA,KAAc;AAAA,IACvD,aAAWD;AAAA,IACJ,OAAAE;AAAA,IAHT,UAAA;AAAA,MAKGP,KACC,gBAAAH,EAAC,QAAD;AAAA,QAAM,WAAU;AAAA,QACd,UAAA,gBAAAA,EAACF,GAAD;AAAA,UAAY,MAAAK;AAAA,UAAM,MAAK;AAAA,QAAM,CAAA;AAAA,MACzB,CAAA;AAAA,MAEPJ,EAAc,IAAIQ,CAAA,IAAgB,EAAE,WAAW,gCAAgC,GAAGH,CAAK;AAAA,MACvFC,KAAe,gBAAAL,EAAC,KAAD;AAAA,QAAG,WAAU;AAAA,QAAuC,UAAAK;AAAA,MAAe,CAAA;AAAA,MAClFC,KAAW,gBAAAN,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QAAmC,UAAAM;AAAA,MAAa,CAAA;AAAA,IACxE;AAAA,E;AAET"}
@@ -15,21 +15,27 @@ declare module "../../tokens/schema.js" {
15
15
  }
16
16
  }
17
17
  export interface FieldProps {
18
+ /** Visible label; it names the control. */
18
19
  label: ReactNode;
20
+ /** Help text shown below the control and read out with it. */
19
21
  description?: ReactNode | undefined;
20
22
  /** Shown below the control, announced, and marks the control invalid. */
21
23
  error?: ReactNode | undefined;
22
24
  /** Draws the required marker; pass `required` to the control too. */
23
25
  required?: boolean | undefined;
26
+ /** Size of the label text. Default "md". */
24
27
  size?: Size | undefined;
25
28
  /** Keep the label for assistive tech but take no space (toolbars, dense rows). Prefer visible labels. */
26
29
  labelHidden?: boolean | undefined;
27
30
  /** Label a group of controls (radio groups) instead of one control. */
28
31
  group?: boolean | undefined;
32
+ /** Id for the control; the label, description and error ids are built from it. Default: a generated id. */
29
33
  id?: string | undefined;
34
+ /** Added to the root element, for layout. */
30
35
  className?: string | undefined;
31
36
  /** Layout only. */
32
37
  style?: CSSProperties | undefined;
38
+ /** Renders the control from the ids and state in `field`. */
33
39
  children: (field: FieldRender) => ReactNode;
34
40
  }
35
41
  /** Label, description and error wiring for any control. Controls render through `children(field)`. */
@@ -1,55 +1,53 @@
1
1
  "use client";
2
- import { useField as y } from "../../foundations/field.js";
3
- import { Fragment as p, jsx as e, jsxs as v } from "react/jsx-runtime";
4
- function F({ label: l, description: i, error: a, required: r, size: m = "md", group: s, labelHidden: c, id: b, className: n, style: f, children: h }) {
5
- const d = y({
6
- id: b,
7
- description: i,
2
+ import { useField as p } from "../../foundations/field.js";
3
+ import { Fragment as u, jsx as d, jsxs as v } from "react/jsx-runtime";
4
+ function N({ label: i, description: l, error: a, required: s, size: b = "md", group: r, labelHidden: m, id: y, className: c, style: f, children: h }) {
5
+ const e = p({
6
+ id: y,
7
+ description: l,
8
8
  error: a
9
- }), t = /* @__PURE__ */ v(p, { children: [
10
- s ? /* @__PURE__ */ e("span", {
11
- id: d.labelId,
12
- className: "cy-field-label",
13
- "data-required": r ? "" : void 0,
14
- "data-hidden": c ? "" : void 0,
15
- children: l
16
- }) : /* @__PURE__ */ e("label", {
17
- id: d.labelId,
18
- htmlFor: d.id,
19
- className: "cy-field-label",
20
- "data-required": r ? "" : void 0,
21
- "data-hidden": c ? "" : void 0,
22
- children: l
9
+ }), n = m ? "cy-field-label cy-visually-hidden" : "cy-field-label", t = /* @__PURE__ */ v(u, { children: [
10
+ r ? /* @__PURE__ */ d("span", {
11
+ id: e.labelId,
12
+ className: n,
13
+ "data-required": s ? "" : void 0,
14
+ children: i
15
+ }) : /* @__PURE__ */ d("label", {
16
+ id: e.labelId,
17
+ htmlFor: e.id,
18
+ className: n,
19
+ "data-required": s ? "" : void 0,
20
+ children: i
23
21
  }),
24
- h(d),
25
- i && /* @__PURE__ */ e("span", {
26
- id: d.descriptionId,
22
+ h(e),
23
+ l && /* @__PURE__ */ d("span", {
24
+ id: e.descriptionId,
27
25
  className: "cy-field-description",
28
- children: i
26
+ children: l
29
27
  }),
30
- d.invalid && /* @__PURE__ */ e("span", {
31
- id: d.errorId,
28
+ e.invalid && /* @__PURE__ */ d("span", {
29
+ id: e.errorId,
32
30
  className: "cy-field-error",
33
31
  role: "alert",
34
32
  children: a
35
33
  })
36
34
  ] }), o = {
37
- className: `cy-field${n ? ` ${n}` : ""}`,
38
- "data-size": m,
35
+ className: `cy-field${c ? ` ${c}` : ""}`,
36
+ "data-size": b,
39
37
  style: f
40
38
  };
41
- return s ? /* @__PURE__ */ e("fieldset", {
39
+ return r ? /* @__PURE__ */ d("fieldset", {
42
40
  ...o,
43
- "aria-labelledby": d.labelId,
44
- "aria-describedby": d.describedBy,
41
+ "aria-labelledby": e.labelId,
42
+ "aria-describedby": e.describedBy,
45
43
  children: t
46
- }) : /* @__PURE__ */ e("div", {
44
+ }) : /* @__PURE__ */ d("div", {
47
45
  ...o,
48
46
  children: t
49
47
  });
50
48
  }
51
49
  export {
52
- F as Field
50
+ N as Field
53
51
  };
54
52
 
55
53
  //# sourceMappingURL=Field.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Field.js","names":["_Fragment","useField","Fragment","jsx","jsxs","Field","label","description","error","required","size","group","labelHidden","id","className","style","children","field","body","props"],"sources":["../../../src/components/Field/Field.tsx"],"sourcesContent":["import type { CSSProperties, ReactNode } from \"react\";\nimport { type FieldRender, useField } from \"../../foundations/field.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface FieldTokens {\n gap: string;\n labelWeight: string;\n labelColor: string;\n descriptionColor: string;\n errorColor: string;\n requiredColor: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n field: FieldTokens;\n }\n}\n\nexport interface FieldProps {\n label: ReactNode;\n description?: ReactNode | undefined;\n /** Shown below the control, announced, and marks the control invalid. */\n error?: ReactNode | undefined;\n /** Draws the required marker; pass `required` to the control too. */\n required?: boolean | undefined;\n size?: Size | undefined;\n /** Keep the label for assistive tech but take no space (toolbars, dense rows). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n /** Label a group of controls (radio groups) instead of one control. */\n group?: boolean | undefined;\n id?: string | undefined;\n className?: string | undefined;\n /** Layout only. */\n style?: CSSProperties | undefined;\n children: (field: FieldRender) => ReactNode;\n}\n\n/** Label, description and error wiring for any control. Controls render through `children(field)`. */\nexport function Field({\n label,\n description,\n error,\n required,\n size = \"md\",\n group,\n labelHidden,\n id,\n className,\n style,\n children,\n}: FieldProps) {\n const field = useField({ id, description, error });\n const body = (\n <>\n {group ? (\n <span\n id={field.labelId}\n className=\"cy-field-label\"\n data-required={required ? \"\" : undefined}\n data-hidden={labelHidden ? \"\" : undefined}\n >\n {label}\n </span>\n ) : (\n <label\n id={field.labelId}\n htmlFor={field.id}\n className=\"cy-field-label\"\n data-required={required ? \"\" : undefined}\n data-hidden={labelHidden ? \"\" : undefined}\n >\n {label}\n </label>\n )}\n {children(field)}\n {description && (\n <span id={field.descriptionId} className=\"cy-field-description\">\n {description}\n </span>\n )}\n {field.invalid && (\n <span id={field.errorId} className=\"cy-field-error\" role=\"alert\">\n {error}\n </span>\n )}\n </>\n );\n const props = { className: `cy-field${className ? ` ${className}` : \"\"}`, \"data-size\": size, style };\n return group ? (\n <fieldset {...props} aria-labelledby={field.labelId} aria-describedby={field.describedBy}>\n {body}\n </fieldset>\n ) : (\n <div {...props}>{body}</div>\n );\n}\n"],"mappings":";;;AAuCA,SAAgBK,EAAM,EACpB,OAAAC,GACA,aAAAC,GACA,OAAAC,GACA,UAAAC,GACA,MAAAC,IAAO,MACP,OAAAC,GACA,aAAAC,GACA,IAAAC,GACA,WAAAC,GACA,OAAAC,GACA,UAAAC,EAAA,GACa;AACb,QAAMC,IAAQhB,EAAS;AAAA,IAAE,IAAAY;AAAA,IAAI,aAAAN;AAAA,IAAa,OAAAC;AAAA,EAAM,CAAC,GAC3CU,IACJ,gBAAAd,EAAAJ,GAAA,EAAA,UAAA;AAAA,IACGW,IACC,gBAAAR,EAAC,QAAD;AAAA,MACE,IAAIc,EAAM;AAAA,MACV,WAAU;AAAA,MACV,iBAAeR,IAAW,KAAK;AAAA,MAC/B,eAAaG,IAAc,KAAK;AAAA,MAE/B,UAAAN;AAAA,IACG,CAAA,IAEN,gBAAAH,EAAC,SAAD;AAAA,MACE,IAAIc,EAAM;AAAA,MACV,SAASA,EAAM;AAAA,MACf,WAAU;AAAA,MACV,iBAAeR,IAAW,KAAK;AAAA,MAC/B,eAAaG,IAAc,KAAK;AAAA,MAE/B,UAAAN;AAAA,IACI,CAAA;AAAA,IAERU,EAASC,CAAK;AAAA,IACdV,KACC,gBAAAJ,EAAC,QAAD;AAAA,MAAM,IAAIc,EAAM;AAAA,MAAe,WAAU;AAAA,MACtC,UAAAV;AAAA,IACG,CAAA;AAAA,IAEPU,EAAM,WACL,gBAAAd,EAAC,QAAD;AAAA,MAAM,IAAIc,EAAM;AAAA,MAAS,WAAU;AAAA,MAAiB,MAAK;AAAA,MACtD,UAAAT;AAAA,IACG,CAAA;AAAA,EAER,EAAA,CAAA,GAEEW,IAAQ;AAAA,IAAE,WAAW,WAAWL,IAAY,IAAIA,CAAA,KAAc,EAAA;AAAA,IAAM,aAAaJ;AAAA,IAAM,OAAAK;AAAA,EAAM;AACnG,SAAOJ,IACL,gBAAAR,EAAC,YAAD;AAAA,IAAU,GAAIgB;AAAA,IAAO,mBAAiBF,EAAM;AAAA,IAAS,oBAAkBA,EAAM;AAAA,IAC1E,UAAAC;AAAA,EACO,CAAA,IAEV,gBAAAf,EAAC,OAAD;AAAA,IAAK,GAAIgB;AAAA,IAAQ,UAAAD;AAAA,EAAU,CAAA;AAE/B"}
1
+ {"version":3,"file":"Field.js","names":["_Fragment","useField","Fragment","jsx","jsxs","Field","label","description","error","required","size","group","labelHidden","id","className","style","children","field","labelClass","body","props"],"sources":["../../../src/components/Field/Field.tsx"],"sourcesContent":["import type { CSSProperties, ReactNode } from \"react\";\nimport { type FieldRender, useField } from \"../../foundations/field.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface FieldTokens {\n gap: string;\n labelWeight: string;\n labelColor: string;\n descriptionColor: string;\n errorColor: string;\n requiredColor: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n field: FieldTokens;\n }\n}\n\nexport interface FieldProps {\n /** Visible label; it names the control. */\n label: ReactNode;\n /** Help text shown below the control and read out with it. */\n description?: ReactNode | undefined;\n /** Shown below the control, announced, and marks the control invalid. */\n error?: ReactNode | undefined;\n /** Draws the required marker; pass `required` to the control too. */\n required?: boolean | undefined;\n /** Size of the label text. Default \"md\". */\n size?: Size | undefined;\n /** Keep the label for assistive tech but take no space (toolbars, dense rows). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n /** Label a group of controls (radio groups) instead of one control. */\n group?: boolean | undefined;\n /** Id for the control; the label, description and error ids are built from it. Default: a generated id. */\n id?: string | undefined;\n /** Added to the root element, for layout. */\n className?: string | undefined;\n /** Layout only. */\n style?: CSSProperties | undefined;\n /** Renders the control from the ids and state in `field`. */\n children: (field: FieldRender) => ReactNode;\n}\n\n/** Label, description and error wiring for any control. Controls render through `children(field)`. */\nexport function Field({\n label,\n description,\n error,\n required,\n size = \"md\",\n group,\n labelHidden,\n id,\n className,\n style,\n children,\n}: FieldProps) {\n const field = useField({ id, description, error });\n // A hidden label stays in the accessibility tree; out of the flow, the grid gap collapses with it.\n const labelClass = labelHidden ? \"cy-field-label cy-visually-hidden\" : \"cy-field-label\";\n const body = (\n <>\n {group ? (\n <span id={field.labelId} className={labelClass} data-required={required ? \"\" : undefined}>\n {label}\n </span>\n ) : (\n <label\n id={field.labelId}\n htmlFor={field.id}\n className={labelClass}\n data-required={required ? \"\" : undefined}\n >\n {label}\n </label>\n )}\n {children(field)}\n {description && (\n <span id={field.descriptionId} className=\"cy-field-description\">\n {description}\n </span>\n )}\n {field.invalid && (\n <span id={field.errorId} className=\"cy-field-error\" role=\"alert\">\n {error}\n </span>\n )}\n </>\n );\n const props = { className: `cy-field${className ? ` ${className}` : \"\"}`, \"data-size\": size, style };\n return group ? (\n <fieldset {...props} aria-labelledby={field.labelId} aria-describedby={field.describedBy}>\n {body}\n </fieldset>\n ) : (\n <div {...props}>{body}</div>\n );\n}\n"],"mappings":";;;AA6CA,SAAgBK,EAAM,EACpB,OAAAC,GACA,aAAAC,GACA,OAAAC,GACA,UAAAC,GACA,MAAAC,IAAO,MACP,OAAAC,GACA,aAAAC,GACA,IAAAC,GACA,WAAAC,GACA,OAAAC,GACA,UAAAC,EAAA,GACa;AACb,QAAMC,IAAQhB,EAAS;AAAA,IAAE,IAAAY;AAAA,IAAI,aAAAN;AAAA,IAAa,OAAAC;AAAA,EAAM,CAAC,GAE3CU,IAAaN,IAAc,sCAAsC,kBACjEO,IACJ,gBAAAf,EAAAJ,GAAA,EAAA,UAAA;AAAA,IACGW,IACC,gBAAAR,EAAC,QAAD;AAAA,MAAM,IAAIc,EAAM;AAAA,MAAS,WAAWC;AAAA,MAAY,iBAAeT,IAAW,KAAK;AAAA,MAC5E,UAAAH;AAAA,IACG,CAAA,IAEN,gBAAAH,EAAC,SAAD;AAAA,MACE,IAAIc,EAAM;AAAA,MACV,SAASA,EAAM;AAAA,MACf,WAAWC;AAAA,MACX,iBAAeT,IAAW,KAAK;AAAA,MAE9B,UAAAH;AAAA,IACI,CAAA;AAAA,IAERU,EAASC,CAAK;AAAA,IACdV,KACC,gBAAAJ,EAAC,QAAD;AAAA,MAAM,IAAIc,EAAM;AAAA,MAAe,WAAU;AAAA,MACtC,UAAAV;AAAA,IACG,CAAA;AAAA,IAEPU,EAAM,WACL,gBAAAd,EAAC,QAAD;AAAA,MAAM,IAAIc,EAAM;AAAA,MAAS,WAAU;AAAA,MAAiB,MAAK;AAAA,MACtD,UAAAT;AAAA,IACG,CAAA;AAAA,EAER,EAAA,CAAA,GAEEY,IAAQ;AAAA,IAAE,WAAW,WAAWN,IAAY,IAAIA,CAAA,KAAc,EAAA;AAAA,IAAM,aAAaJ;AAAA,IAAM,OAAAK;AAAA,EAAM;AACnG,SAAOJ,IACL,gBAAAR,EAAC,YAAD;AAAA,IAAU,GAAIiB;AAAA,IAAO,mBAAiBH,EAAM;AAAA,IAAS,oBAAkBA,EAAM;AAAA,IAC1E,UAAAE;AAAA,EACO,CAAA,IAEV,gBAAAhB,EAAC,OAAD;AAAA,IAAK,GAAIiB;AAAA,IAAQ,UAAAD;AAAA,EAAU,CAAA;AAE/B"}
@@ -37,6 +37,7 @@ export interface FileDropProps {
37
37
  onReject?: (rejections: FileRejection[]) => void;
38
38
  /** File types, as for `<input accept>`: ".pdf,image/*". */
39
39
  accept?: string | undefined;
40
+ /** Take more than one file at a time. */
40
41
  multiple?: boolean;
41
42
  /** Largest file in bytes. */
42
43
  maxSize?: number | undefined;
@@ -49,12 +50,19 @@ export interface FileDropProps {
49
50
  target?: "zone" | "window";
50
51
  /** Shown under the prompt, e.g. "PNG or JPG, up to 5 MB". */
51
52
  hint?: ReactNode;
53
+ /** Name the accepted files are submitted under in a form. */
52
54
  name?: string | undefined;
55
+ /** Id of the form it belongs to, when it is not inside that form. */
53
56
  form?: string | undefined;
57
+ /** Marks the file input as required for form validation. */
54
58
  required?: boolean | undefined;
59
+ /** Turns off dropping and the button. */
55
60
  disabled?: boolean | undefined;
61
+ /** Size of the zone and its button. Default "md". */
56
62
  size?: Size;
63
+ /** Replace the built-in English text. */
57
64
  labels?: Partial<FileDropLabels>;
65
+ /** Added to the root element, for layout. */
58
66
  className?: string;
59
67
  /** Layout only. Restyle through --cy-file-drop-* tokens. */
60
68
  style?: CSSProperties;
@@ -6,7 +6,7 @@ import { FileInputBase as J, setInputFiles as K } from "../../foundations/FileIn
6
6
  import { upload as W } from "../../icons/upload.js";
7
7
  import { useEffect as M, useId as Q, useRef as N, useState as C } from "react";
8
8
  import { jsx as o, jsxs as k } from "react/jsx-runtime";
9
- var X = (t, n, d) => `${t} ${t === 1 ? n : d}`, Z = {
9
+ var X = (t, n, f) => `${t} ${t === 1 ? n : f}`, Z = {
10
10
  prompt: "Drop files here, or",
11
11
  choose: "Choose files",
12
12
  chooseOne: "Choose a file",
@@ -16,16 +16,16 @@ var X = (t, n, d) => `${t} ${t === 1 ? n : d}`, Z = {
16
16
  };
17
17
  function ee(t, n) {
18
18
  if (!n) return !0;
19
- const d = t.name.toLowerCase(), p = t.type.toLowerCase();
20
- return n.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean).some((s) => s.startsWith(".") ? d.endsWith(s) : s.endsWith("/*") ? p.startsWith(s.slice(0, -1)) : p === s);
19
+ const f = t.name.toLowerCase(), p = t.type.toLowerCase();
20
+ return n.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean).some((s) => s.startsWith(".") ? f.endsWith(s) : s.endsWith("/*") ? p.startsWith(s.slice(0, -1)) : p === s);
21
21
  }
22
- function ce({ onFiles: t, onReject: n, accept: d, multiple: p = !1, maxSize: s, maxFiles: P, hint: w, target: S = "zone", name: A, form: _, required: b, disabled: a = !1, size: I = "md", labels: R, className: j, style: U }) {
22
+ function ce({ onFiles: t, onReject: n, accept: f, multiple: p = !1, maxSize: s, maxFiles: P, hint: w, target: S = "zone", name: A, form: _, required: b, disabled: a = !1, size: I = "md", labels: R, className: j, style: U }) {
23
23
  const l = {
24
24
  ...Z,
25
25
  ...R
26
- }, T = Q(), y = N(null), f = N(0), [E, L] = C(!1), [V, Y] = C(""), [$, q] = C([]), g = (r, x) => {
26
+ }, T = Q(), y = N(null), d = N(0), [E, L] = C(!1), [V, Y] = C(""), [$, q] = C([]), g = (r, x) => {
27
27
  const i = [], c = [], D = p ? P ?? Number.POSITIVE_INFINITY : 1;
28
- for (const e of r) ee(e, d) ? s !== void 0 && e.size > s ? c.push({
28
+ for (const e of r) ee(e, f) ? s !== void 0 && e.size > s ? c.push({
29
29
  file: e,
30
30
  reason: "size"
31
31
  }) : i.length >= D ? c.push({
@@ -37,7 +37,7 @@ function ce({ onFiles: t, onReject: n, accept: d, multiple: p = !1, maxSize: s,
37
37
  });
38
38
  y.current && (x || c.length) && K(y.current, i), q(c.map(l.rejected)), Y(i.length ? l.added(i.length) : ""), i.length && t?.(i), c.length && n?.(c);
39
39
  }, u = (r) => [...r.dataTransfer?.types ?? []].includes("Files"), m = () => {
40
- f.current = 0, L(!1);
40
+ d.current = 0, L(!1);
41
41
  }, z = N(g);
42
42
  z.current = g;
43
43
  const h = S === "window", O = N(null);
@@ -45,13 +45,13 @@ function ce({ onFiles: t, onReject: n, accept: d, multiple: p = !1, maxSize: s,
45
45
  if (!h || a) return;
46
46
  const D = [
47
47
  ["dragenter", (e) => {
48
- u(e) && (e.preventDefault(), f.current += 1, L(!0));
48
+ u(e) && (e.preventDefault(), d.current += 1, L(!0));
49
49
  }],
50
50
  ["dragover", (e) => {
51
51
  !u(e) || !e.dataTransfer || (e.preventDefault(), e.dataTransfer.dropEffect = "copy");
52
52
  }],
53
53
  ["dragleave", () => {
54
- f.current -= 1, f.current <= 0 && m();
54
+ d.current -= 1, d.current <= 0 && m();
55
55
  }],
56
56
  ["drop", (e) => {
57
57
  !u(e) || !e.dataTransfer || (e.preventDefault(), m(), z.current([...e.dataTransfer.files], !0));
@@ -72,13 +72,13 @@ function ce({ onFiles: t, onReject: n, accept: d, multiple: p = !1, maxSize: s,
72
72
  "data-invalid": $.length ? "" : void 0,
73
73
  style: U,
74
74
  onDragEnter: (r) => {
75
- !v || a || !u(r) || (r.preventDefault(), f.current += 1, L(!0));
75
+ !v || a || !u(r) || (r.preventDefault(), d.current += 1, L(!0));
76
76
  },
77
77
  onDragOver: (r) => {
78
78
  !v || a || !u(r) || (r.preventDefault(), r.dataTransfer.dropEffect = "copy");
79
79
  },
80
80
  onDragLeave: () => {
81
- v && (f.current -= 1, f.current <= 0 && m());
81
+ v && (d.current -= 1, d.current <= 0 && m());
82
82
  },
83
83
  onDrop: (r) => {
84
84
  !v || a || (r.preventDefault(), m(), g([...r.dataTransfer.files], !0));
@@ -120,7 +120,7 @@ function ce({ onFiles: t, onReject: n, accept: d, multiple: p = !1, maxSize: s,
120
120
  })
121
121
  }),
122
122
  /* @__PURE__ */ o("span", {
123
- className: "cy-file-drop-status cy-reset",
123
+ className: "cy-file-drop-status cy-reset cy-visually-hidden",
124
124
  role: "status",
125
125
  children: V
126
126
  }),
@@ -140,10 +140,10 @@ function ce({ onFiles: t, onReject: n, accept: d, multiple: p = !1, maxSize: s,
140
140
  }),
141
141
  /* @__PURE__ */ o(J, {
142
142
  ref: y,
143
- className: "cy-file-drop-input",
143
+ className: "cy-file-drop-input cy-visually-hidden",
144
144
  tabIndex: -1,
145
145
  "aria-hidden": "true",
146
- accept: d,
146
+ accept: f,
147
147
  multiple: p,
148
148
  name: A,
149
149
  form: _,