@primer/react 0.0.0-20260428150519 → 0.0.0-20260428191209

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 (362) hide show
  1. package/CHANGELOG.md +5 -1
  2. package/dist/ActionBar/ActionBar.js +705 -502
  3. package/dist/ActionBar/ActionBar.module.css.js +5 -10
  4. package/dist/ActionBar/index.js +8 -8
  5. package/dist/ActionList/{ActionList-53389912.css → ActionList-09f5c4a8.css} +2 -2
  6. package/dist/ActionList/ActionList-09f5c4a8.css.map +1 -0
  7. package/dist/ActionList/ActionList.module.css.js +5 -31
  8. package/dist/ActionList/ActionListContainerContext.js +5 -4
  9. package/dist/ActionList/Description.js +133 -117
  10. package/dist/ActionList/Divider.js +38 -31
  11. package/dist/ActionList/Group.js +349 -292
  12. package/dist/ActionList/Group.module.css.js +5 -10
  13. package/dist/ActionList/Heading.js +106 -88
  14. package/dist/ActionList/Heading.module.css.js +5 -5
  15. package/dist/ActionList/Item.js +811 -668
  16. package/dist/ActionList/LinkItem.js +56 -36
  17. package/dist/ActionList/List.js +210 -168
  18. package/dist/ActionList/Selection.d.ts +2 -3
  19. package/dist/ActionList/Selection.d.ts.map +1 -1
  20. package/dist/ActionList/Selection.js +112 -83
  21. package/dist/ActionList/TrailingAction.js +112 -97
  22. package/dist/ActionList/Visuals.js +191 -143
  23. package/dist/ActionList/index.d.ts +7 -0
  24. package/dist/ActionList/index.d.ts.map +1 -1
  25. package/dist/ActionList/index.js +38 -33
  26. package/dist/ActionList/shared.js +9 -5
  27. package/dist/ActionMenu/ActionMenu.js +310 -223
  28. package/dist/ActionMenu/ActionMenu.module.css.js +5 -5
  29. package/dist/AnchoredOverlay/AnchoredOverlay.js +280 -206
  30. package/dist/AnchoredOverlay/AnchoredOverlay.module.css.js +5 -9
  31. package/dist/Autocomplete/Autocomplete.js +141 -125
  32. package/dist/Autocomplete/AutocompleteContext.js +20 -18
  33. package/dist/Autocomplete/AutocompleteInput.js +146 -108
  34. package/dist/Autocomplete/AutocompleteMenu.js +238 -201
  35. package/dist/Autocomplete/AutocompleteMenu.module.css.js +5 -8
  36. package/dist/Autocomplete/AutocompleteOverlay.js +79 -54
  37. package/dist/Autocomplete/AutocompleteOverlay.module.css.js +5 -5
  38. package/dist/Avatar/Avatar.js +133 -106
  39. package/dist/Avatar/Avatar.module.css.js +5 -5
  40. package/dist/AvatarStack/AvatarStack.js +143 -102
  41. package/dist/AvatarStack/AvatarStack.module.css.js +5 -9
  42. package/dist/Banner/Banner.js +186 -133
  43. package/dist/Banner/Banner.module.css.js +5 -14
  44. package/dist/Banner/index.js +7 -7
  45. package/dist/BaseStyles.js +91 -74
  46. package/dist/BaseStyles.module.css.js +5 -5
  47. package/dist/Blankslate/Blankslate.js +328 -266
  48. package/dist/Blankslate/Blankslate.module.css.js +5 -12
  49. package/dist/Blankslate/BlankslateContext.js +9 -7
  50. package/dist/Blankslate/index.js +9 -9
  51. package/dist/BranchName/BranchName.js +59 -49
  52. package/dist/BranchName/BranchName.module.css.js +5 -5
  53. package/dist/Breadcrumbs/Breadcrumbs.js +431 -371
  54. package/dist/Breadcrumbs/Breadcrumbs.module.css.js +5 -15
  55. package/dist/Button/Button.js +18 -15
  56. package/dist/Button/ButtonBase.js +139 -76
  57. package/dist/Button/ButtonBase.module.css.js +5 -16
  58. package/dist/Button/IconButton.js +74 -42
  59. package/dist/Button/LinkButton.js +17 -13
  60. package/dist/ButtonGroup/ButtonGroup.js +97 -80
  61. package/dist/ButtonGroup/ButtonGroup.module.css.js +5 -5
  62. package/dist/Card/Card.js +491 -401
  63. package/dist/Card/Card.module.css.js +5 -18
  64. package/dist/Card/index.js +9 -9
  65. package/dist/Checkbox/Checkbox.js +71 -52
  66. package/dist/Checkbox/Checkbox.module.css.js +5 -9
  67. package/dist/Checkbox/shared.module.css.js +5 -5
  68. package/dist/CheckboxGroup/CheckboxGroup.js +132 -111
  69. package/dist/CheckboxGroup/CheckboxGroupContext.js +4 -4
  70. package/dist/CircleBadge/CircleBadge.js +90 -77
  71. package/dist/CircleBadge/CircleBadge.module.css.js +5 -8
  72. package/dist/ConfirmationDialog/ConfirmationDialog.js +92 -68
  73. package/dist/CounterLabel/CounterLabel.js +99 -83
  74. package/dist/CounterLabel/CounterLabel.module.css.js +5 -5
  75. package/dist/DataTable/DataTable.js +140 -100
  76. package/dist/DataTable/ErrorDialog.js +45 -33
  77. package/dist/DataTable/Pagination.js +592 -464
  78. package/dist/DataTable/Pagination.module.css.js +5 -13
  79. package/dist/DataTable/Table.js +710 -527
  80. package/dist/DataTable/Table.module.css.js +5 -26
  81. package/dist/DataTable/column.js +11 -10
  82. package/dist/DataTable/index.js +20 -22
  83. package/dist/DataTable/sorting.js +103 -65
  84. package/dist/DataTable/useTable.js +290 -207
  85. package/dist/Details/Details.js +126 -100
  86. package/dist/Details/Details.module.css.js +5 -5
  87. package/dist/Dialog/Dialog.js +351 -259
  88. package/dist/Dialog/Dialog.module.css.js +5 -22
  89. package/dist/FeatureFlags/DefaultFeatureFlags.js +7 -7
  90. package/dist/FeatureFlags/FeatureFlagContext.js +5 -5
  91. package/dist/FeatureFlags/FeatureFlagScope.js +44 -36
  92. package/dist/FeatureFlags/FeatureFlags.js +37 -29
  93. package/dist/FeatureFlags/useFeatureFlag.js +19 -17
  94. package/dist/FilteredActionList/FilteredActionList.d.ts.map +1 -1
  95. package/dist/FilteredActionList/FilteredActionList.js +559 -454
  96. package/dist/FilteredActionList/FilteredActionList.module.css.js +5 -15
  97. package/dist/FilteredActionList/FilteredActionListInput.d.ts +15 -0
  98. package/dist/FilteredActionList/FilteredActionListInput.d.ts.map +1 -0
  99. package/dist/FilteredActionList/FilteredActionListInput.js +119 -0
  100. package/dist/FilteredActionList/FilteredActionListLoaders.js +150 -119
  101. package/dist/FilteredActionList/FilteredActionListLoaders.module.css.js +5 -9
  102. package/dist/FilteredActionList/index.d.ts +9 -1
  103. package/dist/FilteredActionList/index.d.ts.map +1 -1
  104. package/dist/FilteredActionList/index.js +11 -0
  105. package/dist/FilteredActionList/useAnnouncements.js +180 -167
  106. package/dist/Flash/Flash.js +69 -57
  107. package/dist/Flash/Flash.module.css.js +5 -5
  108. package/dist/FormControl/FormControl.js +227 -211
  109. package/dist/FormControl/FormControl.module.css.js +5 -11
  110. package/dist/FormControl/FormControlCaption.js +49 -37
  111. package/dist/FormControl/FormControlCaption.module.css.js +5 -5
  112. package/dist/FormControl/FormControlLabel.js +115 -95
  113. package/dist/FormControl/FormControlLeadingVisual.js +37 -29
  114. package/dist/FormControl/FormControlLeadingVisual.module.css.js +5 -5
  115. package/dist/FormControl/_FormControlContext.js +48 -41
  116. package/dist/FormControl/_FormControlValidation.js +39 -29
  117. package/dist/Header/Header.js +165 -138
  118. package/dist/Header/Header.module.css.js +5 -9
  119. package/dist/Heading/Heading.js +37 -26
  120. package/dist/Heading/Heading.module.css.js +5 -5
  121. package/dist/Hidden/Hidden.js +77 -54
  122. package/dist/Hidden/Hidden.module.css.js +5 -5
  123. package/dist/InlineMessage/InlineMessage.js +116 -88
  124. package/dist/InlineMessage/InlineMessage.module.css.js +5 -8
  125. package/dist/KeybindingHint/KeybindingHint.js +88 -70
  126. package/dist/KeybindingHint/KeybindingHint.module.css.js +5 -5
  127. package/dist/KeybindingHint/components/Chord.js +93 -81
  128. package/dist/KeybindingHint/components/Chord.module.css.js +5 -11
  129. package/dist/KeybindingHint/components/Key.js +66 -49
  130. package/dist/KeybindingHint/components/Sequence.js +24 -12
  131. package/dist/KeybindingHint/key-names.js +114 -99
  132. package/dist/Label/Label.js +66 -56
  133. package/dist/Label/Label.module.css.js +5 -5
  134. package/dist/Label/index.js +5 -5
  135. package/dist/LabelGroup/LabelGroup.js +344 -260
  136. package/dist/LabelGroup/LabelGroup.module.css.js +5 -12
  137. package/dist/Link/Link.js +47 -31
  138. package/dist/Link/Link.module.css.js +5 -5
  139. package/dist/NavList/NavList.js +614 -424
  140. package/dist/NavList/NavList.module.css.js +5 -5
  141. package/dist/Octicon/Octicon.js +37 -35
  142. package/dist/Overlay/Overlay.js +318 -264
  143. package/dist/Overlay/Overlay.module.css.js +5 -8
  144. package/dist/PageHeader/PageHeader.js +823 -579
  145. package/dist/PageHeader/PageHeader.module.css.js +5 -21
  146. package/dist/PageLayout/PageLayout.js +913 -631
  147. package/dist/PageLayout/PageLayout.module.css.js +5 -31
  148. package/dist/PageLayout/paneUtils.js +29 -15
  149. package/dist/PageLayout/usePaneWidth.js +437 -334
  150. package/dist/Pagehead/Pagehead.js +14 -10
  151. package/dist/Pagehead/Pagehead.module.css.js +5 -5
  152. package/dist/Pagination/Pagination.js +114 -84
  153. package/dist/Pagination/Pagination.module.css.js +5 -9
  154. package/dist/Pagination/index.js +5 -5
  155. package/dist/Pagination/model.js +194 -118
  156. package/dist/Popover/Popover.js +151 -126
  157. package/dist/Popover/Popover.module.css.js +5 -8
  158. package/dist/Portal/Portal.js +85 -65
  159. package/dist/Portal/index.js +6 -5
  160. package/dist/ProgressBar/ProgressBar.js +255 -210
  161. package/dist/ProgressBar/ProgressBar.module.css.js +5 -9
  162. package/dist/ProgressBar/index.js +8 -6
  163. package/dist/Radio/Radio.js +115 -97
  164. package/dist/Radio/Radio.module.css.js +5 -5
  165. package/dist/RadioGroup/RadioGroup.js +118 -99
  166. package/dist/RelativeTime/RelativeTime.js +76 -64
  167. package/dist/ScrollableRegion/ScrollableRegion.js +79 -67
  168. package/dist/ScrollableRegion/ScrollableRegion.module.css.js +5 -5
  169. package/dist/SegmentedControl/SegmentedControl.js +287 -238
  170. package/dist/SegmentedControl/SegmentedControl.module.css.js +5 -15
  171. package/dist/SegmentedControl/SegmentedControlButton.js +187 -156
  172. package/dist/SegmentedControl/SegmentedControlIconButton.js +161 -133
  173. package/dist/Select/Select.js +234 -185
  174. package/dist/Select/Select.module.css.js +5 -10
  175. package/dist/SelectPanel/SelectPanel.d.ts +1 -0
  176. package/dist/SelectPanel/SelectPanel.d.ts.map +1 -1
  177. package/dist/SelectPanel/SelectPanel.js +829 -620
  178. package/dist/SelectPanel/SelectPanel.module.css.js +5 -27
  179. package/dist/SelectPanel/SelectPanelMessage.js +39 -37
  180. package/dist/SelectPanel/index.d.ts +1 -0
  181. package/dist/SelectPanel/index.d.ts.map +1 -1
  182. package/dist/SideNav.js +47 -24
  183. package/dist/SideNav.module.css.js +5 -12
  184. package/dist/Skeleton/SkeletonBox.js +111 -94
  185. package/dist/Skeleton/SkeletonBox.module.css.js +5 -8
  186. package/dist/SkeletonAvatar/SkeletonAvatar.js +120 -95
  187. package/dist/SkeletonAvatar/SkeletonAvatar.module.css.js +5 -5
  188. package/dist/SkeletonText/SkeletonText.js +137 -114
  189. package/dist/SkeletonText/SkeletonText.module.css.js +5 -8
  190. package/dist/Spinner/Spinner.js +211 -183
  191. package/dist/Spinner/Spinner.module.css.js +5 -9
  192. package/dist/SplitPageLayout/SplitPageLayout.js +276 -215
  193. package/dist/Stack/Stack.js +255 -207
  194. package/dist/Stack/Stack.module.css.js +5 -8
  195. package/dist/Stack/index.js +6 -4
  196. package/dist/StateLabel/StateLabel.js +123 -110
  197. package/dist/StateLabel/StateLabel.module.css.js +5 -8
  198. package/dist/SubNav/SubNav.js +197 -159
  199. package/dist/SubNav/SubNav.module.css.js +5 -11
  200. package/dist/TabNav/TabNav.js +199 -167
  201. package/dist/TabNav/TabNav.module.css.js +5 -10
  202. package/dist/Text/Text.js +67 -56
  203. package/dist/Text/Text.module.css.js +5 -5
  204. package/dist/TextInput/TextInput.js +228 -195
  205. package/dist/TextInput/TextInput.module.css.js +5 -8
  206. package/dist/TextInputWithTokens/TextInputWithTokens.js +673 -567
  207. package/dist/TextInputWithTokens/TextInputWithTokens.module.css.js +5 -14
  208. package/dist/Textarea/TextArea.module.css.js +5 -9
  209. package/dist/Textarea/Textarea.js +294 -264
  210. package/dist/ThemeProvider.js +257 -199
  211. package/dist/Timeline/Timeline.js +247 -204
  212. package/dist/Timeline/Timeline.module.css.js +5 -12
  213. package/dist/ToggleSwitch/ToggleSwitch.js +471 -403
  214. package/dist/ToggleSwitch/ToggleSwitch.module.css.js +5 -16
  215. package/dist/Token/IssueLabelToken.js +297 -256
  216. package/dist/Token/IssueLabelToken.module.css.js +5 -8
  217. package/dist/Token/Token.js +280 -232
  218. package/dist/Token/Token.module.css.js +5 -9
  219. package/dist/Token/TokenBase.js +126 -99
  220. package/dist/Token/TokenBase.module.css.js +5 -5
  221. package/dist/Token/_RemoveTokenButton.js +48 -27
  222. package/dist/Token/_RemoveTokenButton.module.css.js +5 -5
  223. package/dist/Token/_TokenTextContainer.js +65 -54
  224. package/dist/Token/_TokenTextContainer.module.css.js +5 -5
  225. package/dist/Tooltip/Tooltip.js +56 -49
  226. package/dist/Tooltip/Tooltip.module.css.js +5 -20
  227. package/dist/TooltipV2/Tooltip.js +305 -222
  228. package/dist/TooltipV2/Tooltip.module.css.js +5 -11
  229. package/dist/TopicTag/TopicTag.js +55 -46
  230. package/dist/TopicTag/TopicTag.module.css.js +5 -5
  231. package/dist/TopicTag/TopicTagGroup.js +48 -40
  232. package/dist/TopicTag/TopicTagGroup.module.css.js +5 -5
  233. package/dist/TopicTag/index.js +7 -5
  234. package/dist/TreeView/TreeView.js +1414 -1082
  235. package/dist/TreeView/TreeView.module.css.js +5 -24
  236. package/dist/TreeView/shared.js +9 -10
  237. package/dist/TreeView/useRovingTabIndex.js +203 -129
  238. package/dist/TreeView/useTreeItemCache.js +79 -64
  239. package/dist/TreeView/useTypeahead.js +112 -90
  240. package/dist/Truncate/Truncate.js +33 -21
  241. package/dist/Truncate/Truncate.module.css.js +5 -5
  242. package/dist/UnderlineNav/UnderlineNav.js +375 -278
  243. package/dist/UnderlineNav/UnderlineNav.module.css.js +5 -8
  244. package/dist/UnderlineNav/UnderlineNavContext.js +8 -8
  245. package/dist/UnderlineNav/UnderlineNavItem.js +72 -56
  246. package/dist/UnderlineNav/UnderlineNavItem.module.css.js +5 -5
  247. package/dist/UnderlineNav/index.js +7 -5
  248. package/dist/UnderlineNav/styles.js +15 -11
  249. package/dist/VisuallyHidden/VisuallyHidden.js +49 -51
  250. package/dist/VisuallyHidden/VisuallyHidden.module.css.js +5 -5
  251. package/dist/_VisuallyHidden.js +62 -50
  252. package/dist/_VisuallyHidden.module.css.js +5 -5
  253. package/dist/deprecated/ActionList/Divider.js +23 -23
  254. package/dist/deprecated/ActionList/Divider.module.css.js +5 -5
  255. package/dist/deprecated/ActionList/Group.js +50 -43
  256. package/dist/deprecated/ActionList/Header.js +81 -69
  257. package/dist/deprecated/ActionList/Header.module.css.js +5 -5
  258. package/dist/deprecated/ActionList/Item.js +352 -308
  259. package/dist/deprecated/ActionList/Item.module.css.js +5 -18
  260. package/dist/deprecated/ActionList/List.js +196 -157
  261. package/dist/deprecated/ActionList/List.module.css.js +5 -5
  262. package/dist/deprecated/ActionList/index.js +14 -14
  263. package/dist/deprecated/ActionMenu.js +190 -159
  264. package/dist/deprecated/DialogV1/Dialog.js +200 -166
  265. package/dist/deprecated/DialogV1/Dialog.module.css.js +5 -11
  266. package/dist/deprecated/FilteredSearch/FilteredSearch.js +51 -43
  267. package/dist/deprecated/FilteredSearch/FilteredSearch.module.css.js +5 -5
  268. package/dist/deprecated/UnderlineNav/UnderlineNav.js +160 -132
  269. package/dist/deprecated/UnderlineNav/UnderlineNav.module.css.js +5 -14
  270. package/dist/deprecated/index.js +9 -20
  271. package/dist/experimental/IssueLabel/IssueLabel.js +158 -134
  272. package/dist/experimental/IssueLabel/IssueLabel.module.css.js +5 -5
  273. package/dist/experimental/SelectPanel2/SelectPanel.js +567 -419
  274. package/dist/experimental/SelectPanel2/SelectPanel.module.css.js +5 -32
  275. package/dist/experimental/Tabs/Tabs.js +297 -234
  276. package/dist/experimental/UnderlinePanels/UnderlinePanels.js +215 -165
  277. package/dist/experimental/UnderlinePanels/UnderlinePanels.module.css.js +5 -5
  278. package/dist/experimental/index.d.ts +2 -2
  279. package/dist/experimental/index.d.ts.map +1 -1
  280. package/dist/experimental/index.js +34 -44
  281. package/dist/hooks/useAnchoredPosition.js +144 -123
  282. package/dist/hooks/useControllableState.js +59 -34
  283. package/dist/hooks/useDetails.js +99 -84
  284. package/dist/hooks/useDialog.js +178 -140
  285. package/dist/hooks/useFocusTrap.js +71 -57
  286. package/dist/hooks/useFocusZone.js +38 -32
  287. package/dist/hooks/useId.js +16 -14
  288. package/dist/hooks/useIsMacOS.js +26 -21
  289. package/dist/hooks/useMedia.js +68 -54
  290. package/dist/hooks/useMenuInitialFocus.js +62 -65
  291. package/dist/hooks/useMenuKeyboardNavigation.js +126 -129
  292. package/dist/hooks/useMergedRefs.js +78 -63
  293. package/dist/hooks/useMnemonics.js +107 -77
  294. package/dist/hooks/useOnEscapePress.js +56 -45
  295. package/dist/hooks/useOnOutsideClick.js +63 -32
  296. package/dist/hooks/useOpenAndCloseFocus.js +43 -40
  297. package/dist/hooks/useOverflow.js +36 -32
  298. package/dist/hooks/useOverlay.js +75 -56
  299. package/dist/hooks/useProvidedRefOrCreate.js +24 -24
  300. package/dist/hooks/useProvidedStateOrCreate.js +39 -33
  301. package/dist/hooks/useRefObjectAsForwardedRef.js +32 -30
  302. package/dist/hooks/useRenderForcingRef.js +46 -42
  303. package/dist/hooks/useResizeObserver.js +43 -32
  304. package/dist/hooks/useResponsiveValue.js +57 -37
  305. package/dist/hooks/useSafeTimeout.js +29 -26
  306. package/dist/hooks/useScrollFlash.js +23 -16
  307. package/dist/hooks/useSlots.js +136 -102
  308. package/dist/hooks/useSyncedState.js +37 -31
  309. package/dist/index.d.ts +2 -2
  310. package/dist/index.d.ts.map +1 -1
  311. package/dist/index.js +86 -88
  312. package/dist/internal/components/ButtonReset.js +50 -45
  313. package/dist/internal/components/ButtonReset.module.css.js +5 -5
  314. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.js +105 -79
  315. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.module.css.js +5 -12
  316. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupCaption.js +21 -16
  317. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupContext.js +4 -4
  318. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupLabel.js +35 -26
  319. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupValidation.js +19 -14
  320. package/dist/internal/components/ConditionalWrapper.js +51 -41
  321. package/dist/internal/components/InputLabel.js +113 -92
  322. package/dist/internal/components/InputLabel.module.css.js +5 -8
  323. package/dist/internal/components/InputValidation.js +87 -67
  324. package/dist/internal/components/InputValidation.module.css.js +5 -9
  325. package/dist/internal/components/TextInputInnerAction.js +173 -134
  326. package/dist/internal/components/TextInputInnerAction.module.css.js +5 -9
  327. package/dist/internal/components/TextInputInnerVisualSlot.js +110 -89
  328. package/dist/internal/components/TextInputInnerVisualSlot.module.css.js +5 -11
  329. package/dist/internal/components/TextInputWrapper.js +230 -187
  330. package/dist/internal/components/TextInputWrapper.module.css.js +5 -8
  331. package/dist/internal/components/UnderlineTabbedInterface.js +238 -191
  332. package/dist/internal/components/UnderlineTabbedInterface.module.css.js +5 -11
  333. package/dist/internal/components/UnstyledTextInput.js +47 -40
  334. package/dist/internal/components/UnstyledTextInput.module.css.js +5 -5
  335. package/dist/internal/components/ValidationAnimationContainer.js +66 -55
  336. package/dist/internal/components/ValidationAnimationContainer.module.css.js +5 -8
  337. package/dist/internal/hooks/useEffectCallback.js +38 -35
  338. package/dist/internal/hooks/useEffectOnce.js +25 -23
  339. package/dist/internal/utils/getResponsiveAttributes.js +26 -23
  340. package/dist/internal/utils/hasInteractiveNodes.js +46 -34
  341. package/dist/legacy-theme/ts/color-schemes.js +4732 -4250
  342. package/dist/live-region/Announce.js +183 -144
  343. package/dist/live-region/AriaAlert.js +22 -20
  344. package/dist/live-region/AriaStatus.js +22 -20
  345. package/dist/next/index.js +1 -3
  346. package/dist/test-helpers.js +62 -40
  347. package/dist/theme.js +47 -83
  348. package/dist/utils/character-counter.js +63 -45
  349. package/dist/utils/create-component.js +16 -15
  350. package/dist/utils/descendant-registry.js +218 -182
  351. package/dist/utils/environment.js +7 -7
  352. package/dist/utils/getBreakpointDeclarations.js +10 -9
  353. package/dist/utils/invariant.js +23 -17
  354. package/dist/utils/is-slot.js +11 -10
  355. package/dist/utils/isNumeric.js +3 -3
  356. package/dist/utils/modern-polymorphic.js +20 -12
  357. package/dist/utils/scroll.js +11 -8
  358. package/dist/utils/theme.js +10 -5
  359. package/dist/utils/useIsomorphicLayoutEffect.js +9 -4
  360. package/dist/utils/warning.js +21 -14
  361. package/package.json +10 -5
  362. package/dist/ActionList/ActionList-53389912.css.map +0 -1
@@ -1,644 +1,853 @@
1
- import { useProvidedRefOrCreate } from "../hooks/useProvidedRefOrCreate.js";
2
- import { useProvidedStateOrCreate } from "../hooks/useProvidedStateOrCreate.js";
3
- import { isAlphabetKey } from "../hooks/useMnemonics.js";
4
- import { useId as useId$1 } from "../hooks/useId.js";
5
- import useSafeTimeout from "../hooks/useSafeTimeout.js";
6
- import { IconButton } from "../Button/IconButton.js";
7
- import { LinkButton } from "../Button/LinkButton.js";
8
- import { ButtonComponent } from "../Button/Button.js";
9
- import { useResponsiveValue } from "../hooks/useResponsiveValue.js";
10
- import Heading from "../Heading/Heading.js";
11
- import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
12
- import { AnchoredOverlay } from "../AnchoredOverlay/AnchoredOverlay.js";
13
- import { Banner } from "../Banner/index.js";
14
- import { useFormControlContext } from "../FormControl/_FormControlContext.js";
15
- import { FilteredActionListLoadingTypes } from "../FilteredActionList/FilteredActionListLoaders.js";
16
- import { FilteredActionList } from "../FilteredActionList/FilteredActionList.js";
17
- import SelectPanel_module_css_default from "./SelectPanel.module.css.js";
18
- import { SelectPanelMessage } from "./SelectPanelMessage.js";
19
- import { clsx } from "clsx";
20
- import { Fragment, jsx, jsxs } from "react/jsx-runtime";
21
- import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
22
- import { announce, announceFromElement } from "@primer/live-region-element";
23
- import { SearchIcon, TriangleDownIcon, XIcon } from "@primer/octicons-react";
24
- import { debounce } from "@github/mini-throttle";
25
- //#region src/SelectPanel/SelectPanel.tsx
1
+ import { SearchIcon, XIcon, TriangleDownIcon } from '@primer/octicons-react';
2
+ import React, { useState, useRef, useEffect, useCallback, useMemo } from 'react';
3
+ import { FilteredActionList } from '../FilteredActionList/index.js';
4
+ import { SelectPanelMessage } from './SelectPanelMessage.js';
5
+ import { IconButton } from '../Button/IconButton.js';
6
+ import { LinkButton } from '../Button/LinkButton.js';
7
+ import { ButtonComponent } from '../Button/Button.js';
8
+ import { useId } from '../hooks/useId.js';
9
+ import { useProvidedStateOrCreate } from '../hooks/useProvidedStateOrCreate.js';
10
+ import useSafeTimeout from '../hooks/useSafeTimeout.js';
11
+ import { FilteredActionListLoadingTypes } from '../FilteredActionList/FilteredActionListLoaders.js';
12
+ import { announceFromElement, announce } from '@primer/live-region-element';
13
+ import classes from './SelectPanel.module.css.js';
14
+ import { clsx } from 'clsx';
15
+ import { debounce } from '@github/mini-throttle';
16
+ import { useResponsiveValue } from '../hooks/useResponsiveValue.js';
17
+ import { Banner } from '../Banner/index.js';
18
+ import { isAlphabetKey } from '../hooks/useMnemonics.js';
19
+ import { useFormControlContext } from '../FormControl/_FormControlContext.js';
20
+ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
21
+ import { useFeatureFlag } from '../FeatureFlags/useFeatureFlag.js';
22
+ import { useProvidedRefOrCreate } from '../hooks/useProvidedRefOrCreate.js';
23
+ import { AnchoredOverlay } from '../AnchoredOverlay/AnchoredOverlay.js';
24
+ import Heading from '../Heading/Heading.js';
25
+
26
26
  const SHORT_DELAY_MS = 500;
27
- const LONG_DELAY_MS = 1e3;
27
+ const LONG_DELAY_MS = 1000;
28
28
  const EMPTY_MESSAGE = {
29
- title: "No items available",
30
- description: ""
29
+ title: 'No items available',
30
+ description: ''
31
31
  };
32
- const DefaultEmptyMessage = /* @__PURE__ */ jsx(SelectPanelMessage, {
33
- variant: "empty",
34
- title: EMPTY_MESSAGE.title,
35
- children: EMPTY_MESSAGE.description
32
+ const DefaultEmptyMessage = /*#__PURE__*/jsx(SelectPanelMessage, {
33
+ variant: "empty",
34
+ title: EMPTY_MESSAGE.title,
35
+ children: EMPTY_MESSAGE.description
36
36
  }, "empty-message");
37
37
  async function announceText(text, delayMs = SHORT_DELAY_MS) {
38
- const liveRegion = document.querySelector("live-region");
39
- liveRegion === null || liveRegion === void 0 || liveRegion.clear();
40
- await announce(text, {
41
- delayMs,
42
- from: liveRegion ? liveRegion : void 0
43
- });
38
+ const liveRegion = document.querySelector('live-region');
39
+ liveRegion === null || liveRegion === void 0 ? void 0 : liveRegion.clear(); // clear previous announcements
40
+
41
+ await announce(text, {
42
+ delayMs,
43
+ from: liveRegion ? liveRegion : undefined // announce will create a liveRegion if it doesn't find one
44
+ });
44
45
  }
45
46
  async function announceLoading() {
46
- await announceText("Loading.");
47
+ await announceText('Loading.');
47
48
  }
49
+
50
+ // onCancel is optional with variant=anchored, but required with variant=modal
51
+
48
52
  function isMultiSelectVariant(selected) {
49
- return Array.isArray(selected);
53
+ return Array.isArray(selected);
50
54
  }
51
- const focusZoneSettings = { disabled: true };
52
- const closeButtonProps = { "aria-label": "Cancel and close" };
55
+ const focusZoneSettings = {
56
+ // Let FilteredActionList handle focus zone
57
+ disabled: true
58
+ };
59
+ const closeButtonProps = {
60
+ 'aria-label': 'Cancel and close'
61
+ };
53
62
  const areItemsEqual = (itemA, itemB) => {
54
- if (typeof itemA.id !== "undefined") return itemA.id === itemB.id;
55
- else return itemA === itemB;
63
+ // prefer checking equivality by item.id
64
+ if (typeof itemA.id !== 'undefined') return itemA.id === itemB.id;else return itemA === itemB;
56
65
  };
57
66
  const doesItemsIncludeItem = (items, item) => {
58
- return items.some((i) => areItemsEqual(i, item));
67
+ return items.some(i => areItemsEqual(i, item));
59
68
  };
60
- const defaultRenderAnchor = (props) => {
61
- const { children, ...rest } = props;
62
- return /* @__PURE__ */ jsx(ButtonComponent, {
63
- trailingAction: TriangleDownIcon,
64
- ...rest,
65
- children
66
- });
69
+ const defaultRenderAnchor = props => {
70
+ const {
71
+ children,
72
+ ...rest
73
+ } = props;
74
+ return /*#__PURE__*/jsx(ButtonComponent, {
75
+ trailingAction: TriangleDownIcon,
76
+ ...rest,
77
+ children: children
78
+ });
67
79
  };
68
80
  defaultRenderAnchor.displayName = "defaultRenderAnchor";
69
- function Panel({ open, onOpenChange, renderAnchor = defaultRenderAnchor, anchorRef: externalAnchorRef, placeholder, placeholderText = "Filter items", inputLabel = placeholderText, selected, title = isMultiSelectVariant(selected) ? "Select items" : "Select an item", subtitle, onSelectedChange, filterValue: externalFilterValue, onFilterChange: externalOnFilterChange, items, footer, textInputProps, overlayProps, loading, initialLoadingType = "spinner", className, height, width, id, message, notice, onCancel, variant = "anchored", secondaryAction, showSelectedOptionsFirst = true, disableFullscreenOnNarrow, align, showSelectAll = false, focusPrependedElements, virtualized, displayInViewport, ...listProps }) {
70
- var _listProps$groupMetad;
71
- const titleId = useId$1();
72
- const subtitleId = useId$1();
73
- const [dataLoadedOnce, setDataLoadedOnce] = useState(false);
74
- const [isLoading, setIsLoading] = useState(false);
75
- const [filterValue, setInternalFilterValue] = useProvidedStateOrCreate(externalFilterValue, void 0, "");
76
- const { safeSetTimeout, safeClearTimeout } = useSafeTimeout();
77
- const loadingDelayTimeoutId = useRef(null);
78
- const loadingManagedInternally = loading === void 0;
79
- const loadingManagedExternally = !loadingManagedInternally;
80
- const [inputRef, setInputRef] = React.useState(null);
81
- const [listContainerElement, setListContainerElement] = useState(null);
82
- const [needsNoItemsAnnouncement, setNeedsNoItemsAnnouncement] = useState(false);
83
- const isNarrowScreenSize = useResponsiveValue({
84
- narrow: true,
85
- regular: false,
86
- wide: false
87
- }, false);
88
- const [selectedOnSort, setSelectedOnSort] = useState([]);
89
- const initialHeightRef = useRef(0);
90
- const initialScaleRef = useRef(1);
91
- const noticeRef = useRef(null);
92
- const [isKeyboardVisible, setIsKeyboardVisible] = useState(false);
93
- const [availablePanelHeight, setAvailablePanelHeight] = useState(void 0);
94
- const KEYBOARD_VISIBILITY_THRESHOLD = 10;
95
- const featureFlagFullScreenOnNarrow = useFeatureFlag("primer_react_select_panel_fullscreen_on_narrow");
96
- const usingFullScreenOnNarrow = disableFullscreenOnNarrow ? false : featureFlagFullScreenOnNarrow;
97
- const shouldOrderSelectedFirst = useFeatureFlag("primer_react_select_panel_order_selected_at_top") && showSelectedOptionsFirst;
98
- const { isReferenced, labelId } = useFormControlContext();
99
- const selectedValueId = id ? `${id}-selected-value` : void 0;
100
- const isSingleSelectModal = variant === "modal" && !isMultiSelectVariant(selected);
101
- const [intermediateSelected, setIntermediateSelected] = useState(isSingleSelectModal ? selected : void 0);
102
- useEffect(() => {
103
- setIntermediateSelected(isSingleSelectModal ? selected : void 0);
104
- }, [
105
- isSingleSelectModal,
106
- open,
107
- selected
108
- ]);
109
- const onListContainerRefChanged = useCallback((node) => {
110
- setListContainerElement(node);
111
- if (!node && needsNoItemsAnnouncement) setNeedsNoItemsAnnouncement(false);
112
- }, [needsNoItemsAnnouncement]);
113
- const onInputRefChanged = useCallback((ref) => {
114
- setInputRef(ref);
115
- }, [setInputRef]);
116
- const resetSort = useCallback(() => {
117
- if (isMultiSelectVariant(selected)) setSelectedOnSort(selected);
118
- else if (selected) setSelectedOnSort([selected]);
119
- else setSelectedOnSort([]);
120
- }, [selected]);
121
- const onFilterChange = useCallback((value, e) => {
122
- if (loadingManagedInternally) {
123
- if (loadingDelayTimeoutId.current) safeClearTimeout(loadingDelayTimeoutId.current);
124
- if (dataLoadedOnce) loadingDelayTimeoutId.current = safeSetTimeout(() => {
125
- setIsLoading(true);
126
- announceLoading();
127
- }, LONG_DELAY_MS);
128
- else {
129
- if (items.length === 0) setIsLoading(true);
130
- loadingDelayTimeoutId.current = safeSetTimeout(() => {
131
- announceLoading();
132
- }, LONG_DELAY_MS);
133
- }
134
- }
135
- externalOnFilterChange(value, e);
136
- setInternalFilterValue(value);
137
- if (!value) resetSort();
138
- }, [
139
- loadingManagedInternally,
140
- externalOnFilterChange,
141
- setInternalFilterValue,
142
- dataLoadedOnce,
143
- safeSetTimeout,
144
- safeClearTimeout,
145
- items.length,
146
- resetSort
147
- ]);
148
- const itemsInViewSet = useMemo(() => {
149
- const set = /* @__PURE__ */ new Set();
150
- for (const item of items) if (item.id !== void 0) set.add(item.id);
151
- else set.add(item);
152
- return set;
153
- }, [items]);
154
- const handleSelectAllChange = useCallback((checked) => {
155
- if (!isMultiSelectVariant(selected)) return;
156
- const multiSelectOnChange = onSelectedChange;
157
- const selectedItemsNotInFilteredView = selected.filter((selectedItem) => {
158
- if (selectedItem.id !== void 0) return !itemsInViewSet.has(selectedItem.id);
159
- return !itemsInViewSet.has(selectedItem);
160
- });
161
- if (checked) multiSelectOnChange([...selectedItemsNotInFilteredView, ...items]);
162
- else multiSelectOnChange(selectedItemsNotInFilteredView);
163
- }, [
164
- items,
165
- itemsInViewSet,
166
- onSelectedChange,
167
- selected
168
- ]);
169
- useEffect(() => {
170
- if (open && (variant === "modal" || isNarrowScreenSize && usingFullScreenOnNarrow)) {
171
- const bodyOverflowStyle = document.body.style.overflow || "";
172
- if (bodyOverflowStyle === "hidden") return;
173
- document.body.style.overflow = "hidden";
174
- return () => {
175
- document.body.style.overflow = bodyOverflowStyle;
176
- };
177
- }
178
- }, [
179
- isNarrowScreenSize,
180
- open,
181
- usingFullScreenOnNarrow,
182
- variant
183
- ]);
184
- useEffect(() => {
185
- if (open) {
186
- if (items.length === 0 && !(isLoading || loading)) setNeedsNoItemsAnnouncement(true);
187
- }
188
- if (loadingManagedExternally) {
189
- if (items.length > 0) setDataLoadedOnce(true);
190
- return;
191
- }
192
- if (isLoading || items.length > 0) {
193
- setIsLoading(false);
194
- setDataLoadedOnce(true);
195
- }
196
- if (loadingDelayTimeoutId.current) safeClearTimeout(loadingDelayTimeoutId.current);
197
- }, [items]);
198
- useEffect(() => {
199
- if (inputRef !== null && inputRef !== void 0 && inputRef.current) {
200
- const ref = inputRef.current;
201
- if (open) ref.focus();
202
- }
203
- }, [inputRef, open]);
204
- useEffect(() => {
205
- if (loadingManagedExternally) {
206
- if (isLoading) loadingDelayTimeoutId.current = safeSetTimeout(() => {
207
- announceLoading();
208
- }, LONG_DELAY_MS);
209
- else if (loadingDelayTimeoutId.current) safeClearTimeout(loadingDelayTimeoutId.current);
210
- }
211
- }, [
212
- isLoading,
213
- loadingManagedExternally,
214
- safeSetTimeout,
215
- safeClearTimeout
216
- ]);
217
- useEffect(() => {
218
- if (loadingManagedExternally) return;
219
- if (dataLoadedOnce) return;
220
- if (open) {
221
- if (items.length === 0) onFilterChange(filterValue, null);
222
- }
223
- }, [
224
- open,
225
- dataLoadedOnce,
226
- onFilterChange,
227
- filterValue,
228
- items,
229
- loadingManagedExternally,
230
- listContainerElement
231
- ]);
232
- useEffect(() => {
233
- if (!window.visualViewport || !open || !isNarrowScreenSize) return;
234
- initialHeightRef.current = window.visualViewport.height;
235
- initialScaleRef.current = window.visualViewport.scale;
236
- const handleViewportChange = debounce(() => {
237
- if (window.visualViewport) {
238
- if (!(window.visualViewport.scale !== initialScaleRef.current)) {
239
- const currentHeight = window.visualViewport.height;
240
- const keyboardVisible = initialHeightRef.current - currentHeight > KEYBOARD_VISIBILITY_THRESHOLD;
241
- setIsKeyboardVisible(keyboardVisible);
242
- setAvailablePanelHeight(keyboardVisible ? currentHeight : void 0);
243
- }
244
- }
245
- }, 100);
246
- if (window.visualViewport) {
247
- window.visualViewport.addEventListener("resize", handleViewportChange);
248
- window.visualViewport.addEventListener("scroll", handleViewportChange);
249
- }
250
- return () => {
251
- if (window.visualViewport) {
252
- window.visualViewport.removeEventListener("resize", handleViewportChange);
253
- window.visualViewport.removeEventListener("scroll", handleViewportChange);
254
- }
255
- handleViewportChange.cancel();
256
- };
257
- }, [open, isNarrowScreenSize]);
258
- useEffect(() => {
259
- const announceNotice = async () => {
260
- if (!noticeRef.current) return;
261
- const liveRegion = document.querySelector("live-region");
262
- liveRegion === null || liveRegion === void 0 || liveRegion.clear();
263
- await announceFromElement(noticeRef.current, { from: liveRegion ? liveRegion : void 0 });
264
- };
265
- if (open && notice) announceNotice();
266
- }, [notice, open]);
267
- const anchorRef = useProvidedRefOrCreate(externalAnchorRef);
268
- const onOpen = useCallback((gesture) => onOpenChange(true, gesture), [onOpenChange]);
269
- const onCancelRequested = useCallback(() => {
270
- onOpenChange(false, "cancel");
271
- }, [onOpenChange]);
272
- const onClose = useCallback((gesture) => {
273
- if (variant === "modal" && gesture === "click-outside") onCancel === null || onCancel === void 0 || onCancel();
274
- if (gesture === "close") {
275
- onCancel === null || onCancel === void 0 || onCancel();
276
- onCancelRequested();
277
- } else onOpenChange(false, gesture);
278
- }, [
279
- onOpenChange,
280
- variant,
281
- onCancel,
282
- onCancelRequested
283
- ]);
284
- const renderMenuAnchor = useMemo(() => {
285
- if (renderAnchor === null) return null;
286
- const selectedItems = Array.isArray(selected) ? selected : [...selected ? [selected] : []];
287
- const selectedValueText = selectedItems.length ? selectedItems.map((item) => item.text).join(", ") : placeholder;
288
- const shouldAutoWireLabel = isReferenced === false && Boolean(labelId) && Boolean(selectedValueId);
289
- return (props) => {
290
- return renderAnchor({
291
- ...props,
292
- ...shouldAutoWireLabel ? { "aria-labelledby": [labelId, selectedValueId].filter(Boolean).join(" ") } : {},
293
- children: shouldAutoWireLabel ? /* @__PURE__ */ jsx("span", {
294
- id: selectedValueId,
295
- children: selectedValueText
296
- }) : selectedValueText
297
- });
298
- };
299
- }, [
300
- placeholder,
301
- renderAnchor,
302
- selected,
303
- isReferenced,
304
- labelId,
305
- selectedValueId
306
- ]);
307
- const selectedItemsSet = useMemo(() => {
308
- const set = /* @__PURE__ */ new Set();
309
- if (isMultiSelectVariant(selected)) for (const item of selected) if (item.id !== void 0) set.add(item.id);
310
- else set.add(item);
311
- return set;
312
- }, [selected]);
313
- const isItemCurrentlySelected = useCallback((item) => {
314
- if (isMultiSelectVariant(selected)) {
315
- if (item.id !== void 0) return selectedItemsSet.has(item.id);
316
- return selectedItemsSet.has(item);
317
- }
318
- if (isSingleSelectModal) return (intermediateSelected === null || intermediateSelected === void 0 ? void 0 : intermediateSelected.id) !== void 0 ? intermediateSelected.id === item.id : intermediateSelected === item;
319
- return (selected === null || selected === void 0 ? void 0 : selected.id) !== void 0 ? selected.id === item.id : selected === item;
320
- }, [
321
- selected,
322
- selectedItemsSet,
323
- intermediateSelected,
324
- isSingleSelectModal
325
- ]);
326
- const itemsToRender = useMemo(() => {
327
- const selectedOnSortSet = /* @__PURE__ */ new Set();
328
- for (const item of selectedOnSort) if (item.id !== void 0) selectedOnSortSet.add(item.id);
329
- else selectedOnSortSet.add(item);
330
- const isSelectedForSort = (item) => {
331
- if (item.id !== void 0) return selectedOnSortSet.has(item.id);
332
- return selectedOnSortSet.has(item);
333
- };
334
- return items.map((item) => {
335
- return {
336
- ...item,
337
- role: "option",
338
- id: item.id,
339
- selected: "selected" in item && item.selected === void 0 ? void 0 : isItemCurrentlySelected(item),
340
- onAction: (itemFromAction, event) => {
341
- var _item$onAction;
342
- (_item$onAction = item.onAction) === null || _item$onAction === void 0 || _item$onAction.call(item, itemFromAction, event);
343
- if (event.defaultPrevented) return;
344
- if (isMultiSelectVariant(selected)) {
345
- const otherSelectedItems = selected.filter((selectedItem) => !areItemsEqual(selectedItem, item));
346
- onSelectedChange(doesItemsIncludeItem(selected, item) ? otherSelectedItems : [...otherSelectedItems, item]);
347
- return;
348
- }
349
- if (isSingleSelectModal) {
350
- if ((intermediateSelected === null || intermediateSelected === void 0 ? void 0 : intermediateSelected.id) === item.id) setIntermediateSelected(void 0);
351
- else setIntermediateSelected(item);
352
- return;
353
- }
354
- onSelectedChange(item === selected ? void 0 : item);
355
- onClose("selection");
356
- }
357
- };
358
- }).sort((itemA, itemB) => {
359
- if (shouldOrderSelectedFirst) {
360
- const itemASelected = isSelectedForSort(itemA);
361
- const itemBSelected = isSelectedForSort(itemB);
362
- if (itemASelected && !itemBSelected) return -1;
363
- else if (!itemASelected && itemBSelected) return 1;
364
- }
365
- return 0;
366
- });
367
- }, [
368
- onClose,
369
- onSelectedChange,
370
- items,
371
- selected,
372
- isItemCurrentlySelected,
373
- isSingleSelectModal,
374
- intermediateSelected,
375
- shouldOrderSelectedFirst,
376
- selectedOnSort
377
- ]);
378
- const prevItemsRef = useRef(items);
379
- useEffect(() => {
380
- if (prevItemsRef.current !== items) {
381
- if (prevItemsRef.current.length === 0 && items.length > 0) resetSort();
382
- prevItemsRef.current = items;
383
- }
384
- }, [items, resetSort]);
385
- const prevOpenRef = useRef(open);
386
- useEffect(() => {
387
- if (prevOpenRef.current !== open) {
388
- resetSort();
389
- prevOpenRef.current = open;
390
- }
391
- }, [open, resetSort]);
392
- const focusTrapSettings = useMemo(() => ({ initialFocusRef: inputRef || void 0 }), [inputRef]);
393
- const extendedTextInputProps = useMemo(() => {
394
- return {
395
- className: SelectPanel_module_css_default.TextInput,
396
- contrast: true,
397
- leadingVisual: SearchIcon,
398
- "aria-label": inputLabel,
399
- ...textInputProps
400
- };
401
- }, [inputLabel, textInputProps]);
402
- const loadingType = () => {
403
- if (dataLoadedOnce) return FilteredActionListLoadingTypes.input;
404
- else if (initialLoadingType === "spinner") return FilteredActionListLoadingTypes.bodySpinner;
405
- else return FilteredActionListLoadingTypes.bodySkeleton;
406
- };
407
- function getMessage() {
408
- if (items.length === 0 && !message) return DefaultEmptyMessage;
409
- else if (message) return /* @__PURE__ */ jsx(SelectPanelMessage, {
410
- title: message.title,
411
- variant: message.variant,
412
- icon: message.icon,
413
- action: message.action,
414
- children: message.body
415
- });
416
- }
417
- const showPermanentCancelSaveButtons = variant === "modal";
418
- const showResponsiveCancelSaveButtons = variant !== "modal" && usingFullScreenOnNarrow && isMultiSelectVariant(selected) && onCancel !== void 0;
419
- const showResponsiveSaveAndCloseButton = variant !== "modal" && usingFullScreenOnNarrow && isMultiSelectVariant(selected) && onCancel === void 0;
420
- const renderFooter = secondaryAction !== void 0 || showPermanentCancelSaveButtons || showResponsiveSaveAndCloseButton || showResponsiveCancelSaveButtons;
421
- const displayFooter = secondaryAction !== void 0 || showPermanentCancelSaveButtons ? "always" : showResponsiveSaveAndCloseButton || showResponsiveCancelSaveButtons ? "only-small" : void 0;
422
- const stretchSecondaryAction = showResponsiveSaveAndCloseButton || showResponsiveCancelSaveButtons ? "only-big" : showPermanentCancelSaveButtons ? "never" : "always";
423
- const stretchSaveButton = showResponsiveSaveAndCloseButton && secondaryAction === void 0 ? "only-small" : "never";
424
- const showXCloseIcon = (onCancel !== void 0 || !isMultiSelectVariant(selected)) && usingFullScreenOnNarrow;
425
- const currentResponsiveVariant = useResponsiveValue(usingFullScreenOnNarrow ? {
426
- regular: "anchored",
427
- narrow: "fullscreen"
428
- } : void 0, "anchored");
429
- const preventBubbling = useCallback((event) => {
430
- var _overlayProps$onKeyDo;
431
- overlayProps === null || overlayProps === void 0 || (_overlayProps$onKeyDo = overlayProps.onKeyDown) == null || _overlayProps$onKeyDo.call(overlayProps, event);
432
- const activeElement = document.activeElement;
433
- if (activeElement.tagName === "INPUT" || activeElement.tagName === "TEXTAREA") return;
434
- if (event.ctrlKey || event.altKey || event.metaKey) return;
435
- if (event.key !== "/" && !isAlphabetKey(event.nativeEvent)) return;
436
- event.stopPropagation();
437
- }, [overlayProps]);
438
- return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(AnchoredOverlay, {
439
- renderAnchor: renderMenuAnchor,
440
- anchorRef,
441
- align,
442
- open,
443
- onOpen,
444
- onClose,
445
- overlayProps: useMemo(() => ({
446
- role: "dialog",
447
- "aria-labelledby": titleId,
448
- "aria-describedby": subtitle ? subtitleId : void 0,
449
- ...overlayProps,
450
- ...variant === "modal" ? {
451
- top: "50vh",
452
- left: "50vw",
453
- anchorSide: void 0
454
- } : {},
455
- style: {
456
- transform: variant === "modal" ? "translate(-50%, -50%)" : void 0,
457
- ...isKeyboardVisible ? { maxHeight: availablePanelHeight !== void 0 ? `${availablePanelHeight}px` : "auto" } : {}
458
- },
459
- onKeyDown: preventBubbling
460
- }), [
461
- titleId,
462
- subtitle,
463
- subtitleId,
464
- overlayProps,
465
- variant,
466
- isKeyboardVisible,
467
- availablePanelHeight,
468
- preventBubbling
469
- ]),
470
- focusTrapSettings,
471
- focusZoneSettings,
472
- height,
473
- width,
474
- anchorId: id,
475
- variant: usingFullScreenOnNarrow ? {
476
- regular: "anchored",
477
- narrow: "fullscreen"
478
- } : void 0,
479
- pinPosition: !height,
480
- className: SelectPanel_module_css_default.Overlay,
481
- displayCloseButton: showXCloseIcon,
482
- closeButtonProps,
483
- displayInViewport,
484
- children: /* @__PURE__ */ jsxs("div", {
485
- className: SelectPanel_module_css_default.Wrapper,
486
- "data-variant": variant,
487
- "data-component": "SelectPanel",
488
- children: [
489
- /* @__PURE__ */ jsxs("div", {
490
- className: SelectPanel_module_css_default.Header,
491
- "data-variant": currentResponsiveVariant,
492
- "data-component": "SelectPanel.Header",
493
- children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx(Heading, {
494
- as: "h1",
495
- id: titleId,
496
- className: SelectPanel_module_css_default.Title,
497
- "data-component": "SelectPanel.Title",
498
- children: title
499
- }), subtitle ? /* @__PURE__ */ jsx("div", {
500
- id: subtitleId,
501
- className: SelectPanel_module_css_default.Subtitle,
502
- "data-component": "SelectPanel.Subtitle",
503
- children: subtitle
504
- }) : null] }), variant === "modal" && !isNarrowScreenSize ? /* @__PURE__ */ jsx(IconButton, {
505
- type: "button",
506
- variant: "invisible",
507
- icon: XIcon,
508
- "aria-label": "Cancel and close",
509
- className: SelectPanel_module_css_default.ResponsiveCloseButton,
510
- "data-component": "SelectPanel.CloseButton",
511
- onClick: () => {
512
- onCancel === null || onCancel === void 0 || onCancel();
513
- onCancelRequested();
514
- }
515
- }) : null]
516
- }),
517
- notice && /* @__PURE__ */ jsx("div", {
518
- ref: noticeRef,
519
- "data-component": "SelectPanel.Notice",
520
- children: /* @__PURE__ */ jsx(Banner, {
521
- variant: notice.variant === "error" ? "critical" : notice.variant,
522
- description: notice.text,
523
- title: "Notice",
524
- hideTitle: true,
525
- className: SelectPanel_module_css_default.Notice,
526
- layout: "compact"
527
- })
528
- }),
529
- /* @__PURE__ */ jsx(FilteredActionList, {
530
- filterValue,
531
- onFilterChange,
532
- onListContainerRefChanged,
533
- onInputRefChanged,
534
- placeholderText,
535
- ...listProps,
536
- variant: (_listProps$groupMetad = listProps.groupMetadata) !== null && _listProps$groupMetad !== void 0 && _listProps$groupMetad.length ? "horizontal-inset" : "inset",
537
- role: "listbox",
538
- "aria-labelledby": listProps["aria-label"] ? void 0 : titleId,
539
- "aria-multiselectable": isMultiSelectVariant(selected) ? "true" : "false",
540
- selectionVariant: isSingleSelectModal ? "radio" : isMultiSelectVariant(selected) ? "multiple" : "single",
541
- items: itemsToRender,
542
- textInputProps: extendedTextInputProps,
543
- loading: loading || isLoading && !message,
544
- loadingType: loadingType(),
545
- onSelectAllChange: showSelectAll ? handleSelectAllChange : void 0,
546
- message: getMessage(),
547
- messageText: {
548
- title: (message === null || message === void 0 ? void 0 : message.title) || EMPTY_MESSAGE.title,
549
- description: typeof (message === null || message === void 0 ? void 0 : message.body) === "string" ? message.body : EMPTY_MESSAGE.description || EMPTY_MESSAGE.description
550
- },
551
- fullScreenOnNarrow: usingFullScreenOnNarrow,
552
- className: clsx(className, SelectPanel_module_css_default.FilteredActionList),
553
- focusPrependedElements,
554
- virtualized
555
- }),
556
- footer ? /* @__PURE__ */ jsx("div", {
557
- className: SelectPanel_module_css_default.Footer,
558
- "data-component": "SelectPanel.Footer",
559
- children: footer
560
- }) : renderFooter ? /* @__PURE__ */ jsxs("div", {
561
- "data-display-footer": displayFooter,
562
- "data-stretch-secondary-action": stretchSecondaryAction,
563
- "data-stretch-save-button": stretchSaveButton,
564
- className: clsx(SelectPanel_module_css_default.Footer, SelectPanel_module_css_default.ResponsiveFooter),
565
- "data-component": "SelectPanel.Footer",
566
- children: [
567
- /* @__PURE__ */ jsx("div", {
568
- "data-stretch-secondary-action": stretchSecondaryAction,
569
- className: SelectPanel_module_css_default.SecondaryAction,
570
- "data-component": "SelectPanel.SecondaryAction",
571
- children: secondaryAction
572
- }),
573
- showPermanentCancelSaveButtons || showResponsiveCancelSaveButtons ? /* @__PURE__ */ jsxs("div", {
574
- "data-stretch-save-button": stretchSaveButton,
575
- className: clsx(SelectPanel_module_css_default.CancelSaveButtons, { [SelectPanel_module_css_default.ResponsiveSaveButton]: showResponsiveCancelSaveButtons }),
576
- children: [/* @__PURE__ */ jsx(ButtonComponent, {
577
- size: "medium",
578
- "data-component": "SelectPanel.CancelButton",
579
- onClick: () => {
580
- onCancel === null || onCancel === void 0 || onCancel();
581
- onCancelRequested();
582
- },
583
- children: "Cancel"
584
- }), /* @__PURE__ */ jsx(ButtonComponent, {
585
- block: onCancel === void 0,
586
- variant: "primary",
587
- size: "medium",
588
- "data-component": "SelectPanel.SaveButton",
589
- onClick: () => {
590
- if (isSingleSelectModal) onSelectedChange(intermediateSelected);
591
- onClose(variant === "modal" ? "selection" : "click-outside");
592
- },
593
- children: "Save"
594
- })]
595
- }) : null,
596
- showResponsiveSaveAndCloseButton ? /* @__PURE__ */ jsx("div", {
597
- className: SelectPanel_module_css_default.ResponsiveSaveButton,
598
- "data-stretch-save-button": stretchSaveButton,
599
- children: /* @__PURE__ */ jsx(ButtonComponent, {
600
- block: true,
601
- variant: "primary",
602
- size: "medium",
603
- "data-component": "SelectPanel.SaveAndCloseButton",
604
- onClick: () => {
605
- onClose("click-outside");
606
- },
607
- children: "Save and close"
608
- })
609
- }) : null
610
- ]
611
- }) : null
612
- ]
613
- })
614
- }), variant === "modal" && open ? /* @__PURE__ */ jsx("div", {
615
- className: SelectPanel_module_css_default.Backdrop,
616
- "data-component": "SelectPanel.Backdrop"
617
- }) : null] });
81
+ function Panel({
82
+ open,
83
+ onOpenChange,
84
+ renderAnchor = defaultRenderAnchor,
85
+ anchorRef: externalAnchorRef,
86
+ placeholder,
87
+ placeholderText = 'Filter items',
88
+ inputLabel = placeholderText,
89
+ selected,
90
+ title = isMultiSelectVariant(selected) ? 'Select items' : 'Select an item',
91
+ subtitle,
92
+ onSelectedChange,
93
+ filterValue: externalFilterValue,
94
+ onFilterChange: externalOnFilterChange,
95
+ items,
96
+ footer,
97
+ textInputProps,
98
+ overlayProps,
99
+ loading,
100
+ initialLoadingType = 'spinner',
101
+ className,
102
+ height,
103
+ width,
104
+ id,
105
+ message,
106
+ notice,
107
+ onCancel,
108
+ variant = 'anchored',
109
+ secondaryAction,
110
+ showSelectedOptionsFirst = true,
111
+ disableFullscreenOnNarrow,
112
+ align,
113
+ showSelectAll = false,
114
+ focusPrependedElements,
115
+ virtualized,
116
+ displayInViewport,
117
+ ...listProps
118
+ }) {
119
+ var _listProps$groupMetad;
120
+ const titleId = useId();
121
+ const subtitleId = useId();
122
+ const [dataLoadedOnce, setDataLoadedOnce] = useState(false);
123
+ const [isLoading, setIsLoading] = useState(false);
124
+ const [filterValue, setInternalFilterValue] = useProvidedStateOrCreate(externalFilterValue, undefined, '');
125
+ const {
126
+ safeSetTimeout,
127
+ safeClearTimeout
128
+ } = useSafeTimeout();
129
+ const loadingDelayTimeoutId = useRef(null);
130
+ const loadingManagedInternally = loading === undefined;
131
+ const loadingManagedExternally = !loadingManagedInternally;
132
+ const [inputRef, setInputRef] = React.useState(null);
133
+ const [listContainerElement, setListContainerElement] = useState(null);
134
+ const [needsNoItemsAnnouncement, setNeedsNoItemsAnnouncement] = useState(false);
135
+ const isNarrowScreenSize = useResponsiveValue({
136
+ narrow: true,
137
+ regular: false,
138
+ wide: false
139
+ }, false);
140
+ const [selectedOnSort, setSelectedOnSort] = useState([]);
141
+ const initialHeightRef = useRef(0);
142
+ const initialScaleRef = useRef(1);
143
+ const noticeRef = useRef(null);
144
+ const [isKeyboardVisible, setIsKeyboardVisible] = useState(false);
145
+ const [availablePanelHeight, setAvailablePanelHeight] = useState(undefined);
146
+ const KEYBOARD_VISIBILITY_THRESHOLD = 10;
147
+ const featureFlagFullScreenOnNarrow = useFeatureFlag('primer_react_select_panel_fullscreen_on_narrow');
148
+ const usingFullScreenOnNarrow = disableFullscreenOnNarrow ? false : featureFlagFullScreenOnNarrow;
149
+ const shouldOrderSelectedFirst = useFeatureFlag('primer_react_select_panel_order_selected_at_top') && showSelectedOptionsFirst;
150
+ const {
151
+ isReferenced,
152
+ labelId
153
+ } = useFormControlContext();
154
+ const selectedValueId = id ? `${id}-selected-value` : undefined;
155
+
156
+ // Single select modals work differently, they have an intermediate state where the user has selected an item but
157
+ // has not yet confirmed the selection. This is the only time the user can cancel the selection.
158
+ const isSingleSelectModal = variant === 'modal' && !isMultiSelectVariant(selected);
159
+ const [intermediateSelected, setIntermediateSelected] = useState(isSingleSelectModal ? selected : undefined);
160
+
161
+ // Reset the intermediate selected item when the panel is open/closed
162
+ useEffect(() => {
163
+ // eslint-disable-next-line react-hooks/set-state-in-effect
164
+ setIntermediateSelected(isSingleSelectModal ? selected : undefined);
165
+ }, [isSingleSelectModal, open, selected]);
166
+ const onListContainerRefChanged = useCallback(node => {
167
+ setListContainerElement(node);
168
+ if (!node && needsNoItemsAnnouncement) {
169
+ setNeedsNoItemsAnnouncement(false);
170
+ }
171
+ }, [needsNoItemsAnnouncement]);
172
+ const onInputRefChanged = useCallback(ref => {
173
+ setInputRef(ref);
174
+ }, [setInputRef]);
175
+ const resetSort = useCallback(() => {
176
+ if (isMultiSelectVariant(selected)) {
177
+ setSelectedOnSort(selected);
178
+ } else if (selected) {
179
+ setSelectedOnSort([selected]);
180
+ } else {
181
+ setSelectedOnSort([]);
182
+ }
183
+ }, [selected]);
184
+ const onFilterChange = useCallback((value, e) => {
185
+ if (loadingManagedInternally) {
186
+ if (loadingDelayTimeoutId.current) {
187
+ safeClearTimeout(loadingDelayTimeoutId.current);
188
+ }
189
+ if (dataLoadedOnce) {
190
+ // If data has already been loaded once, delay the spinner a bit. This also helps
191
+ // not show and then immediately hide the spinner if items are loaded quickly, i.e.
192
+ // not async.
193
+
194
+ loadingDelayTimeoutId.current = safeSetTimeout(() => {
195
+ setIsLoading(true);
196
+ announceLoading();
197
+ }, LONG_DELAY_MS);
198
+ } else {
199
+ // If this is the first data load and there are no items, show the loading spinner
200
+ // immediately
201
+
202
+ if (items.length === 0) {
203
+ setIsLoading(true);
204
+ }
205
+
206
+ // We still want to announce if loading is taking too long
207
+ loadingDelayTimeoutId.current = safeSetTimeout(() => {
208
+ announceLoading();
209
+ }, LONG_DELAY_MS);
210
+ }
211
+ }
212
+ externalOnFilterChange(value, e);
213
+ setInternalFilterValue(value);
214
+ if (!value) {
215
+ resetSort();
216
+ }
217
+ }, [loadingManagedInternally, externalOnFilterChange, setInternalFilterValue, dataLoadedOnce, safeSetTimeout, safeClearTimeout, items.length, resetSort]);
218
+
219
+ // Pre-compute a Set of item IDs in the current filtered view for O(1) lookups
220
+ const itemsInViewSet = useMemo(() => {
221
+ const set = new Set();
222
+ for (const item of items) {
223
+ if (item.id !== undefined) {
224
+ set.add(item.id);
225
+ } else {
226
+ set.add(item);
227
+ }
228
+ }
229
+ return set;
230
+ }, [items]);
231
+ const handleSelectAllChange = useCallback(checked => {
232
+ // Exit early if not in multi-select mode
233
+ if (!isMultiSelectVariant(selected)) {
234
+ return;
235
+ }
236
+ const multiSelectOnChange = onSelectedChange;
237
+ const selectedArray = selected;
238
+
239
+ // Use Set for O(1) lookup instead of O(n) items.some()
240
+ const selectedItemsNotInFilteredView = selectedArray.filter(selectedItem => {
241
+ if (selectedItem.id !== undefined) {
242
+ return !itemsInViewSet.has(selectedItem.id);
243
+ }
244
+ return !itemsInViewSet.has(selectedItem);
245
+ });
246
+ if (checked) {
247
+ multiSelectOnChange([...selectedItemsNotInFilteredView, ...items]);
248
+ } else {
249
+ multiSelectOnChange(selectedItemsNotInFilteredView);
250
+ }
251
+ }, [items, itemsInViewSet, onSelectedChange, selected]);
252
+
253
+ // disable body scroll when the panel is open in modal mode or on narrow screens
254
+ useEffect(() => {
255
+ if (open && (variant === 'modal' || isNarrowScreenSize && usingFullScreenOnNarrow)) {
256
+ const bodyOverflowStyle = document.body.style.overflow || '';
257
+ // If the body is already set to overflow: hidden, it likely means
258
+ // that there is already a modal open. In that case, we should bail
259
+ // so we don't re-enable scroll after the second dialog is closed.
260
+ if (bodyOverflowStyle === 'hidden') {
261
+ return;
262
+ }
263
+ document.body.style.overflow = 'hidden';
264
+ return () => {
265
+ document.body.style.overflow = bodyOverflowStyle;
266
+ };
267
+ }
268
+ }, [isNarrowScreenSize, open, usingFullScreenOnNarrow, variant]);
269
+ useEffect(() => {
270
+ if (open) {
271
+ if (items.length === 0 && !(isLoading || loading)) {
272
+ // we need to wait for the listContainerElement to disappear before announcing no items, otherwise it will be interrupted
273
+ // eslint-disable-next-line react-hooks/set-state-in-effect
274
+ setNeedsNoItemsAnnouncement(true);
275
+ }
276
+ }
277
+ if (loadingManagedExternally) {
278
+ if (items.length > 0) {
279
+ setDataLoadedOnce(true);
280
+ }
281
+ return;
282
+ }
283
+ if (isLoading || items.length > 0) {
284
+ setIsLoading(false);
285
+ setDataLoadedOnce(true);
286
+ }
287
+ if (loadingDelayTimeoutId.current) {
288
+ safeClearTimeout(loadingDelayTimeoutId.current);
289
+ }
290
+
291
+ // Only fire this effect if items have changed
292
+ // eslint-disable-next-line react-hooks/exhaustive-deps
293
+ }, [items]);
294
+ useEffect(() => {
295
+ if (inputRef !== null && inputRef !== void 0 && inputRef.current) {
296
+ const ref = inputRef.current;
297
+
298
+ // We would normally expect AnchoredOverlay's focus trap to automatically focus the input,
299
+ // but for some reason the ref isn't populated until _after_ the panel is open, which is
300
+ // too late. So, we focus manually here.
301
+ if (open) {
302
+ ref.focus();
303
+ }
304
+ }
305
+ }, [inputRef, open]);
306
+
307
+ // Manage loading announcements when loadingManagedExternally
308
+ useEffect(() => {
309
+ if (loadingManagedExternally) {
310
+ if (isLoading) {
311
+ // Delay the announcement a bit, just in case the loading is quick
312
+ loadingDelayTimeoutId.current = safeSetTimeout(() => {
313
+ announceLoading();
314
+ }, LONG_DELAY_MS);
315
+ } else {
316
+ // If loading is done, we can clear the loading announcement
317
+ if (loadingDelayTimeoutId.current) {
318
+ safeClearTimeout(loadingDelayTimeoutId.current);
319
+ }
320
+ }
321
+ }
322
+ }, [isLoading, loadingManagedExternally, safeSetTimeout, safeClearTimeout]);
323
+
324
+ // Populate panel with items on first open
325
+ useEffect(() => {
326
+ if (loadingManagedExternally) return;
327
+
328
+ // If data was already loaded once, do nothing
329
+ if (dataLoadedOnce) return;
330
+
331
+ // Only load data when the panel is open
332
+ if (open) {
333
+ // Only trigger filter change event if there are no items
334
+ if (items.length === 0) {
335
+ // Trigger filter event to populate panel on first open
336
+ // eslint-disable-next-line react-hooks/set-state-in-effect
337
+ onFilterChange(filterValue, null);
338
+ }
339
+ }
340
+ }, [open, dataLoadedOnce, onFilterChange, filterValue, items, loadingManagedExternally, listContainerElement]);
341
+ useEffect(() => {
342
+ if (!window.visualViewport || !open || !isNarrowScreenSize) {
343
+ return;
344
+ }
345
+ initialHeightRef.current = window.visualViewport.height;
346
+ initialScaleRef.current = window.visualViewport.scale;
347
+ const handleViewportChange = debounce(() => {
348
+ if (window.visualViewport) {
349
+ const currentScale = window.visualViewport.scale;
350
+ const isZooming = currentScale !== initialScaleRef.current;
351
+ if (!isZooming) {
352
+ const currentHeight = window.visualViewport.height;
353
+ const keyboardVisible = initialHeightRef.current - currentHeight > KEYBOARD_VISIBILITY_THRESHOLD;
354
+ setIsKeyboardVisible(keyboardVisible);
355
+ setAvailablePanelHeight(keyboardVisible ? currentHeight : undefined);
356
+ }
357
+ }
358
+ }, 100);
359
+
360
+ // keeping this check to satisfy typescript but need eslint to ignore redundancy rule
361
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
362
+ if (window.visualViewport) {
363
+ // Using visualViewport to more reliably detect viewport changes across different browsers, which specifically requires these listeners
364
+ // eslint-disable-next-line github/prefer-observers
365
+ window.visualViewport.addEventListener('resize', handleViewportChange);
366
+ // eslint-disable-next-line github/prefer-observers
367
+ window.visualViewport.addEventListener('scroll', handleViewportChange);
368
+ }
369
+ return () => {
370
+ if (window.visualViewport) {
371
+ window.visualViewport.removeEventListener('resize', handleViewportChange);
372
+ window.visualViewport.removeEventListener('scroll', handleViewportChange);
373
+ }
374
+ handleViewportChange.cancel();
375
+ };
376
+ }, [open, isNarrowScreenSize]);
377
+ useEffect(() => {
378
+ const announceNotice = async () => {
379
+ if (!noticeRef.current) return;
380
+ const liveRegion = document.querySelector('live-region');
381
+ liveRegion === null || liveRegion === void 0 ? void 0 : liveRegion.clear();
382
+ await announceFromElement(noticeRef.current, {
383
+ from: liveRegion ? liveRegion : undefined
384
+ });
385
+ };
386
+ if (open && notice) {
387
+ announceNotice();
388
+ }
389
+ }, [notice, open]);
390
+ const anchorRef = useProvidedRefOrCreate(externalAnchorRef);
391
+ const onOpen = useCallback(gesture => onOpenChange(true, gesture), [onOpenChange]);
392
+ const onCancelRequested = useCallback(() => {
393
+ onOpenChange(false, 'cancel');
394
+ }, [onOpenChange]);
395
+ const onClose = useCallback(gesture => {
396
+ // Clicking outside should cancel the selection only on modals
397
+ if (variant === 'modal' && gesture === 'click-outside') {
398
+ onCancel === null || onCancel === void 0 ? void 0 : onCancel();
399
+ }
400
+ if (gesture === 'close') {
401
+ onCancel === null || onCancel === void 0 ? void 0 : onCancel();
402
+ onCancelRequested();
403
+ } else {
404
+ onOpenChange(false, gesture);
405
+ }
406
+ }, [onOpenChange, variant, onCancel, onCancelRequested]);
407
+ const renderMenuAnchor = useMemo(() => {
408
+ if (renderAnchor === null) {
409
+ return null;
410
+ }
411
+ const selectedItems = Array.isArray(selected) ? selected : [...(selected ? [selected] : [])];
412
+ const selectedValueText = selectedItems.length ? selectedItems.map(item => item.text).join(', ') : placeholder;
413
+ const shouldAutoWireLabel = isReferenced === false && Boolean(labelId) && Boolean(selectedValueId);
414
+ return props => {
415
+ return renderAnchor({
416
+ ...props,
417
+ ...(shouldAutoWireLabel ? {
418
+ 'aria-labelledby': [labelId, selectedValueId].filter(Boolean).join(' ')
419
+ } : {}),
420
+ children: shouldAutoWireLabel ? /*#__PURE__*/jsx("span", {
421
+ id: selectedValueId,
422
+ children: selectedValueText
423
+ }) : selectedValueText
424
+ });
425
+ };
426
+ }, [placeholder, renderAnchor, selected, isReferenced, labelId, selectedValueId]);
427
+
428
+ // Pre-compute a Set of selected item IDs/references for O(1) lookups
429
+ // This optimizes isItemCurrentlySelected from O(m) to O(1) per call
430
+ const selectedItemsSet = useMemo(() => {
431
+ const set = new Set();
432
+ if (isMultiSelectVariant(selected)) {
433
+ for (const item of selected) {
434
+ if (item.id !== undefined) {
435
+ set.add(item.id);
436
+ } else {
437
+ set.add(item);
438
+ }
439
+ }
440
+ }
441
+ return set;
442
+ }, [selected]);
443
+ const isItemCurrentlySelected = useCallback(item => {
444
+ // For multi-select, use the pre-computed Set for O(1) lookup
445
+ if (isMultiSelectVariant(selected)) {
446
+ if (item.id !== undefined) {
447
+ return selectedItemsSet.has(item.id);
448
+ }
449
+ return selectedItemsSet.has(item);
450
+ }
451
+
452
+ // For single-select modal, there is an intermediate state when the user has selected
453
+ // an item but has not yet saved the selection. We need to check for this state.
454
+ if (isSingleSelectModal) {
455
+ return (intermediateSelected === null || intermediateSelected === void 0 ? void 0 : intermediateSelected.id) !== undefined ? intermediateSelected.id === item.id : intermediateSelected === item;
456
+ }
457
+
458
+ // For single-select anchored, we just need to check if the item is the selected item
459
+ return (selected === null || selected === void 0 ? void 0 : selected.id) !== undefined ? selected.id === item.id : selected === item;
460
+ }, [selected, selectedItemsSet, intermediateSelected, isSingleSelectModal]);
461
+ const itemsToRender = useMemo(() => {
462
+ // Pre-compute a Set of selected item IDs/references for O(1) lookups during sorting
463
+ // This avoids O(m * k) work per comparison in the sort function
464
+ const selectedOnSortSet = new Set();
465
+ for (const item of selectedOnSort) {
466
+ if (item.id !== undefined) {
467
+ selectedOnSortSet.add(item.id);
468
+ } else {
469
+ selectedOnSortSet.add(item);
470
+ }
471
+ }
472
+ const isSelectedForSort = item => {
473
+ if (item.id !== undefined) {
474
+ return selectedOnSortSet.has(item.id);
475
+ }
476
+ return selectedOnSortSet.has(item);
477
+ };
478
+ return items.map(item => {
479
+ return {
480
+ ...item,
481
+ role: 'option',
482
+ id: item.id,
483
+ selected: 'selected' in item && item.selected === undefined ? undefined : isItemCurrentlySelected(item),
484
+ onAction: (itemFromAction, event) => {
485
+ var _item$onAction;
486
+ (_item$onAction = item.onAction) === null || _item$onAction === void 0 ? void 0 : _item$onAction.call(item, itemFromAction, event);
487
+ if (event.defaultPrevented) {
488
+ return;
489
+ }
490
+ if (isMultiSelectVariant(selected)) {
491
+ const otherSelectedItems = selected.filter(selectedItem => !areItemsEqual(selectedItem, item));
492
+ const newSelectedItems = doesItemsIncludeItem(selected, item) ? otherSelectedItems : [...otherSelectedItems, item];
493
+ const multiSelectOnChange = onSelectedChange;
494
+ multiSelectOnChange(newSelectedItems);
495
+ return;
496
+ }
497
+ if (isSingleSelectModal) {
498
+ if ((intermediateSelected === null || intermediateSelected === void 0 ? void 0 : intermediateSelected.id) === item.id) {
499
+ // if the item is already selected, we need to unselect it
500
+ setIntermediateSelected(undefined);
501
+ } else {
502
+ setIntermediateSelected(item);
503
+ }
504
+ return;
505
+ }
506
+ // single select anchored, direct save on click
507
+ const singleSelectOnChange = onSelectedChange;
508
+ singleSelectOnChange(item === selected ? undefined : item);
509
+ onClose('selection');
510
+ }
511
+ };
512
+ }).sort((itemA, itemB) => {
513
+ if (shouldOrderSelectedFirst) {
514
+ const itemASelected = isSelectedForSort(itemA);
515
+ const itemBSelected = isSelectedForSort(itemB);
516
+
517
+ // order selected items first
518
+ if (itemASelected && !itemBSelected) {
519
+ return -1;
520
+ } else if (!itemASelected && itemBSelected) {
521
+ return 1;
522
+ }
523
+ }
524
+ return 0;
525
+ });
526
+ }, [onClose, onSelectedChange, items, selected, isItemCurrentlySelected, isSingleSelectModal, intermediateSelected, shouldOrderSelectedFirst, selectedOnSort]);
527
+
528
+ // Track previous items and reset sort when items first load
529
+ const prevItemsRef = useRef(items);
530
+ useEffect(() => {
531
+ if (prevItemsRef.current !== items) {
532
+ if (prevItemsRef.current.length === 0 && items.length > 0) {
533
+ resetSort();
534
+ }
535
+ prevItemsRef.current = items;
536
+ }
537
+ }, [items, resetSort]);
538
+
539
+ // Reset sort when panel opens
540
+ const prevOpenRef = useRef(open);
541
+ useEffect(() => {
542
+ if (prevOpenRef.current !== open) {
543
+ resetSort();
544
+ prevOpenRef.current = open;
545
+ }
546
+ }, [open, resetSort]);
547
+ const focusTrapSettings = useMemo(() => ({
548
+ initialFocusRef: inputRef || undefined
549
+ }), [inputRef]);
550
+ const extendedTextInputProps = useMemo(() => {
551
+ return {
552
+ className: classes.TextInput,
553
+ contrast: true,
554
+ leadingVisual: SearchIcon,
555
+ 'aria-label': inputLabel,
556
+ ...textInputProps
557
+ };
558
+ }, [inputLabel, textInputProps]);
559
+ const loadingType = () => {
560
+ if (dataLoadedOnce) {
561
+ return FilteredActionListLoadingTypes.input;
562
+ } else {
563
+ if (initialLoadingType === 'spinner') {
564
+ return FilteredActionListLoadingTypes.bodySpinner;
565
+ } else {
566
+ return FilteredActionListLoadingTypes.bodySkeleton;
567
+ }
568
+ }
569
+ };
570
+ function getMessage() {
571
+ if (items.length === 0 && !message) {
572
+ return DefaultEmptyMessage;
573
+ } else if (message) {
574
+ return /*#__PURE__*/jsx(SelectPanelMessage, {
575
+ title: message.title,
576
+ variant: message.variant,
577
+ icon: message.icon,
578
+ action: message.action,
579
+ children: message.body
580
+ });
581
+ }
582
+ }
583
+
584
+ // We add permanent save and cancel buttons on:
585
+ // - modals
586
+ const showPermanentCancelSaveButtons = variant === 'modal';
587
+
588
+ // The next two could be collapsed, left them separate for readability
589
+
590
+ // We add a responsive save and cancel button on:
591
+ // - anchored panels with multi select if there is onCancel
592
+ const showResponsiveCancelSaveButtons = variant !== 'modal' && usingFullScreenOnNarrow && isMultiSelectVariant(selected) && onCancel !== undefined;
593
+
594
+ // The responsive save and close button is only covering a very specific case:
595
+ // - anchored panel with multi select if there is no onCancel.
596
+ // This variant should disappear in the future, once onCancel is required,
597
+ // but for now we need to support it so there is a user friendly way to close the panel.
598
+ const showResponsiveSaveAndCloseButton = variant !== 'modal' && usingFullScreenOnNarrow && isMultiSelectVariant(selected) && onCancel === undefined;
599
+
600
+ // If there is any element in the footer, we render it.
601
+ const renderFooter = secondaryAction !== undefined || showPermanentCancelSaveButtons || showResponsiveSaveAndCloseButton || showResponsiveCancelSaveButtons;
602
+
603
+ // If there's any permanent elements in the footer, we show it always.
604
+ // The save button is only shown on small screens.
605
+ const displayFooter = secondaryAction !== undefined || showPermanentCancelSaveButtons ? 'always' : showResponsiveSaveAndCloseButton || showResponsiveCancelSaveButtons ? 'only-small' : undefined;
606
+ const stretchSecondaryAction = showResponsiveSaveAndCloseButton || showResponsiveCancelSaveButtons ? 'only-big' : showPermanentCancelSaveButtons ? 'never' : 'always';
607
+ const stretchSaveButton = showResponsiveSaveAndCloseButton && secondaryAction === undefined ? 'only-small' : 'never';
608
+
609
+ /*
610
+ * SelectPanel uses two close button implementations for different use cases:
611
+ *
612
+ * 1. AnchoredOverlay close button - Enabled on narrow screens (showXCloseIcon logic)
613
+ *
614
+ * 2. SelectPanel modal close button - Used for modal variant on wider screens
615
+ * (variant === 'modal' && !isNarrowScreenSize logic below)
616
+ *
617
+ * The dual approach handles different responsive behaviors: AnchoredOverlay manages
618
+ * close functionality for narrow fullscreen, while SelectPanel handles modal close on desktop.
619
+ */
620
+ const showXCloseIcon = (onCancel !== undefined || !isMultiSelectVariant(selected)) && usingFullScreenOnNarrow;
621
+ const currentResponsiveVariant = useResponsiveValue(usingFullScreenOnNarrow ? {
622
+ regular: 'anchored',
623
+ narrow: 'fullscreen'
624
+ } : undefined, 'anchored');
625
+ const preventBubbling = useCallback(event => {
626
+ var _overlayProps$onKeyDo;
627
+ overlayProps === null || overlayProps === void 0 ? void 0 : (_overlayProps$onKeyDo = overlayProps.onKeyDown) === null || _overlayProps$onKeyDo === void 0 ? void 0 : _overlayProps$onKeyDo.call(overlayProps, event);
628
+
629
+ // skip if a TextInput has focus
630
+ const activeElement = document.activeElement;
631
+ if (activeElement.tagName === 'INPUT' || activeElement.tagName === 'TEXTAREA') return;
632
+
633
+ // skip if used with modifier to preserve shortcuts like ⌘ + F
634
+ const hasModifier = event.ctrlKey || event.altKey || event.metaKey;
635
+ if (hasModifier) return;
636
+
637
+ // skip if it's not the forward slash or an alphabet key
638
+ if (event.key !== '/' && !isAlphabetKey(event.nativeEvent)) {
639
+ return;
640
+ }
641
+
642
+ // if this is a typeahead event, don't propagate outside of menu
643
+ event.stopPropagation();
644
+ }, [overlayProps]);
645
+ const mergedOverlayProps = useMemo(() => ({
646
+ role: 'dialog',
647
+ 'aria-labelledby': titleId,
648
+ 'aria-describedby': subtitle ? subtitleId : undefined,
649
+ ...overlayProps,
650
+ ...(variant === 'modal' ? {
651
+ top: '50vh',
652
+ left: '50vw',
653
+ anchorSide: undefined
654
+ } : {}),
655
+ style: {
656
+ transform: variant === 'modal' ? 'translate(-50%, -50%)' : undefined,
657
+ ...(isKeyboardVisible ? {
658
+ maxHeight: availablePanelHeight !== undefined ? `${availablePanelHeight}px` : 'auto'
659
+ } : {})
660
+ },
661
+ onKeyDown: preventBubbling
662
+ }), [titleId, subtitle, subtitleId, overlayProps, variant, isKeyboardVisible, availablePanelHeight, preventBubbling]);
663
+ return /*#__PURE__*/jsxs(Fragment, {
664
+ children: [/*#__PURE__*/jsx(AnchoredOverlay, {
665
+ renderAnchor: renderMenuAnchor,
666
+ anchorRef: anchorRef,
667
+ align: align,
668
+ open: open,
669
+ onOpen: onOpen,
670
+ onClose: onClose,
671
+ overlayProps: mergedOverlayProps,
672
+ focusTrapSettings: focusTrapSettings,
673
+ focusZoneSettings: focusZoneSettings,
674
+ height: height,
675
+ width: width,
676
+ anchorId: id,
677
+ variant: usingFullScreenOnNarrow ? {
678
+ regular: 'anchored',
679
+ narrow: 'fullscreen'
680
+ } : undefined,
681
+ pinPosition: !height,
682
+ className: classes.Overlay,
683
+ displayCloseButton: showXCloseIcon,
684
+ closeButtonProps: closeButtonProps,
685
+ displayInViewport: displayInViewport,
686
+ children: /*#__PURE__*/jsxs("div", {
687
+ className: classes.Wrapper,
688
+ "data-variant": variant,
689
+ "data-component": "SelectPanel",
690
+ children: [/*#__PURE__*/jsxs("div", {
691
+ className: classes.Header,
692
+ "data-variant": currentResponsiveVariant,
693
+ "data-component": "SelectPanel.Header",
694
+ children: [/*#__PURE__*/jsxs("div", {
695
+ children: [/*#__PURE__*/jsx(Heading, {
696
+ as: "h1",
697
+ id: titleId,
698
+ className: classes.Title,
699
+ "data-component": "SelectPanel.Title",
700
+ children: title
701
+ }), subtitle ? /*#__PURE__*/jsx("div", {
702
+ id: subtitleId,
703
+ className: classes.Subtitle,
704
+ "data-component": "SelectPanel.Subtitle",
705
+ children: subtitle
706
+ }) : null]
707
+ }), variant === 'modal' && !isNarrowScreenSize ? /*#__PURE__*/jsx(IconButton, {
708
+ type: "button",
709
+ variant: "invisible",
710
+ icon: XIcon,
711
+ "aria-label": "Cancel and close",
712
+ className: classes.ResponsiveCloseButton,
713
+ "data-component": "SelectPanel.CloseButton",
714
+ onClick: () => {
715
+ onCancel === null || onCancel === void 0 ? void 0 : onCancel();
716
+ onCancelRequested();
717
+ }
718
+ }) : null]
719
+ }), notice && /*#__PURE__*/jsx("div", {
720
+ ref: noticeRef,
721
+ "data-component": "SelectPanel.Notice",
722
+ children: /*#__PURE__*/jsx(Banner, {
723
+ variant: notice.variant === 'error' ? 'critical' : notice.variant,
724
+ description: notice.text,
725
+ title: "Notice",
726
+ hideTitle: true,
727
+ className: classes.Notice,
728
+ layout: "compact"
729
+ })
730
+ }), /*#__PURE__*/jsx(FilteredActionList, {
731
+ filterValue: filterValue,
732
+ onFilterChange: onFilterChange,
733
+ onListContainerRefChanged: onListContainerRefChanged
734
+ // @ts-expect-error it needs a non nullable ref
735
+ ,
736
+ onInputRefChanged: onInputRefChanged,
737
+ placeholderText: placeholderText,
738
+ ...listProps,
739
+ variant: (_listProps$groupMetad = listProps.groupMetadata) !== null && _listProps$groupMetad !== void 0 && _listProps$groupMetad.length ? 'horizontal-inset' : 'inset',
740
+ role: "listbox"
741
+ // browsers give aria-labelledby precedence over aria-label so we need to make sure
742
+ // we don't accidentally override props.aria-label
743
+ ,
744
+ "aria-labelledby": listProps['aria-label'] ? undefined : titleId,
745
+ "aria-multiselectable": isMultiSelectVariant(selected) ? 'true' : 'false',
746
+ selectionVariant: isSingleSelectModal ? 'radio' : isMultiSelectVariant(selected) ? 'multiple' : 'single',
747
+ items: itemsToRender,
748
+ textInputProps: extendedTextInputProps,
749
+ loading: loading || isLoading && !message,
750
+ loadingType: loadingType(),
751
+ onSelectAllChange: showSelectAll ? handleSelectAllChange : undefined
752
+ // hack because the deprecated ActionList does not support this prop
753
+ ,
754
+ message: getMessage(),
755
+ messageText: {
756
+ title: (message === null || message === void 0 ? void 0 : message.title) || EMPTY_MESSAGE.title,
757
+ description: typeof (message === null || message === void 0 ? void 0 : message.body) === 'string' ? message.body : EMPTY_MESSAGE.description
758
+ },
759
+ fullScreenOnNarrow: usingFullScreenOnNarrow,
760
+ className: clsx(className, classes.FilteredActionList),
761
+ focusPrependedElements: focusPrependedElements,
762
+ virtualized: virtualized
763
+ }), footer ? /*#__PURE__*/jsx("div", {
764
+ className: classes.Footer,
765
+ "data-component": "SelectPanel.Footer",
766
+ children: footer
767
+ }) : renderFooter ? /*#__PURE__*/jsxs("div", {
768
+ "data-display-footer": displayFooter,
769
+ "data-stretch-secondary-action": stretchSecondaryAction,
770
+ "data-stretch-save-button": stretchSaveButton,
771
+ className: clsx(classes.Footer, classes.ResponsiveFooter),
772
+ "data-component": "SelectPanel.Footer",
773
+ children: [/*#__PURE__*/jsx("div", {
774
+ "data-stretch-secondary-action": stretchSecondaryAction,
775
+ className: classes.SecondaryAction,
776
+ "data-component": "SelectPanel.SecondaryAction",
777
+ children: secondaryAction
778
+ }), showPermanentCancelSaveButtons || showResponsiveCancelSaveButtons ? /*#__PURE__*/jsxs("div", {
779
+ "data-stretch-save-button": stretchSaveButton,
780
+ className: clsx(classes.CancelSaveButtons, {
781
+ [classes.ResponsiveSaveButton]: showResponsiveCancelSaveButtons
782
+ }),
783
+ children: [/*#__PURE__*/jsx(ButtonComponent, {
784
+ size: "medium",
785
+ "data-component": "SelectPanel.CancelButton",
786
+ onClick: () => {
787
+ onCancel === null || onCancel === void 0 ? void 0 : onCancel();
788
+ onCancelRequested();
789
+ },
790
+ children: "Cancel"
791
+ }), /*#__PURE__*/jsx(ButtonComponent, {
792
+ block: onCancel === undefined,
793
+ variant: "primary",
794
+ size: "medium",
795
+ "data-component": "SelectPanel.SaveButton",
796
+ onClick: () => {
797
+ if (isSingleSelectModal) {
798
+ const singleSelectOnChange = onSelectedChange;
799
+ singleSelectOnChange(intermediateSelected);
800
+ }
801
+ onClose(variant === 'modal' ? 'selection' : 'click-outside');
802
+ },
803
+ children: "Save"
804
+ })]
805
+ }) : null, showResponsiveSaveAndCloseButton ? /*#__PURE__*/jsx("div", {
806
+ className: classes.ResponsiveSaveButton,
807
+ "data-stretch-save-button": stretchSaveButton,
808
+ children: /*#__PURE__*/jsx(ButtonComponent, {
809
+ block: true,
810
+ variant: "primary",
811
+ size: "medium",
812
+ "data-component": "SelectPanel.SaveAndCloseButton",
813
+ onClick: () => {
814
+ onClose('click-outside');
815
+ },
816
+ children: "Save and close"
817
+ })
818
+ }) : null]
819
+ }) : null]
820
+ })
821
+ }), variant === 'modal' && open ? /*#__PURE__*/jsx("div", {
822
+ className: classes.Backdrop,
823
+ "data-component": "SelectPanel.Backdrop"
824
+ }) : null]
825
+ });
618
826
  }
619
- const SecondaryButton = (props) => {
620
- return /* @__PURE__ */ jsx(ButtonComponent, {
621
- block: true,
622
- "data-component": "SelectPanel.SecondaryActionButton",
623
- ...props,
624
- children: props.children
625
- });
827
+ const SecondaryButton = props => {
828
+ return /*#__PURE__*/jsx(ButtonComponent, {
829
+ block: true,
830
+ "data-component": "SelectPanel.SecondaryActionButton",
831
+ ...props,
832
+ children: props.children
833
+ });
626
834
  };
627
835
  SecondaryButton.displayName = "SecondaryButton";
628
- const SecondaryLink = (props) => {
629
- return /* @__PURE__ */ jsx(LinkButton, {
630
- ...props,
631
- variant: "invisible",
632
- block: true,
633
- "data-component": "SelectPanel.SecondaryActionLink",
634
- children: props.children
635
- });
836
+ const SecondaryLink = props => {
837
+ return /*#__PURE__*/jsx(LinkButton, {
838
+ ...props,
839
+ variant: "invisible",
840
+ block: true,
841
+ "data-component": "SelectPanel.SecondaryActionLink",
842
+ children: props.children
843
+ });
636
844
  };
637
845
  SecondaryLink.displayName = "SecondaryLink";
638
846
  const SelectPanel = Object.assign(Panel, {
639
- __SLOT__: Symbol("SelectPanel"),
640
- SecondaryActionButton: SecondaryButton,
641
- SecondaryActionLink: SecondaryLink
847
+ __SLOT__: Symbol('SelectPanel'),
848
+ SecondaryActionButton: SecondaryButton,
849
+ SecondaryActionLink: SecondaryLink,
850
+ Message: SelectPanelMessage
642
851
  });
643
- //#endregion
852
+
644
853
  export { SelectPanel };