@lumx/react 3.20.1-alpha.20 → 3.20.1-alpha.21

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 (697) hide show
  1. package/_internal/Falsy.d.ts +7 -0
  2. package/_internal/index.js +236 -0
  3. package/_internal/index.js.map +1 -0
  4. package/index.d.ts +352 -7
  5. package/index.js +14486 -65
  6. package/index.js.map +1 -1
  7. package/package.json +11 -4
  8. package/src/components/alert-dialog/AlertDialog.stories.tsx +127 -0
  9. package/src/components/alert-dialog/AlertDialog.test.tsx +34 -0
  10. package/src/components/alert-dialog/AlertDialog.tsx +189 -0
  11. package/src/components/alert-dialog/index.ts +1 -0
  12. package/src/components/autocomplete/Autocomplete.stories.tsx +75 -0
  13. package/src/components/autocomplete/Autocomplete.test.tsx +99 -0
  14. package/src/components/autocomplete/Autocomplete.tsx +294 -0
  15. package/src/components/autocomplete/AutocompleteMultiple.stories.tsx +167 -0
  16. package/src/components/autocomplete/AutocompleteMultiple.test.tsx +61 -0
  17. package/src/components/autocomplete/AutocompleteMultiple.tsx +156 -0
  18. package/src/components/autocomplete/__mockData__/index.ts +39 -0
  19. package/src/components/autocomplete/index.ts +2 -0
  20. package/src/components/avatar/Avatar.stories.tsx +119 -0
  21. package/src/components/avatar/Avatar.test.tsx +32 -0
  22. package/src/components/avatar/Avatar.tsx +114 -0
  23. package/src/components/avatar/index.ts +1 -0
  24. package/src/components/badge/Badge.stories.tsx +69 -0
  25. package/src/components/badge/Badge.test.tsx +45 -0
  26. package/src/components/badge/Badge.tsx +58 -0
  27. package/src/components/badge/BadgeWrapper.stories.tsx +75 -0
  28. package/src/components/badge/BadgeWrapper.test.tsx +47 -0
  29. package/src/components/badge/BadgeWrapper.tsx +37 -0
  30. package/src/components/badge/index.ts +2 -0
  31. package/src/components/button/Button.stories.tsx +355 -0
  32. package/src/components/button/Button.test.tsx +125 -0
  33. package/src/components/button/Button.tsx +101 -0
  34. package/src/components/button/ButtonGroup.stories.tsx +52 -0
  35. package/src/components/button/ButtonGroup.test.tsx +41 -0
  36. package/src/components/button/ButtonGroup.tsx +50 -0
  37. package/src/components/button/ButtonRoot.tsx +163 -0
  38. package/src/components/button/IconButton.stories.tsx +52 -0
  39. package/src/components/button/IconButton.test.tsx +66 -0
  40. package/src/components/button/IconButton.tsx +91 -0
  41. package/src/components/button/index.ts +4 -0
  42. package/src/components/checkbox/Checkbox.stories.tsx +64 -0
  43. package/src/components/checkbox/Checkbox.test.tsx +154 -0
  44. package/src/components/checkbox/Checkbox.tsx +164 -0
  45. package/src/components/checkbox/index.ts +1 -0
  46. package/src/components/chip/Chip.stories.tsx +164 -0
  47. package/src/components/chip/Chip.test.tsx +243 -0
  48. package/src/components/chip/Chip.tsx +168 -0
  49. package/src/components/chip/ChipGroup.stories.tsx +47 -0
  50. package/src/components/chip/ChipGroup.test.tsx +37 -0
  51. package/src/components/chip/ChipGroup.tsx +60 -0
  52. package/src/components/chip/index.ts +2 -0
  53. package/src/components/comment-block/CommentBlock.stories.tsx +91 -0
  54. package/src/components/comment-block/CommentBlock.test.tsx +28 -0
  55. package/src/components/comment-block/CommentBlock.tsx +172 -0
  56. package/src/components/comment-block/index.ts +1 -0
  57. package/src/components/date-picker/DatePicker.stories.tsx +118 -0
  58. package/src/components/date-picker/DatePicker.test.tsx +34 -0
  59. package/src/components/date-picker/DatePicker.tsx +52 -0
  60. package/src/components/date-picker/DatePickerControlled.test.tsx +91 -0
  61. package/src/components/date-picker/DatePickerControlled.tsx +259 -0
  62. package/src/components/date-picker/DatePickerField.stories.tsx +100 -0
  63. package/src/components/date-picker/DatePickerField.test.tsx +70 -0
  64. package/src/components/date-picker/DatePickerField.tsx +135 -0
  65. package/src/components/date-picker/constants.ts +11 -0
  66. package/src/components/date-picker/index.ts +4 -0
  67. package/src/components/date-picker/types.ts +28 -0
  68. package/src/components/dialog/Dialog.stories.tsx +318 -0
  69. package/src/components/dialog/Dialog.test.tsx +97 -0
  70. package/src/components/dialog/Dialog.tsx +288 -0
  71. package/src/components/dialog/index.ts +1 -0
  72. package/src/components/divider/Divider.test.tsx +51 -0
  73. package/src/components/divider/Divider.tsx +50 -0
  74. package/src/components/divider/index.ts +1 -0
  75. package/src/components/drag-handle/DragHandle.test.tsx +36 -0
  76. package/src/components/drag-handle/DragHandle.tsx +51 -0
  77. package/src/components/drag-handle/index.ts +1 -0
  78. package/src/components/dropdown/Dropdown.stories.tsx +31 -0
  79. package/src/components/dropdown/Dropdown.test.tsx +66 -0
  80. package/src/components/dropdown/Dropdown.tsx +186 -0
  81. package/src/components/dropdown/index.ts +1 -0
  82. package/src/components/expansion-panel/ExpansionPanel.stories.tsx +91 -0
  83. package/src/components/expansion-panel/ExpansionPanel.test.tsx +185 -0
  84. package/src/components/expansion-panel/ExpansionPanel.tsx +195 -0
  85. package/src/components/expansion-panel/index.ts +1 -0
  86. package/src/components/flag/Flag.stories.tsx +48 -0
  87. package/src/components/flag/Flag.test.tsx +62 -0
  88. package/src/components/flag/Flag.tsx +52 -0
  89. package/src/components/flag/index.ts +1 -0
  90. package/src/components/flex-box/FlexBox.stories.tsx +156 -0
  91. package/src/components/flex-box/FlexBox.test.tsx +24 -0
  92. package/src/components/flex-box/FlexBox.tsx +100 -0
  93. package/src/components/flex-box/index.ts +1 -0
  94. package/src/components/generic-block/GenericBlock.stories.jsx +128 -0
  95. package/src/components/generic-block/GenericBlock.test.tsx +156 -0
  96. package/src/components/generic-block/GenericBlock.tsx +225 -0
  97. package/src/components/generic-block/constants.ts +9 -0
  98. package/src/components/generic-block/index.ts +2 -0
  99. package/src/components/grid/Grid.tsx +83 -0
  100. package/src/components/grid/GridItem.tsx +55 -0
  101. package/src/components/grid/index.ts +2 -0
  102. package/src/components/grid-column/GridColumn.stories.tsx +45 -0
  103. package/src/components/grid-column/GridColumn.test.jsx +56 -0
  104. package/src/components/grid-column/GridColumn.tsx +83 -0
  105. package/src/components/grid-column/index.ts +1 -0
  106. package/src/components/heading/Heading.stories.tsx +69 -0
  107. package/src/components/heading/Heading.test.tsx +82 -0
  108. package/src/components/heading/Heading.tsx +65 -0
  109. package/src/components/heading/HeadingLevelProvider.tsx +30 -0
  110. package/src/components/heading/constants.ts +16 -0
  111. package/src/components/heading/context.tsx +13 -0
  112. package/src/components/heading/index.ts +3 -0
  113. package/src/components/heading/useHeadingLevel.tsx +8 -0
  114. package/src/components/icon/Icon.stories.tsx +73 -0
  115. package/src/components/icon/Icon.test.tsx +125 -0
  116. package/src/components/icon/Icon.tsx +133 -0
  117. package/src/components/icon/index.ts +1 -0
  118. package/src/components/image-block/ImageBlock.stories.tsx +117 -0
  119. package/src/components/image-block/ImageBlock.test.tsx +58 -0
  120. package/src/components/image-block/ImageBlock.tsx +142 -0
  121. package/src/components/image-block/ImageCaption.tsx +115 -0
  122. package/src/components/image-block/index.ts +1 -0
  123. package/src/components/image-lightbox/ImageLightbox.stories.tsx +160 -0
  124. package/src/components/image-lightbox/ImageLightbox.test.tsx +254 -0
  125. package/src/components/image-lightbox/ImageLightbox.tsx +90 -0
  126. package/src/components/image-lightbox/constants.ts +11 -0
  127. package/src/components/image-lightbox/index.ts +2 -0
  128. package/src/components/image-lightbox/internal/ImageSlide.tsx +107 -0
  129. package/src/components/image-lightbox/internal/ImageSlideshow.tsx +164 -0
  130. package/src/components/image-lightbox/internal/useAnimateScroll.ts +55 -0
  131. package/src/components/image-lightbox/internal/usePointerZoom.ts +148 -0
  132. package/src/components/image-lightbox/types.ts +48 -0
  133. package/src/components/image-lightbox/useImageLightbox.tsx +141 -0
  134. package/src/components/inline-list/InlineList.stories.tsx +77 -0
  135. package/src/components/inline-list/InlineList.test.tsx +52 -0
  136. package/src/components/inline-list/InlineList.tsx +96 -0
  137. package/src/components/inline-list/index.ts +1 -0
  138. package/src/components/input-helper/InputHelper.stories.tsx +35 -0
  139. package/src/components/input-helper/InputHelper.test.tsx +55 -0
  140. package/src/components/input-helper/InputHelper.tsx +65 -0
  141. package/src/components/input-helper/constants.ts +11 -0
  142. package/src/components/input-helper/index.ts +1 -0
  143. package/src/components/input-label/InputLabel.stories.tsx +45 -0
  144. package/src/components/input-label/InputLabel.test.tsx +59 -0
  145. package/src/components/input-label/InputLabel.tsx +69 -0
  146. package/src/components/input-label/index.ts +1 -0
  147. package/src/components/lightbox/Lightbox.stories.tsx +101 -0
  148. package/src/components/lightbox/Lightbox.test.tsx +53 -0
  149. package/src/components/lightbox/Lightbox.tsx +180 -0
  150. package/src/components/lightbox/index.ts +1 -0
  151. package/src/components/link/Link.stories.tsx +195 -0
  152. package/src/components/link/Link.test.tsx +127 -0
  153. package/src/components/link/Link.tsx +106 -0
  154. package/src/components/link/index.ts +1 -0
  155. package/src/components/link-preview/LinkPreview.stories.tsx +61 -0
  156. package/src/components/link-preview/LinkPreview.test.tsx +105 -0
  157. package/src/components/link-preview/LinkPreview.tsx +158 -0
  158. package/src/components/link-preview/index.ts +1 -0
  159. package/src/components/list/List.stories.tsx +116 -0
  160. package/src/components/list/List.test.tsx +18 -0
  161. package/src/components/list/List.tsx +104 -0
  162. package/src/components/list/ListDivider.stories.tsx +12 -0
  163. package/src/components/list/ListDivider.test.tsx +22 -0
  164. package/src/components/list/ListDivider.tsx +35 -0
  165. package/src/components/list/ListItem.stories.tsx +66 -0
  166. package/src/components/list/ListItem.test.tsx +93 -0
  167. package/src/components/list/ListItem.tsx +157 -0
  168. package/src/components/list/ListSubheader.stories.tsx +11 -0
  169. package/src/components/list/ListSubheader.test.tsx +21 -0
  170. package/src/components/list/ListSubheader.tsx +44 -0
  171. package/src/components/list/index.ts +4 -0
  172. package/src/components/list/useInteractiveList.tsx +202 -0
  173. package/src/components/message/Message.stories.tsx +72 -0
  174. package/src/components/message/Message.test.tsx +76 -0
  175. package/src/components/message/Message.tsx +100 -0
  176. package/src/components/message/index.ts +1 -0
  177. package/src/components/mosaic/Mosaic.stories.tsx +89 -0
  178. package/src/components/mosaic/Mosaic.test.tsx +77 -0
  179. package/src/components/mosaic/Mosaic.tsx +98 -0
  180. package/src/components/mosaic/index.ts +1 -0
  181. package/src/components/navigation/Navigation.stories.tsx +234 -0
  182. package/src/components/navigation/Navigation.test.tsx +65 -0
  183. package/src/components/navigation/Navigation.tsx +79 -0
  184. package/src/components/navigation/NavigationItem.test.tsx +35 -0
  185. package/src/components/navigation/NavigationItem.tsx +82 -0
  186. package/src/components/navigation/NavigationSection.test.tsx +137 -0
  187. package/src/components/navigation/NavigationSection.tsx +108 -0
  188. package/src/components/navigation/context.tsx +7 -0
  189. package/src/components/navigation/index.ts +1 -0
  190. package/src/components/notification/Notification.test.tsx +94 -0
  191. package/src/components/notification/Notification.tsx +138 -0
  192. package/src/components/notification/Notifications.stories.tsx +92 -0
  193. package/src/components/notification/constants.ts +28 -0
  194. package/src/components/notification/index.ts +1 -0
  195. package/src/components/popover/Popover.stories.tsx +264 -0
  196. package/src/components/popover/Popover.test.tsx +62 -0
  197. package/src/components/popover/Popover.tsx +201 -0
  198. package/src/components/popover/constants.ts +62 -0
  199. package/src/components/popover/index.ts +3 -0
  200. package/src/components/popover/usePopoverStyle.tsx +184 -0
  201. package/src/components/popover/useRestoreFocusOnClose.tsx +47 -0
  202. package/src/components/popover-dialog/PopoverDialog.stories.tsx +64 -0
  203. package/src/components/popover-dialog/PopoverDialog.test.tsx +139 -0
  204. package/src/components/popover-dialog/PopoverDialog.tsx +74 -0
  205. package/src/components/popover-dialog/index.tsx +1 -0
  206. package/src/components/post-block/PostBlock.test.tsx +27 -0
  207. package/src/components/post-block/PostBlock.tsx +122 -0
  208. package/src/components/post-block/index.ts +1 -0
  209. package/src/components/progress/Progress.tsx +68 -0
  210. package/src/components/progress/ProgressCircular.stories.tsx +43 -0
  211. package/src/components/progress/ProgressCircular.test.tsx +46 -0
  212. package/src/components/progress/ProgressCircular.tsx +82 -0
  213. package/src/components/progress/ProgressLinear.stories.tsx +12 -0
  214. package/src/components/progress/ProgressLinear.test.tsx +30 -0
  215. package/src/components/progress/ProgressLinear.tsx +50 -0
  216. package/src/components/progress/index.ts +3 -0
  217. package/src/components/progress-tracker/ProgressTracker.stories.tsx +145 -0
  218. package/src/components/progress-tracker/ProgressTracker.test.tsx +42 -0
  219. package/src/components/progress-tracker/ProgressTracker.tsx +87 -0
  220. package/src/components/progress-tracker/ProgressTrackerProvider.test.tsx +65 -0
  221. package/src/components/progress-tracker/ProgressTrackerProvider.tsx +67 -0
  222. package/src/components/progress-tracker/ProgressTrackerStep.test.tsx +36 -0
  223. package/src/components/progress-tracker/ProgressTrackerStep.tsx +159 -0
  224. package/src/components/progress-tracker/ProgressTrackerStepPanel.test.tsx +34 -0
  225. package/src/components/progress-tracker/ProgressTrackerStepPanel.tsx +67 -0
  226. package/src/components/progress-tracker/index.ts +4 -0
  227. package/src/components/radio-button/RadioButton.stories.tsx +71 -0
  228. package/src/components/radio-button/RadioButton.test.tsx +143 -0
  229. package/src/components/radio-button/RadioButton.tsx +143 -0
  230. package/src/components/radio-button/RadioGroup.stories.tsx +39 -0
  231. package/src/components/radio-button/RadioGroup.test.tsx +29 -0
  232. package/src/components/radio-button/RadioGroup.tsx +44 -0
  233. package/src/components/radio-button/index.ts +2 -0
  234. package/src/components/select/Select.stories.tsx +385 -0
  235. package/src/components/select/Select.test.tsx +199 -0
  236. package/src/components/select/Select.tsx +199 -0
  237. package/src/components/select/SelectMultiple.stories.tsx +315 -0
  238. package/src/components/select/SelectMultiple.test.tsx +213 -0
  239. package/src/components/select/SelectMultiple.tsx +206 -0
  240. package/src/components/select/WithSelectContext.tsx +147 -0
  241. package/src/components/select/constants.ts +55 -0
  242. package/src/components/select/index.ts +2 -0
  243. package/src/components/side-navigation/SideNavigation.stories.tsx +191 -0
  244. package/src/components/side-navigation/SideNavigation.test.tsx +37 -0
  245. package/src/components/side-navigation/SideNavigation.tsx +52 -0
  246. package/src/components/side-navigation/SideNavigationItem.stories.tsx +133 -0
  247. package/src/components/side-navigation/SideNavigationItem.test.tsx +136 -0
  248. package/src/components/side-navigation/SideNavigationItem.tsx +165 -0
  249. package/src/components/side-navigation/index.ts +2 -0
  250. package/src/components/skeleton/SkeletonCircle.stories.tsx +41 -0
  251. package/src/components/skeleton/SkeletonCircle.test.tsx +27 -0
  252. package/src/components/skeleton/SkeletonCircle.tsx +52 -0
  253. package/src/components/skeleton/SkeletonRectangle.stories.tsx +82 -0
  254. package/src/components/skeleton/SkeletonRectangle.test.tsx +27 -0
  255. package/src/components/skeleton/SkeletonRectangle.tsx +88 -0
  256. package/src/components/skeleton/SkeletonTypography.stories.tsx +19 -0
  257. package/src/components/skeleton/SkeletonTypography.test.tsx +27 -0
  258. package/src/components/skeleton/SkeletonTypography.tsx +59 -0
  259. package/src/components/skeleton/index.ts +3 -0
  260. package/src/components/slider/Slider.stories.tsx +45 -0
  261. package/src/components/slider/Slider.test.tsx +29 -0
  262. package/src/components/slider/Slider.tsx +299 -0
  263. package/src/components/slider/index.ts +2 -0
  264. package/src/components/slideshow/Slides.tsx +130 -0
  265. package/src/components/slideshow/Slideshow.stories.tsx +179 -0
  266. package/src/components/slideshow/Slideshow.test.tsx +35 -0
  267. package/src/components/slideshow/Slideshow.tsx +173 -0
  268. package/src/components/slideshow/SlideshowControls.stories.tsx +100 -0
  269. package/src/components/slideshow/SlideshowControls.tsx +243 -0
  270. package/src/components/slideshow/SlideshowItem.tsx +44 -0
  271. package/src/components/slideshow/SlideshowItemGroup.tsx +60 -0
  272. package/src/components/slideshow/constants.ts +24 -0
  273. package/src/components/slideshow/index.ts +4 -0
  274. package/src/components/slideshow/useKeyNavigate.ts +28 -0
  275. package/src/components/slideshow/usePaginationVisibleRange.ts +37 -0
  276. package/src/components/slideshow/useSlideFocusManagement.tsx +92 -0
  277. package/src/components/slideshow/useSwipeNavigate.ts +18 -0
  278. package/src/components/switch/Switch.stories.tsx +49 -0
  279. package/src/components/switch/Switch.test.tsx +144 -0
  280. package/src/components/switch/Switch.tsx +145 -0
  281. package/src/components/switch/index.ts +1 -0
  282. package/src/components/table/Table.test.tsx +29 -0
  283. package/src/components/table/Table.tsx +59 -0
  284. package/src/components/table/TableBody.test.tsx +30 -0
  285. package/src/components/table/TableBody.tsx +42 -0
  286. package/src/components/table/TableCell.test.tsx +72 -0
  287. package/src/components/table/TableCell.tsx +130 -0
  288. package/src/components/table/TableHeader.test.tsx +30 -0
  289. package/src/components/table/TableHeader.tsx +48 -0
  290. package/src/components/table/TableRow.test.tsx +40 -0
  291. package/src/components/table/TableRow.tsx +71 -0
  292. package/src/components/table/index.ts +5 -0
  293. package/src/components/tabs/Tab.test.tsx +50 -0
  294. package/src/components/tabs/Tab.tsx +133 -0
  295. package/src/components/tabs/TabList.test.tsx +49 -0
  296. package/src/components/tabs/TabList.tsx +94 -0
  297. package/src/components/tabs/TabPanel.test.tsx +37 -0
  298. package/src/components/tabs/TabPanel.tsx +67 -0
  299. package/src/components/tabs/TabProvider.test.tsx +161 -0
  300. package/src/components/tabs/TabProvider.tsx +67 -0
  301. package/src/components/tabs/Tabs.stories.tsx +170 -0
  302. package/src/components/tabs/index.ts +4 -0
  303. package/src/components/tabs/state.ts +114 -0
  304. package/src/components/tabs/test-utils.ts +39 -0
  305. package/src/components/text/Text.stories.tsx +177 -0
  306. package/src/components/text/Text.test.tsx +92 -0
  307. package/src/components/text/Text.tsx +139 -0
  308. package/src/components/text/index.ts +1 -0
  309. package/src/components/text-field/TextField.stories.tsx +180 -0
  310. package/src/components/text-field/TextField.test.tsx +298 -0
  311. package/src/components/text-field/TextField.tsx +493 -0
  312. package/src/components/text-field/index.ts +1 -0
  313. package/src/components/thumbnail/Thumbnail.stories.tsx +448 -0
  314. package/src/components/thumbnail/Thumbnail.test.tsx +88 -0
  315. package/src/components/thumbnail/Thumbnail.tsx +248 -0
  316. package/src/components/thumbnail/index.ts +3 -0
  317. package/src/components/thumbnail/types.ts +48 -0
  318. package/src/components/thumbnail/useFocusPointStyle.test.ts +92 -0
  319. package/src/components/thumbnail/useFocusPointStyle.tsx +107 -0
  320. package/src/components/thumbnail/useImageLoad.ts +40 -0
  321. package/src/components/toolbar/Toolbar.tsx +68 -0
  322. package/src/components/toolbar/index.ts +1 -0
  323. package/src/components/tooltip/Tooltip.stories.tsx +118 -0
  324. package/src/components/tooltip/Tooltip.test.tsx +417 -0
  325. package/src/components/tooltip/Tooltip.tsx +165 -0
  326. package/src/components/tooltip/constants.ts +8 -0
  327. package/src/components/tooltip/context.tsx +17 -0
  328. package/src/components/tooltip/index.ts +1 -0
  329. package/src/components/tooltip/useInjectTooltipRef.tsx +55 -0
  330. package/src/components/tooltip/useTooltipOpen.tsx +143 -0
  331. package/src/components/uploader/Uploader.stories.tsx +109 -0
  332. package/src/components/uploader/Uploader.test.tsx +146 -0
  333. package/src/components/uploader/Uploader.tsx +177 -0
  334. package/src/components/uploader/index.ts +1 -0
  335. package/src/components/user-block/UserBlock.stories.tsx +133 -0
  336. package/src/components/user-block/UserBlock.test.tsx +106 -0
  337. package/src/components/user-block/UserBlock.tsx +193 -0
  338. package/src/components/user-block/index.ts +1 -0
  339. package/src/constants.ts +27 -0
  340. package/src/hooks/useBooleanState.tsx +13 -0
  341. package/src/hooks/useCallbackOnEscape.ts +34 -0
  342. package/src/hooks/useChipGroupNavigation.tsx +75 -0
  343. package/src/hooks/useClickAway.tsx +48 -0
  344. package/src/hooks/useDisableBodyScroll.ts +28 -0
  345. package/src/hooks/useEventCallback.tsx +17 -0
  346. package/src/hooks/useFocus.tsx +21 -0
  347. package/src/hooks/useFocusTrap.ts +93 -0
  348. package/src/hooks/useFocusWithin.ts +33 -0
  349. package/src/hooks/useId.test.tsx +22 -0
  350. package/src/hooks/useId.ts +15 -0
  351. package/src/hooks/useImageSize.ts +17 -0
  352. package/src/hooks/useInfiniteScroll.tsx +60 -0
  353. package/src/hooks/useIntersectionObserver.tsx +43 -0
  354. package/src/hooks/useInterval.tsx +31 -0
  355. package/src/hooks/useKeyboardListNavigation.tsx +204 -0
  356. package/src/hooks/useListenFocus.tsx +26 -0
  357. package/src/hooks/useOverflowTooltipLabel.tsx +32 -0
  358. package/src/hooks/usePopper.ts +12 -0
  359. package/src/hooks/usePreviousValue.ts +12 -0
  360. package/src/hooks/useRovingTabIndex.tsx +90 -0
  361. package/src/hooks/useSizeOnWindowResize.ts +30 -0
  362. package/src/hooks/useSlideshowControls.ts +246 -0
  363. package/src/hooks/useStopPropagation.ts +21 -0
  364. package/src/hooks/useTransitionVisibility.ts +48 -0
  365. package/src/index.ts +63 -0
  366. package/src/stories/controls/color.ts +7 -0
  367. package/src/stories/controls/element.ts +6 -0
  368. package/src/stories/controls/focusPoint.ts +1 -0
  369. package/src/stories/controls/icons.ts +126 -0
  370. package/src/stories/controls/image.ts +84 -0
  371. package/src/stories/controls/selectArgType.ts +8 -0
  372. package/src/stories/controls/theme.ts +3 -0
  373. package/src/stories/controls/typography.ts +5 -0
  374. package/src/stories/controls/withUndefined.ts +1 -0
  375. package/src/stories/decorators/withChromaticForceScreenSize.tsx +7 -0
  376. package/src/stories/decorators/withCombinations.tsx +132 -0
  377. package/src/stories/decorators/withNestedProps.tsx +22 -0
  378. package/src/stories/decorators/withResizableBox.tsx +21 -0
  379. package/src/stories/decorators/withThemedBackground.tsx +16 -0
  380. package/src/stories/decorators/withValueOnChange.tsx +18 -0
  381. package/src/stories/decorators/withWrapper.tsx +19 -0
  382. package/src/stories/generated/Autocomplete/Demos.stories.tsx +7 -0
  383. package/src/stories/generated/Avatar/Demos.stories.tsx +7 -0
  384. package/src/stories/generated/Badge/Demos.stories.tsx +9 -0
  385. package/src/stories/generated/Button/Demos.stories.tsx +11 -0
  386. package/src/stories/generated/Checkbox/Demos.stories.tsx +6 -0
  387. package/src/stories/generated/Chip/Demos.stories.tsx +11 -0
  388. package/src/stories/generated/CommentBlock/Demos.stories.tsx +8 -0
  389. package/src/stories/generated/DatePicker/Demos.stories.tsx +8 -0
  390. package/src/stories/generated/Dialog/Demos.stories.tsx +10 -0
  391. package/src/stories/generated/Divider/Demos.stories.tsx +6 -0
  392. package/src/stories/generated/Dropdown/Demos.stories.tsx +8 -0
  393. package/src/stories/generated/ExpansionPanel/Demos.stories.tsx +9 -0
  394. package/src/stories/generated/Flag/Demos.stories.tsx +6 -0
  395. package/src/stories/generated/GenericBlock/Demos.stories.tsx +8 -0
  396. package/src/stories/generated/Heading/Demos.stories.tsx +6 -0
  397. package/src/stories/generated/Icon/Demos.stories.tsx +8 -0
  398. package/src/stories/generated/ImageBlock/Demos.stories.tsx +9 -0
  399. package/src/stories/generated/ImageLightbox/Demos.stories.tsx +6 -0
  400. package/src/stories/generated/Lightbox/Demos.stories.tsx +6 -0
  401. package/src/stories/generated/LinkPreview/Demos.stories.tsx +7 -0
  402. package/src/stories/generated/List/Demos.stories.tsx +11 -0
  403. package/src/stories/generated/Message/Demos.stories.tsx +11 -0
  404. package/src/stories/generated/Mosaic/Demos.stories.tsx +10 -0
  405. package/src/stories/generated/Notification/Demos.stories.tsx +6 -0
  406. package/src/stories/generated/Popover/Demos.stories.tsx +11 -0
  407. package/src/stories/generated/PopoverDialog/Demos.stories.tsx +6 -0
  408. package/src/stories/generated/PostBlock/Demos.stories.tsx +6 -0
  409. package/src/stories/generated/Progress/Demos.stories.tsx +7 -0
  410. package/src/stories/generated/ProgressTracker/Demos.stories.tsx +9 -0
  411. package/src/stories/generated/RadioButton/Demos.stories.tsx +6 -0
  412. package/src/stories/generated/Select/Demos.stories.tsx +14 -0
  413. package/src/stories/generated/SideNavigation/Demos.stories.tsx +10 -0
  414. package/src/stories/generated/Skeleton/Demos.stories.tsx +9 -0
  415. package/src/stories/generated/Slider/Demos.stories.tsx +9 -0
  416. package/src/stories/generated/Slideshow/Demos.stories.tsx +8 -0
  417. package/src/stories/generated/Switch/Demos.stories.tsx +6 -0
  418. package/src/stories/generated/Table/Demos.stories.tsx +7 -0
  419. package/src/stories/generated/Tabs/Demos.stories.tsx +8 -0
  420. package/src/stories/generated/TextField/Demos.stories.tsx +20 -0
  421. package/src/stories/generated/Thumbnail/Demos.stories.tsx +12 -0
  422. package/src/stories/generated/Toolbar/Demos.stories.tsx +10 -0
  423. package/src/stories/generated/Tooltip/Demos.stories.tsx +8 -0
  424. package/src/stories/generated/Uploader/Demos.stories.tsx +8 -0
  425. package/src/stories/generated/UserBlock/Demos.stories.tsx +11 -0
  426. package/src/stories/utils/CustomLink.tsx +12 -0
  427. package/src/stories/utils/concatPath.tsx +17 -0
  428. package/src/stories/utils/disableArgTypes.ts +3 -0
  429. package/src/stories/utils/initDemoShadowDOMPortal.ts +10 -0
  430. package/src/stories/utils/lorem.ts +59 -0
  431. package/src/stories/utils/theming.tsx +166 -0
  432. package/src/stories/utils/toFlattenProps.ts +28 -0
  433. package/src/stories/utils/withCategory.ts +12 -0
  434. package/src/testing/utils/ThemeSentinel.tsx +10 -0
  435. package/src/testing/utils/commonTestsSuiteRTL.tsx +193 -0
  436. package/src/testing/utils/index.ts +1 -0
  437. package/src/testing/utils/queries.ts +19 -0
  438. package/src/untypped-modules.d.ts +9 -0
  439. package/src/utils/ClickAwayProvider/ClickAwayProvider.stories.jsx +70 -0
  440. package/src/utils/ClickAwayProvider/ClickAwayProvider.tsx +69 -0
  441. package/src/utils/ClickAwayProvider/index.ts +1 -0
  442. package/src/utils/MaterialThemeSwitcher/MaterialThemeSwitcher.tsx +54 -0
  443. package/src/utils/MaterialThemeSwitcher/index.ts +1 -0
  444. package/src/utils/Portal/Portal.test.tsx +31 -0
  445. package/src/utils/Portal/Portal.tsx +33 -0
  446. package/src/utils/Portal/PortalProvider.stories.jsx +22 -0
  447. package/src/utils/Portal/PortalProvider.test.tsx +72 -0
  448. package/src/utils/Portal/PortalProvider.tsx +24 -0
  449. package/src/utils/Portal/index.tsx +2 -0
  450. package/src/utils/browser/DOM/findImage.tsx +3 -0
  451. package/src/utils/browser/DOM/startViewTransition.ts +68 -0
  452. package/src/utils/browser/focus/constants.ts +7 -0
  453. package/src/utils/browser/focus/getFirstAndLastFocusable.test.ts +134 -0
  454. package/src/utils/browser/focus/getFirstAndLastFocusable.ts +21 -0
  455. package/src/utils/browser/focus/getFocusableElements.test.ts +151 -0
  456. package/src/utils/browser/focus/getFocusableElements.ts +7 -0
  457. package/src/utils/browser/isFocusVisible.ts +9 -0
  458. package/src/utils/browser/isHoverNotSupported.test.js +24 -0
  459. package/src/utils/browser/isHoverNotSupported.ts +2 -0
  460. package/src/utils/browser/isReducedMotion.ts +6 -0
  461. package/src/utils/date/addMonthResetDay.test.ts +13 -0
  462. package/src/utils/date/addMonthResetDay.ts +9 -0
  463. package/src/utils/date/formatDayNumber.test.ts +12 -0
  464. package/src/utils/date/formatDayNumber.ts +5 -0
  465. package/src/utils/date/getFirstDayOfWeek.test.ts +20 -0
  466. package/src/utils/date/getFirstDayOfWeek.ts +59 -0
  467. package/src/utils/date/getMonthCalendar.test.ts +127 -0
  468. package/src/utils/date/getMonthCalendar.ts +69 -0
  469. package/src/utils/date/getWeekDays.test.ts +48 -0
  470. package/src/utils/date/getWeekDays.ts +34 -0
  471. package/src/utils/date/getYearDisplayName.test.ts +20 -0
  472. package/src/utils/date/getYearDisplayName.ts +12 -0
  473. package/src/utils/date/isDateValid.test.ts +15 -0
  474. package/src/utils/date/isDateValid.ts +4 -0
  475. package/src/utils/date/isSameDay.test.ts +37 -0
  476. package/src/utils/date/isSameDay.ts +11 -0
  477. package/src/utils/disabled/DisabledStateContext.tsx +29 -0
  478. package/src/utils/disabled/DisabledStateProvider.stories.tsx +92 -0
  479. package/src/utils/disabled/index.ts +2 -0
  480. package/src/utils/disabled/useDisableStateProps.test.tsx +74 -0
  481. package/src/utils/disabled/useDisableStateProps.tsx +37 -0
  482. package/src/utils/function/makeListenerTowerContext.ts +32 -0
  483. package/src/utils/index.ts +7 -0
  484. package/src/utils/locale/getCurrentLocale.ts +4 -0
  485. package/src/utils/locale/parseLocale.test.ts +17 -0
  486. package/src/utils/locale/parseLocale.ts +23 -0
  487. package/src/utils/locale/types.ts +8 -0
  488. package/src/utils/number/clamp.ts +17 -0
  489. package/src/utils/object/isEqual.test.ts +25 -0
  490. package/src/utils/object/isEqual.ts +11 -0
  491. package/src/utils/partitionMulti.test.ts +27 -0
  492. package/{_internal/partitionMulti-4daccdd5.js → src/utils/partitionMulti.ts} +9 -5
  493. package/src/utils/react/OnBeforeUnmount.tsx +20 -0
  494. package/src/utils/react/RawClickable.test.tsx +153 -0
  495. package/src/utils/react/RawClickable.tsx +65 -0
  496. package/src/utils/react/flattenChildren.ts +32 -0
  497. package/src/utils/react/forwardRef.ts +11 -0
  498. package/src/utils/react/forwardRefPolymorphic.ts +9 -0
  499. package/src/utils/react/mergeRefs.ts +33 -0
  500. package/src/utils/react/renderLink.tsx +17 -0
  501. package/src/utils/react/skipRender.tsx +18 -0
  502. package/src/utils/react/unref.ts +7 -0
  503. package/src/utils/react/wrapChildrenIconWithSpaces.test.tsx +37 -0
  504. package/src/utils/react/wrapChildrenIconWithSpaces.tsx +22 -0
  505. package/src/utils/theme/ThemeContext.ts +16 -0
  506. package/src/utils/theme/invertTheme.ts +4 -0
  507. package/src/utils/type/Comp.ts +14 -0
  508. package/src/utils/type/ComponentRef.ts +16 -0
  509. package/src/utils/type/HasAriaDisabled.ts +6 -0
  510. package/src/utils/type/HasPolymorphicAs.ts +6 -0
  511. package/src/utils/type/HasRequiredLinkHref.ts +1 -0
  512. package/src/utils/type/MaybeElementOrRef.ts +6 -0
  513. package/src/utils/type/index.ts +9 -0
  514. package/src/utils/type/isComponent.ts +33 -0
  515. package/src/utils/type/isComponentType.ts +9 -0
  516. package/utils/index.d.ts +1 -1
  517. package/utils/index.js +1 -3
  518. package/utils/index.js.map +1 -1
  519. package/_internal/Button-1f227024.js +0 -98
  520. package/_internal/Button-1f227024.js.map +0 -1
  521. package/_internal/ButtonRoot-823f3e9c.js +0 -117
  522. package/_internal/ButtonRoot-823f3e9c.js.map +0 -1
  523. package/_internal/Chip-a34f6905.js +0 -146
  524. package/_internal/Chip-a34f6905.js.map +0 -1
  525. package/_internal/ClickAwayProvider-7093ba23.js +0 -95
  526. package/_internal/ClickAwayProvider-7093ba23.js.map +0 -1
  527. package/_internal/DisabledStateContext-ea04260d.js +0 -29
  528. package/_internal/DisabledStateContext-ea04260d.js.map +0 -1
  529. package/_internal/HeadingLevelProvider-ebdcb0c7.js +0 -61
  530. package/_internal/HeadingLevelProvider-ebdcb0c7.js.map +0 -1
  531. package/_internal/IconButton-f4df224c.js +0 -77
  532. package/_internal/IconButton-f4df224c.js.map +0 -1
  533. package/_internal/ImageCaption-8134a3aa.js +0 -75
  534. package/_internal/ImageCaption-8134a3aa.js.map +0 -1
  535. package/_internal/List-54237e0e.js +0 -793
  536. package/_internal/List-54237e0e.js.map +0 -1
  537. package/_internal/PopoverDialog-e0967e5f.js +0 -655
  538. package/_internal/PopoverDialog-e0967e5f.js.map +0 -1
  539. package/_internal/Portal-3f86608e.js +0 -45
  540. package/_internal/Portal-3f86608e.js.map +0 -1
  541. package/_internal/RawClickable-2c2b6a89.js +0 -52
  542. package/_internal/RawClickable-2c2b6a89.js.map +0 -1
  543. package/_internal/Slides-b7a67f32.js +0 -678
  544. package/_internal/Slides-b7a67f32.js.map +0 -1
  545. package/_internal/ThemeContext-3181f000.js +0 -14
  546. package/_internal/ThemeContext-3181f000.js.map +0 -1
  547. package/_internal/Thumbnail-b5dea0af.js +0 -313
  548. package/_internal/Thumbnail-b5dea0af.js.map +0 -1
  549. package/_internal/components/alert-dialog-b284b191.js +0 -162
  550. package/_internal/components/alert-dialog-b284b191.js.map +0 -1
  551. package/_internal/components/autocomplete-8d3f37ea.js +0 -261
  552. package/_internal/components/autocomplete-8d3f37ea.js.map +0 -1
  553. package/_internal/components/avatar-5fc70e00.js +0 -83
  554. package/_internal/components/avatar-5fc70e00.js.map +0 -1
  555. package/_internal/components/badge-8390e590.js +0 -81
  556. package/_internal/components/badge-8390e590.js.map +0 -1
  557. package/_internal/components/button-e3c7f2eb.js +0 -47
  558. package/_internal/components/button-e3c7f2eb.js.map +0 -1
  559. package/_internal/components/checkbox-d1ca9748.js +0 -140
  560. package/_internal/components/checkbox-d1ca9748.js.map +0 -1
  561. package/_internal/components/chip-e40c5521.js +0 -102
  562. package/_internal/components/chip-e40c5521.js.map +0 -1
  563. package/_internal/components/comment-block-a3cf7b9b.js +0 -138
  564. package/_internal/components/comment-block-a3cf7b9b.js.map +0 -1
  565. package/_internal/components/date-picker-6c1b14e4.js +0 -2
  566. package/_internal/components/date-picker-6c1b14e4.js.map +0 -1
  567. package/_internal/components/dialog-ebdb9500.js +0 -238
  568. package/_internal/components/dialog-ebdb9500.js.map +0 -1
  569. package/_internal/components/divider-116af6b9.js +0 -50
  570. package/_internal/components/divider-116af6b9.js.map +0 -1
  571. package/_internal/components/drag-handle-5215cd21.js +0 -51
  572. package/_internal/components/drag-handle-5215cd21.js.map +0 -1
  573. package/_internal/components/dropdown-0baed51b.js +0 -147
  574. package/_internal/components/dropdown-0baed51b.js.map +0 -1
  575. package/_internal/components/expansion-panel-5533a680.js +0 -167
  576. package/_internal/components/expansion-panel-5533a680.js.map +0 -1
  577. package/_internal/components/flag-8d4a7e72.js +0 -59
  578. package/_internal/components/flag-8d4a7e72.js.map +0 -1
  579. package/_internal/components/flex-box-55144e5f.js +0 -56
  580. package/_internal/components/flex-box-55144e5f.js.map +0 -1
  581. package/_internal/components/generic-block-ff0509ee.js +0 -124
  582. package/_internal/components/generic-block-ff0509ee.js.map +0 -1
  583. package/_internal/components/grid-6f1b5a41.js +0 -104
  584. package/_internal/components/grid-6f1b5a41.js.map +0 -1
  585. package/_internal/components/grid-column-f01df853.js +0 -59
  586. package/_internal/components/grid-column-f01df853.js.map +0 -1
  587. package/_internal/components/heading-89239843.js +0 -53
  588. package/_internal/components/heading-89239843.js.map +0 -1
  589. package/_internal/components/icon-b708cca4.js +0 -102
  590. package/_internal/components/icon-b708cca4.js.map +0 -1
  591. package/_internal/components/image-block-7938422d.js +0 -110
  592. package/_internal/components/image-block-7938422d.js.map +0 -1
  593. package/_internal/components/image-lightbox-58331704.js +0 -756
  594. package/_internal/components/image-lightbox-58331704.js.map +0 -1
  595. package/_internal/components/inline-list-e6f19a98.js +0 -74
  596. package/_internal/components/inline-list-e6f19a98.js.map +0 -1
  597. package/_internal/components/input-helper-64153099.js +0 -71
  598. package/_internal/components/input-helper-64153099.js.map +0 -1
  599. package/_internal/components/input-label-2feb0bb0.js +0 -59
  600. package/_internal/components/input-label-2feb0bb0.js.map +0 -1
  601. package/_internal/components/lightbox-570ad9e5.js +0 -155
  602. package/_internal/components/lightbox-570ad9e5.js.map +0 -1
  603. package/_internal/components/link-91f76477.js +0 -72
  604. package/_internal/components/link-91f76477.js.map +0 -1
  605. package/_internal/components/link-preview-fdd8d738.js +0 -117
  606. package/_internal/components/link-preview-fdd8d738.js.map +0 -1
  607. package/_internal/components/list-b08d8423.js +0 -71
  608. package/_internal/components/list-b08d8423.js.map +0 -1
  609. package/_internal/components/message-29cb9181.js +0 -96
  610. package/_internal/components/message-29cb9181.js.map +0 -1
  611. package/_internal/components/mosaic-cdb9f563.js +0 -95
  612. package/_internal/components/mosaic-cdb9f563.js.map +0 -1
  613. package/_internal/components/navigation-8b7d9bd8.js +0 -225
  614. package/_internal/components/navigation-8b7d9bd8.js.map +0 -1
  615. package/_internal/components/notification-a45fda96.js +0 -145
  616. package/_internal/components/notification-a45fda96.js.map +0 -1
  617. package/_internal/components/popover-65bfbc57.js +0 -3
  618. package/_internal/components/popover-65bfbc57.js.map +0 -1
  619. package/_internal/components/post-block-52e58dd5.js +0 -109
  620. package/_internal/components/post-block-52e58dd5.js.map +0 -1
  621. package/_internal/components/progress-f39c3fa2.js +0 -182
  622. package/_internal/components/progress-f39c3fa2.js.map +0 -1
  623. package/_internal/components/progress-tracker-512d7a08.js +0 -305
  624. package/_internal/components/progress-tracker-512d7a08.js.map +0 -1
  625. package/_internal/components/radio-button-559a4863.js +0 -149
  626. package/_internal/components/radio-button-559a4863.js.map +0 -1
  627. package/_internal/components/select-48d4fa8c.js +0 -454
  628. package/_internal/components/select-48d4fa8c.js.map +0 -1
  629. package/_internal/components/side-navigation-f9bc5b4e.js +0 -165
  630. package/_internal/components/side-navigation-f9bc5b4e.js.map +0 -1
  631. package/_internal/components/skeleton-c66516ee.js +0 -166
  632. package/_internal/components/skeleton-c66516ee.js.map +0 -1
  633. package/_internal/components/slider-efbfbc45.js +0 -311
  634. package/_internal/components/slider-efbfbc45.js.map +0 -1
  635. package/_internal/components/slideshow-dd312470.js +0 -151
  636. package/_internal/components/slideshow-dd312470.js.map +0 -1
  637. package/_internal/components/switch-769a2a04.js +0 -122
  638. package/_internal/components/switch-769a2a04.js.map +0 -1
  639. package/_internal/components/table-8617b1ba.js +0 -294
  640. package/_internal/components/table-8617b1ba.js.map +0 -1
  641. package/_internal/components/tabs-884c57b6.js +0 -298
  642. package/_internal/components/tabs-884c57b6.js.map +0 -1
  643. package/_internal/components/text-c7b1e079.js +0 -2
  644. package/_internal/components/text-c7b1e079.js.map +0 -1
  645. package/_internal/components/text-field-478acd86.js +0 -359
  646. package/_internal/components/text-field-478acd86.js.map +0 -1
  647. package/_internal/components/thumbnail-310a4c4b.js +0 -42
  648. package/_internal/components/thumbnail-310a4c4b.js.map +0 -1
  649. package/_internal/components/toolbar-a43533a2.js +0 -61
  650. package/_internal/components/toolbar-a43533a2.js.map +0 -1
  651. package/_internal/components/tooltip-2885ab2e.js +0 -327
  652. package/_internal/components/tooltip-2885ab2e.js.map +0 -1
  653. package/_internal/components/uploader-1e7f5bbb.js +0 -153
  654. package/_internal/components/uploader-1e7f5bbb.js.map +0 -1
  655. package/_internal/components/user-block-68a51ed0.js +0 -145
  656. package/_internal/components/user-block-68a51ed0.js.map +0 -1
  657. package/_internal/constants-b9e57936.js +0 -2155
  658. package/_internal/constants-b9e57936.js.map +0 -1
  659. package/_internal/constants-d0e3f49e.js +0 -24
  660. package/_internal/constants-d0e3f49e.js.map +0 -1
  661. package/_internal/context-9d1336a1.js +0 -19
  662. package/_internal/context-9d1336a1.js.map +0 -1
  663. package/_internal/forwardRef-15f62847.js +0 -70
  664. package/_internal/forwardRef-15f62847.js.map +0 -1
  665. package/_internal/getFocusableElements-230173a8.js +0 -13
  666. package/_internal/getFocusableElements-230173a8.js.map +0 -1
  667. package/_internal/index-9df37c0d.js +0 -436
  668. package/_internal/index-9df37c0d.js.map +0 -1
  669. package/_internal/index-a9c5cd69.js +0 -117
  670. package/_internal/index-a9c5cd69.js.map +0 -1
  671. package/_internal/isComponent-78df9309.js +0 -20
  672. package/_internal/isComponent-78df9309.js.map +0 -1
  673. package/_internal/isComponentType-e806b848.js +0 -9
  674. package/_internal/isComponentType-e806b848.js.map +0 -1
  675. package/_internal/mergeRefs-f0d7d6ea.js +0 -30
  676. package/_internal/mergeRefs-f0d7d6ea.js.map +0 -1
  677. package/_internal/partitionMulti-4daccdd5.js.map +0 -1
  678. package/_internal/state-db358714.js +0 -130
  679. package/_internal/state-db358714.js.map +0 -1
  680. package/_internal/useBooleanState-2a3d237c.js +0 -12
  681. package/_internal/useBooleanState-2a3d237c.js.map +0 -1
  682. package/_internal/useCallbackOnEscape-ea4d9eb4.js +0 -62
  683. package/_internal/useCallbackOnEscape-ea4d9eb4.js.map +0 -1
  684. package/_internal/useDisableBodyScroll-36bd7352.js +0 -219
  685. package/_internal/useDisableBodyScroll-36bd7352.js.map +0 -1
  686. package/_internal/useDisableStateProps-69e16b7c.js +0 -36
  687. package/_internal/useDisableStateProps-69e16b7c.js.map +0 -1
  688. package/_internal/useFocusTrap-c3c6378b.js +0 -112
  689. package/_internal/useFocusTrap-c3c6378b.js.map +0 -1
  690. package/_internal/useId-3a1facc0.js +0 -18
  691. package/_internal/useId-3a1facc0.js.map +0 -1
  692. package/_internal/useRovingTabIndex-7daf0f24.js +0 -77
  693. package/_internal/useRovingTabIndex-7daf0f24.js.map +0 -1
  694. package/_internal/useTransitionVisibility-321fdbfa.js +0 -50
  695. package/_internal/useTransitionVisibility-321fdbfa.js.map +0 -1
  696. package/_internal/wrapChildrenIconWithSpaces-c1faaae4.js +0 -20
  697. package/_internal/wrapChildrenIconWithSpaces-c1faaae4.js.map +0 -1
@@ -0,0 +1,160 @@
1
+ import { IMAGES } from '@lumx/react/stories/controls/image';
2
+ import { Button, Mosaic, ImageLightbox, ImageLightboxProps, Chip, ChipGroup } from '@lumx/react';
3
+ import { withWrapper } from '@lumx/react/stories/decorators/withWrapper';
4
+
5
+ const ZOOM_PROPS = {
6
+ zoomInButtonProps: { label: 'Zoom in' },
7
+ zoomOutButtonProps: { label: 'Zoom out' },
8
+ };
9
+
10
+ const SLIDESHOW_PROPS = {
11
+ slideshowControlsProps: {
12
+ nextButtonProps: { label: 'Next' },
13
+ previousButtonProps: { label: 'Previous' },
14
+ paginationItemProps: (index: number) => ({ label: `Go to slide ${index + 1}` }),
15
+ },
16
+ };
17
+
18
+ const MULTIPLE_IMAGES: ImageLightboxProps['images'] = [
19
+ {
20
+ image: 'https://picsum.photos/id/237/2000/3000',
21
+ alt: 'Image 1',
22
+ title: 'Little puppy',
23
+ description: 'A black labrador puppy with big brown eyes, looking up with a curious and innocent expression.',
24
+ tags: (
25
+ <ChipGroup>
26
+ <Chip size="s">Tag 1</Chip>
27
+ <Chip size="s">Tag 2</Chip>
28
+ </ChipGroup>
29
+ ),
30
+ },
31
+ {
32
+ image: 'https://picsum.photos/id/337/3000/1000',
33
+ alt: 'Image 2',
34
+ // Intentionally using the wrong size to see how it renders while loading the image
35
+ imgProps: { width: '300px', height: '100px' },
36
+ },
37
+ {
38
+ image: 'https://picsum.photos/id/437/2000/2000',
39
+ alt: 'Image 3',
40
+ },
41
+ {
42
+ image: 'https://picsum.photos/id/537/300/400',
43
+ alt: 'Image 4',
44
+ },
45
+ {
46
+ image: 'https://picsum.photos/id/637/400/200',
47
+ alt: 'Image 5',
48
+ },
49
+ {
50
+ image: 'https://picsum.photos/id/737/300/300',
51
+ alt: 'Image 6',
52
+ },
53
+ ];
54
+
55
+ export default {
56
+ title: 'LumX components/image-lightbox/ImageLightbox',
57
+ component: ImageLightbox,
58
+ args: {
59
+ closeButtonProps: { label: 'Close' },
60
+ },
61
+ argTypes: {
62
+ onClose: { action: true },
63
+ },
64
+ };
65
+
66
+ /**
67
+ * Display a single image fullscreen in the ImageLightbox
68
+ */
69
+ export const SingleImage = {
70
+ args: {
71
+ images: [{ image: IMAGES.portrait1s200, alt: 'Image 1' }],
72
+ isOpen: true,
73
+ },
74
+ };
75
+
76
+ /**
77
+ * Display a single image fullscreen in the ImageLightbox with zoom controls
78
+ */
79
+ export const SingleImageWithZoom = {
80
+ ...SingleImage,
81
+ args: { ...SingleImage.args, ...ZOOM_PROPS },
82
+ };
83
+
84
+ /**
85
+ * Display a single image fullscreen in the ImageLightbox with metadata (title, description, etc.)
86
+ */
87
+ export const SingleImageWithMetadata = {
88
+ ...SingleImage,
89
+ args: { ...SingleImage.args, images: [MULTIPLE_IMAGES[0]] },
90
+ };
91
+
92
+ /**
93
+ * Display a multiple image fullscreen in the ImageLightbox
94
+ */
95
+ export const MultipleImages = {
96
+ args: {
97
+ images: MULTIPLE_IMAGES,
98
+ isOpen: true,
99
+ ...SLIDESHOW_PROPS,
100
+ },
101
+ };
102
+
103
+ /**
104
+ * Display a multiple images fullscreen in the ImageLightbox with zoom controls
105
+ */
106
+ export const MultipleImagesWithZoom = {
107
+ ...MultipleImages,
108
+ args: { ...MultipleImages.args, ...ZOOM_PROPS },
109
+ };
110
+
111
+ /**
112
+ * Open ImageLightbox via buttons
113
+ */
114
+ export const WithButtonTrigger = {
115
+ decorators: [
116
+ (Story: any, { args }: any) => {
117
+ const { getTriggerProps, imageLightboxProps } = ImageLightbox.useImageLightbox({
118
+ images: [
119
+ { image: IMAGES.portrait1s200, alt: 'Image 1' },
120
+ { image: IMAGES.landscape1s200, alt: 'Image 2' },
121
+ ],
122
+ });
123
+ return (
124
+ <>
125
+ <Story args={{ ...args, ...imageLightboxProps }} />
126
+ <Button {...(getTriggerProps({ activeImageIndex: 0 }) as any)}>Image 1</Button>
127
+ <Button {...(getTriggerProps({ activeImageIndex: 1 }) as any)}>Image 2</Button>
128
+ </>
129
+ );
130
+ },
131
+ ],
132
+ // Disables Chromatic snapshot (not relevant for this story).
133
+ parameters: { chromatic: { disable: true } },
134
+ };
135
+
136
+ /**
137
+ * Open ImageLightbox with zoom and slideshow via clickable thumbnails in a Mosaic
138
+ */
139
+ export const WithMosaicTrigger = {
140
+ args: { ...SLIDESHOW_PROPS, ...ZOOM_PROPS },
141
+ decorators: [
142
+ (Story: any, { args }: any) => {
143
+ const { getTriggerProps, imageLightboxProps } = ImageLightbox.useImageLightbox({ images: MULTIPLE_IMAGES });
144
+ return (
145
+ <>
146
+ <Story args={{ ...args, ...imageLightboxProps }} />
147
+ <Mosaic
148
+ thumbnails={MULTIPLE_IMAGES.map((image, index) => ({
149
+ ...image,
150
+ ...getTriggerProps({ activeImageIndex: index }),
151
+ }))}
152
+ />
153
+ </>
154
+ );
155
+ },
156
+ withWrapper({ style: { width: 300 } }),
157
+ ],
158
+ // Disables Chromatic snapshot (not relevant for this story).
159
+ parameters: { chromatic: { disable: true } },
160
+ };
@@ -0,0 +1,254 @@
1
+ import { commonTestsSuiteRTL } from '@lumx/react/testing/utils';
2
+ import { render, within, screen, waitFor } from '@testing-library/react';
3
+ import { getByClassName, queryByClassName } from '@lumx/react/testing/utils/queries';
4
+ import userEvent from '@testing-library/user-event';
5
+ import { useImageSize } from '@lumx/react/hooks/useImageSize';
6
+ import { useSizeOnWindowResize } from '@lumx/react/hooks/useSizeOnWindowResize';
7
+
8
+ import { ImageLightbox } from './ImageLightbox';
9
+ import { ImageLightboxProps } from './types';
10
+ import Meta, {
11
+ MultipleImages,
12
+ MultipleImagesWithZoom,
13
+ SingleImage,
14
+ SingleImageWithZoom,
15
+ WithButtonTrigger,
16
+ WithMosaicTrigger,
17
+ } from './ImageLightbox.stories';
18
+
19
+ vi.mock('@lumx/react/hooks/useImageSize');
20
+ vi.mock('@lumx/react/hooks/useSizeOnWindowResize');
21
+
22
+ const CLASSNAME = ImageLightbox.className as string;
23
+ const baseProps = Meta.args;
24
+
25
+ const setup = (overrides: Partial<ImageLightboxProps> = {}) => {
26
+ const props: any = {
27
+ ...baseProps,
28
+ isOpen: true,
29
+ images: [],
30
+ ...overrides,
31
+ };
32
+ const result = render(<ImageLightbox {...props} />);
33
+ const rerender = () => result.rerender(<ImageLightbox {...props} />);
34
+ const imageLightbox = queryByClassName(document.body, CLASSNAME);
35
+ return { props, imageLightbox, rerender };
36
+ };
37
+
38
+ const queries = {
39
+ getImageLightbox: () => getByClassName(document.body, CLASSNAME),
40
+ queryCloseButton: (imageLightbox: HTMLElement) => within(imageLightbox).queryByRole('button', { name: 'Close' }),
41
+ queryImage: (imageLightbox: HTMLElement, name?: string) => within(imageLightbox).queryByRole('img', { name }),
42
+ queryScrollArea: (imageLightbox: HTMLElement) =>
43
+ queryByClassName(imageLightbox, 'lumx-image-lightbox__image-slide'),
44
+ queryZoomInButton: (imageLightbox: HTMLElement) => within(imageLightbox).queryByRole('button', { name: 'Zoom in' }),
45
+ queryZoomOutButton: (imageLightbox: HTMLElement) =>
46
+ within(imageLightbox).queryByRole('button', { name: 'Zoom out' }),
47
+ queryPrevSlideButton: (imageLightbox: HTMLElement) =>
48
+ within(imageLightbox).queryByRole('button', { name: 'Previous' }),
49
+ queryNextSlideButton: (imageLightbox: HTMLElement) => within(imageLightbox).queryByRole('button', { name: 'Next' }),
50
+ querySlideButton: (imageLightbox: HTMLElement, slide: number) =>
51
+ within(imageLightbox).queryByRole('tab', { name: `Go to slide ${slide}` }),
52
+ };
53
+
54
+ describe(`<${ImageLightbox.displayName}>`, () => {
55
+ beforeEach(() => {
56
+ (useImageSize as any).mockReturnValue(null);
57
+ (useSizeOnWindowResize as any).mockReturnValue([null, vi.fn()]);
58
+ });
59
+
60
+ describe('render', () => {
61
+ it('should render single image', () => {
62
+ setup(SingleImage.args);
63
+ const imageLightbox = queries.getImageLightbox();
64
+
65
+ // Should render
66
+ expect(queries.queryCloseButton(imageLightbox)).toBeInTheDocument();
67
+ expect(queries.queryImage(imageLightbox, 'Image 1')).toBeInTheDocument();
68
+
69
+ // Should not render
70
+ expect(queries.queryZoomInButton(imageLightbox)).not.toBeInTheDocument();
71
+ expect(queries.queryZoomOutButton(imageLightbox)).not.toBeInTheDocument();
72
+ expect(queries.queryPrevSlideButton(imageLightbox)).not.toBeInTheDocument();
73
+ expect(queries.queryNextSlideButton(imageLightbox)).not.toBeInTheDocument();
74
+ });
75
+
76
+ it('should render single image with zoom', () => {
77
+ setup(SingleImageWithZoom.args);
78
+ const imageLightbox = queries.getImageLightbox();
79
+
80
+ // Should render
81
+ expect(queries.queryCloseButton(imageLightbox)).toBeInTheDocument();
82
+ expect(queries.queryImage(imageLightbox, 'Image 1')).toBeInTheDocument();
83
+ expect(queries.queryZoomInButton(imageLightbox)).toBeInTheDocument();
84
+ expect(queries.queryZoomOutButton(imageLightbox)).toBeInTheDocument();
85
+
86
+ // Should not render
87
+ expect(queries.queryPrevSlideButton(imageLightbox)).not.toBeInTheDocument();
88
+ expect(queries.queryNextSlideButton(imageLightbox)).not.toBeInTheDocument();
89
+ });
90
+
91
+ it('should render multiple images', () => {
92
+ setup(MultipleImages.args);
93
+ const imageLightbox = queries.getImageLightbox();
94
+
95
+ // Should render
96
+ expect(queries.queryCloseButton(imageLightbox)).toBeInTheDocument();
97
+ expect(queries.queryImage(imageLightbox, 'Image 1')).toBeInTheDocument();
98
+ expect(queries.queryPrevSlideButton(imageLightbox)).toBeInTheDocument();
99
+ expect(queries.queryNextSlideButton(imageLightbox)).toBeInTheDocument();
100
+
101
+ // Should not render
102
+ expect(queries.queryZoomInButton(imageLightbox)).not.toBeInTheDocument();
103
+ expect(queries.queryZoomOutButton(imageLightbox)).not.toBeInTheDocument();
104
+ });
105
+
106
+ it('should render multiple images with set active image', () => {
107
+ setup({ ...MultipleImages.args, activeImageIndex: 1 });
108
+ const imageLightbox = queries.getImageLightbox();
109
+
110
+ // Should render
111
+ expect(queries.queryImage(imageLightbox, 'Image 2')).toBeInTheDocument();
112
+ });
113
+
114
+ it('should render multiple images with zoom', () => {
115
+ setup(MultipleImagesWithZoom.args);
116
+ const imageLightbox = queries.getImageLightbox();
117
+
118
+ // Should render
119
+ expect(queries.queryCloseButton(imageLightbox)).toBeInTheDocument();
120
+ expect(queries.queryImage(imageLightbox, 'Image 1')).toBeInTheDocument();
121
+ expect(queries.queryPrevSlideButton(imageLightbox)).toBeInTheDocument();
122
+ expect(queries.queryNextSlideButton(imageLightbox)).toBeInTheDocument();
123
+ expect(queries.queryZoomInButton(imageLightbox)).toBeInTheDocument();
124
+ expect(queries.queryZoomOutButton(imageLightbox)).toBeInTheDocument();
125
+ });
126
+ });
127
+
128
+ describe('trigger', () => {
129
+ it('should move focus on open and close with single image lightbox', async () => {
130
+ const decorator = WithButtonTrigger.decorators[0];
131
+ const Story = ({ args }: any) => <ImageLightbox {...args} />;
132
+ const Render = () => decorator(Story, { args: baseProps });
133
+ render(<Render />);
134
+
135
+ // Focus the second button
136
+ await userEvent.tab();
137
+ await userEvent.tab();
138
+ const buttonTrigger = screen.getByRole('button', { name: 'Image 2' });
139
+ expect(buttonTrigger).toHaveFocus();
140
+
141
+ // Open image lightbox with the button trigger
142
+ await userEvent.keyboard('{enter}');
143
+
144
+ // Focus moved to the close button
145
+ const imageLightbox = queries.getImageLightbox();
146
+ const closeButton = queries.queryCloseButton(imageLightbox);
147
+ expect(closeButton).toHaveFocus();
148
+ const tooltip = screen.getByRole('tooltip', { name: 'Close' });
149
+ expect(tooltip).toBeInTheDocument();
150
+
151
+ // Image lightbox opened on the correct image
152
+ expect(queries.queryImage(imageLightbox, 'Image 2')).toBeInTheDocument();
153
+
154
+ // Close tooltip
155
+ await userEvent.keyboard('{escape}');
156
+ expect(tooltip).not.toBeInTheDocument();
157
+
158
+ // Close on escape
159
+ await userEvent.keyboard('{escape}');
160
+ await waitFor(() => {
161
+ expect(imageLightbox).not.toBeInTheDocument();
162
+ });
163
+
164
+ // Focus moved back to the trigger button
165
+ expect(buttonTrigger).toHaveFocus();
166
+ });
167
+
168
+ it('should move focus on open and close with multiple image lightbox', async () => {
169
+ const decorator = WithMosaicTrigger.decorators[0];
170
+ const Story = ({ args }: any) => <ImageLightbox {...args} />;
171
+ const Render = () => decorator(Story, { args: { ...baseProps, ...WithMosaicTrigger.args } });
172
+ render(<Render />);
173
+
174
+ // Focus the first button & activate to open
175
+ await userEvent.tab();
176
+ const buttonTrigger = document.activeElement;
177
+ await userEvent.keyboard('{enter}');
178
+
179
+ // Focus moved to the first slide button
180
+ const imageLightbox = queries.getImageLightbox();
181
+ expect(queries.querySlideButton(imageLightbox, 1)).toHaveFocus();
182
+
183
+ // Image lightbox opened on the correct image
184
+ expect(queries.queryImage(imageLightbox, 'Image 1')).toBeInTheDocument();
185
+
186
+ // Close on escape
187
+ await userEvent.keyboard('{escape}');
188
+ await waitFor(() => {
189
+ expect(imageLightbox).not.toBeInTheDocument();
190
+ });
191
+
192
+ // Focus moved back to the trigger button
193
+ expect(buttonTrigger).toHaveFocus();
194
+ });
195
+ });
196
+
197
+ describe('zoom', () => {
198
+ const scrollAreaSize = { width: 600, height: 600 };
199
+ beforeEach(() => {
200
+ (useImageSize as any).mockImplementation((_: any, getInitialSize: any) => getInitialSize?.() || null);
201
+ (useSizeOnWindowResize as any).mockReturnValue([scrollAreaSize, vi.fn()]);
202
+ });
203
+
204
+ it('should use the image initial size', () => {
205
+ setup({
206
+ images: [
207
+ { image: 'https://example.com/image.png', alt: 'Image 1', imgProps: { width: 200, height: 200 } },
208
+ ],
209
+ });
210
+ const imageLightbox = queries.getImageLightbox();
211
+ const image = queries.queryImage(imageLightbox, 'Image 1');
212
+ expect(image).toHaveStyle({
213
+ height: `200px`,
214
+ width: `200px`,
215
+ });
216
+ });
217
+
218
+ it('should zoom on zoom button pressed', async () => {
219
+ // Set image size (simulate image loaded)
220
+ const imageSize = { width: 500, height: 300 };
221
+ (useImageSize as any).mockReturnValue(imageSize);
222
+
223
+ setup(SingleImageWithZoom.args);
224
+ const imageLightbox = queries.getImageLightbox();
225
+
226
+ // Image style
227
+ const image = queries.queryImage(imageLightbox, 'Image 1');
228
+ expect(image).toHaveStyle({ width: `${imageSize.width}px`, height: `${imageSize.height}px` });
229
+
230
+ // Scroll area is bigger than the image, it should not be focusable
231
+ expect(queries.queryScrollArea(imageLightbox)).not.toHaveAttribute('tabindex');
232
+
233
+ // Zoom in
234
+ const zoomInButton = queries.queryZoomInButton(imageLightbox) as any;
235
+ await userEvent.click(zoomInButton);
236
+ expect(image).toHaveStyle({ height: '450px', width: '750px' });
237
+
238
+ // Scroll area is smaller than the image, it should be focusable
239
+ expect(queries.queryScrollArea(imageLightbox)).toHaveAttribute('tabindex', '0');
240
+
241
+ // Zoom out
242
+ const zoomOutButton = queries.queryZoomOutButton(imageLightbox) as any;
243
+ await userEvent.click(zoomOutButton);
244
+ expect(image).toHaveStyle({ width: `${imageSize.width}px`, height: `${imageSize.height}px` });
245
+ });
246
+ });
247
+
248
+ // Common tests suite.
249
+ commonTestsSuiteRTL(setup, {
250
+ baseClassName: CLASSNAME,
251
+ forwardClassName: 'imageLightbox',
252
+ forwardAttributes: 'imageLightbox',
253
+ });
254
+ });
@@ -0,0 +1,90 @@
1
+ import React from 'react';
2
+
3
+ import classNames from 'classnames';
4
+
5
+ import { Lightbox, ThemeProvider } from '@lumx/react';
6
+ import { ClickAwayProvider } from '@lumx/react/utils';
7
+ import { useMergeRefs } from '@lumx/react/utils/react/mergeRefs';
8
+ import { forwardRef } from '@lumx/react/utils/react/forwardRef';
9
+
10
+ import { ImageSlideshow } from './internal/ImageSlideshow';
11
+ import { useImageLightbox } from './useImageLightbox';
12
+ import type { ImageLightboxProps } from './types';
13
+ import { CLASSNAME, COMPONENT_NAME } from './constants';
14
+
15
+ const Inner = forwardRef<ImageLightboxProps, HTMLDivElement>((props, ref) => {
16
+ const {
17
+ className,
18
+ isOpen,
19
+ closeButtonProps,
20
+ onClose,
21
+ parentElement,
22
+ activeImageIndex,
23
+ slideshowControlsProps,
24
+ slideGroupLabel,
25
+ images,
26
+ zoomOutButtonProps,
27
+ zoomInButtonProps,
28
+ activeImageRef: propImageRef,
29
+ ...forwardedProps
30
+ } = props;
31
+ const currentPaginationItemRef = React.useRef(null);
32
+ const footerRef = React.useRef(null);
33
+ const imageRef = React.useRef(null);
34
+ const clickAwayChildrenRefs = React.useRef([imageRef, footerRef]);
35
+
36
+ const onClickAway = React.useCallback(
37
+ (evt: Event) => {
38
+ const targetElement = evt.target;
39
+ if (!(targetElement instanceof HTMLElement) || !(evt instanceof MouseEvent)) return;
40
+
41
+ // Skip click away if clicking on the scrollbar
42
+ if (targetElement.clientWidth < evt.clientX || targetElement.clientHeight < evt.clientY) return;
43
+
44
+ onClose?.();
45
+ },
46
+ [onClose],
47
+ );
48
+
49
+ return (
50
+ <Lightbox
51
+ ref={ref}
52
+ className={classNames(className, CLASSNAME)}
53
+ parentElement={parentElement}
54
+ isOpen={isOpen}
55
+ onClose={onClose}
56
+ closeButtonProps={closeButtonProps}
57
+ focusElement={currentPaginationItemRef}
58
+ {...forwardedProps}
59
+ // Disable the close on click away as we want a custom one here
60
+ preventAutoClose
61
+ >
62
+ <ClickAwayProvider childrenRefs={clickAwayChildrenRefs} callback={onClickAway}>
63
+ <ThemeProvider value="dark">
64
+ <ImageSlideshow
65
+ activeImageIndex={activeImageIndex}
66
+ slideGroupLabel={slideGroupLabel}
67
+ slideshowControlsProps={slideshowControlsProps}
68
+ images={images}
69
+ zoomInButtonProps={zoomInButtonProps}
70
+ zoomOutButtonProps={zoomOutButtonProps}
71
+ footerRef={footerRef}
72
+ activeImageRef={useMergeRefs(propImageRef, imageRef)}
73
+ currentPaginationItemRef={currentPaginationItemRef}
74
+ />
75
+ </ThemeProvider>
76
+ </ClickAwayProvider>
77
+ </Lightbox>
78
+ );
79
+ });
80
+ Inner.displayName = COMPONENT_NAME;
81
+ Inner.className = CLASSNAME;
82
+
83
+ /**
84
+ * ImageLightbox component.
85
+ *
86
+ * @param props Component props.
87
+ * @param ref Component ref.
88
+ * @return React element.
89
+ */
90
+ export const ImageLightbox = Object.assign(Inner, { useImageLightbox });
@@ -0,0 +1,11 @@
1
+ import { getRootClassName } from '@lumx/core/js/utils/className';
2
+
3
+ /**
4
+ * Component display name.
5
+ */
6
+ export const COMPONENT_NAME = 'ImageLightbox';
7
+
8
+ /**
9
+ * Component default class name and class prefix.
10
+ */
11
+ export const CLASSNAME = getRootClassName(COMPONENT_NAME);
@@ -0,0 +1,2 @@
1
+ export { ImageLightbox } from './ImageLightbox';
2
+ export type { ImageLightboxProps } from './types';
@@ -0,0 +1,107 @@
1
+ import React from 'react';
2
+
3
+ import { SlideshowItem, Thumbnail } from '@lumx/react';
4
+ import { useMergeRefs } from '@lumx/react/utils/react/mergeRefs';
5
+ import { useSizeOnWindowResize } from '@lumx/react/hooks/useSizeOnWindowResize';
6
+ import { useImageSize } from '@lumx/react/hooks/useImageSize';
7
+ import { isReducedMotion } from '@lumx/react/utils/browser/isReducedMotion';
8
+ import { isEqual } from '@lumx/react/utils/object/isEqual';
9
+
10
+ import { CLASSNAME } from '../constants';
11
+ import { usePointerZoom } from './usePointerZoom';
12
+ import { useAnimateScroll } from './useAnimateScroll';
13
+ import type { ImageProps } from '../types';
14
+
15
+ export interface ImageSlideProps {
16
+ image: ImageProps;
17
+ isActive?: boolean;
18
+ scale?: number;
19
+ onScaleChange?: (value: number) => void;
20
+ }
21
+
22
+ /** Internal image slide component for ImageLightbox */
23
+ export const ImageSlide = React.memo((props: ImageSlideProps) => {
24
+ const {
25
+ isActive,
26
+ scale,
27
+ onScaleChange,
28
+ image: { image, imgRef: propImgRef, imgProps, alt, loadingPlaceholderImageRef },
29
+ } = props;
30
+
31
+ // Get scroll area size
32
+ const scrollAreaRef = React.useRef<HTMLDivElement>(null);
33
+ const [scrollAreaSize, updateSize] = useSizeOnWindowResize(scrollAreaRef);
34
+ React.useEffect(() => {
35
+ // Update size when active
36
+ if (isActive) updateSize();
37
+ }, [isActive, updateSize]);
38
+
39
+ // Get image size
40
+ const imgRef = React.useRef<HTMLImageElement>(null);
41
+ const imageSize = useImageSize(imgRef, () => {
42
+ const width = Number.parseInt(imgProps?.width as any, 10);
43
+ const height = Number.parseInt(imgProps?.height as any, 10);
44
+ return width && height ? { width, height } : null;
45
+ });
46
+
47
+ // Calculate new image size with scale
48
+ const scaledImageSize = React.useMemo(() => {
49
+ if (!scrollAreaSize || !imageSize) {
50
+ return null;
51
+ }
52
+ const horizontalScale = scrollAreaSize.width / imageSize.width;
53
+ const verticalScale = scrollAreaSize.height / imageSize.height;
54
+ const baseScale = Math.min(1, Math.min(horizontalScale, verticalScale));
55
+ return {
56
+ width: imageSize.width * baseScale * (scale ?? 1),
57
+ height: imageSize.height * baseScale * (scale ?? 1),
58
+ };
59
+ }, [scrollAreaSize, imageSize, scale]);
60
+
61
+ // Animate scroll to preserve the center of the current visible window in the scroll area
62
+ const animateScroll = useAnimateScroll(scrollAreaRef);
63
+
64
+ // Zoom via mouse wheel or multi-touch pinch zoom
65
+ const isPointerZooming = usePointerZoom(scrollAreaRef, onScaleChange, animateScroll);
66
+
67
+ // Animate scroll on scale change
68
+ React.useLayoutEffect(() => {
69
+ if (scale && !isPointerZooming) {
70
+ animateScroll();
71
+ }
72
+ }, [isPointerZooming, scale, animateScroll]);
73
+
74
+ const isScrollable =
75
+ scaledImageSize &&
76
+ scrollAreaSize &&
77
+ (scaledImageSize.width > scrollAreaSize.width || scaledImageSize.height > scrollAreaSize.height);
78
+
79
+ return (
80
+ <SlideshowItem
81
+ ref={scrollAreaRef}
82
+ // Make it accessible to keyboard nav when the zone is scrollable
83
+ tabIndex={isScrollable ? 0 : undefined}
84
+ className={`${CLASSNAME}__image-slide`}
85
+ >
86
+ <Thumbnail
87
+ imgRef={useMergeRefs(imgRef, propImgRef)}
88
+ image={image}
89
+ alt={alt}
90
+ className={`${CLASSNAME}__thumbnail`}
91
+ imgProps={{
92
+ ...imgProps,
93
+ style: {
94
+ ...imgProps?.style,
95
+ ...(scaledImageSize || {
96
+ maxHeight: scrollAreaSize?.height,
97
+ maxWidth: scrollAreaSize?.width,
98
+ }),
99
+ // Only animate when scale is set, and we are not pointer zooming and the user does not prefer reduced motion
100
+ transition: scale && !isPointerZooming && !isReducedMotion() ? 'all 250ms' : undefined,
101
+ },
102
+ }}
103
+ loadingPlaceholderImageRef={loadingPlaceholderImageRef}
104
+ />
105
+ </SlideshowItem>
106
+ );
107
+ }, isEqual);