@astryxdesign/core 0.7.7-canary.ae97fa8 → 0.7.7-canary.b377b21

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 (228) hide show
  1. package/dist/AlertDialog/AlertDialog.d.ts +4 -1
  2. package/dist/AlertDialog/AlertDialog.d.ts.map +1 -1
  3. package/dist/AlertDialog/AlertDialog.js +36 -6
  4. package/dist/BottomSheet/BottomSheetPanel.d.ts.map +1 -1
  5. package/dist/BottomSheet/BottomSheetPanel.js +22 -3
  6. package/dist/BottomSheet/useSheetGestures.d.ts.map +1 -1
  7. package/dist/BottomSheet/useSheetGestures.js +3 -1
  8. package/dist/Button/Button.d.ts.map +1 -1
  9. package/dist/Button/Button.js +17 -1
  10. package/dist/CheckboxInput/CheckboxInput.d.ts.map +1 -1
  11. package/dist/CheckboxInput/CheckboxInput.js +13 -2
  12. package/dist/ComplexSelector/ComplexSelector.d.ts +4 -1
  13. package/dist/ComplexSelector/ComplexSelector.d.ts.map +1 -1
  14. package/dist/ComplexSelector/ComplexSelector.js +14 -4
  15. package/dist/ContextMenu/ContextMenu.js +2 -2
  16. package/dist/Dialog/Dialog.d.ts.map +1 -1
  17. package/dist/Dialog/Dialog.js +7 -31
  18. package/dist/Field/Field.js +2 -2
  19. package/dist/HoverCard/HoverCard.d.ts +4 -3
  20. package/dist/HoverCard/HoverCard.d.ts.map +1 -1
  21. package/dist/HoverCard/useHoverCard.d.ts +5 -4
  22. package/dist/HoverCard/useHoverCard.d.ts.map +1 -1
  23. package/dist/HoverCard/useHoverCard.js +17 -31
  24. package/dist/Icon/Icon.d.ts +5 -1
  25. package/dist/Icon/Icon.d.ts.map +1 -1
  26. package/dist/Icon/Icon.js +5 -2
  27. package/dist/Layer/usePressPin.d.ts +17 -5
  28. package/dist/Layer/usePressPin.d.ts.map +1 -1
  29. package/dist/Layer/usePressPin.js +62 -12
  30. package/dist/Lightbox/Lightbox.d.ts.map +1 -1
  31. package/dist/Lightbox/Lightbox.js +18 -0
  32. package/dist/PowerSearch/PowerSearch.d.ts +36 -3
  33. package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
  34. package/dist/PowerSearch/PowerSearch.js +433 -127
  35. package/dist/PowerSearch/PowerSearchBottomSheet.d.ts +100 -0
  36. package/dist/PowerSearch/PowerSearchBottomSheet.d.ts.map +1 -0
  37. package/dist/PowerSearch/PowerSearchBottomSheet.js +1913 -0
  38. package/dist/PowerSearch/PowerSearchEditPopover.d.ts +32 -1
  39. package/dist/PowerSearch/PowerSearchEditPopover.d.ts.map +1 -1
  40. package/dist/PowerSearch/PowerSearchEditPopover.js +17 -6
  41. package/dist/PowerSearch/PowerSearchValueEditor.d.ts +38 -3
  42. package/dist/PowerSearch/PowerSearchValueEditor.d.ts.map +1 -1
  43. package/dist/PowerSearch/PowerSearchValueEditor.js +170 -61
  44. package/dist/PowerSearch/formatFilterValue.d.ts +7 -0
  45. package/dist/PowerSearch/formatFilterValue.d.ts.map +1 -1
  46. package/dist/PowerSearch/formatFilterValue.js +11 -1
  47. package/dist/PowerSearch/formatTokenValue.d.ts +28 -0
  48. package/dist/PowerSearch/formatTokenValue.d.ts.map +1 -0
  49. package/dist/PowerSearch/formatTokenValue.js +160 -0
  50. package/dist/PowerSearch/powerSearchSheetUtils.d.ts +65 -0
  51. package/dist/PowerSearch/powerSearchSheetUtils.d.ts.map +1 -0
  52. package/dist/PowerSearch/powerSearchSheetUtils.js +168 -0
  53. package/dist/RadioList/RadioList.d.ts.map +1 -1
  54. package/dist/RadioList/RadioList.js +3 -2
  55. package/dist/RadioList/RadioListItem.d.ts +1 -1
  56. package/dist/RadioList/RadioListItem.d.ts.map +1 -1
  57. package/dist/RadioList/RadioListItem.js +5 -3
  58. package/dist/Resizable/ResizeHandle.d.ts +2 -1
  59. package/dist/Resizable/ResizeHandle.d.ts.map +1 -1
  60. package/dist/Resizable/ResizeHandle.js +99 -77
  61. package/dist/SegmentedControl/useSegmentedSelectionMotion.d.ts.map +1 -1
  62. package/dist/SegmentedControl/useSegmentedSelectionMotion.js +3 -3
  63. package/dist/Slider/sliderTouchController.js +2 -2
  64. package/dist/Spinner/Spinner.d.ts +1 -1
  65. package/dist/Spinner/Spinner.d.ts.map +1 -1
  66. package/dist/Spinner/Spinner.js +60 -58
  67. package/dist/Switch/useSwitchTouch.js +4 -4
  68. package/dist/Table/BaseTable.d.ts.map +1 -1
  69. package/dist/Table/BaseTable.js +29 -8
  70. package/dist/TextInput/TextInput.d.ts +2 -2
  71. package/dist/TextInput/TextInput.d.ts.map +1 -1
  72. package/dist/TextInput/TextInput.js +10 -7
  73. package/dist/Toast/Toast.d.ts +11 -1
  74. package/dist/Toast/Toast.d.ts.map +1 -1
  75. package/dist/Toast/Toast.js +25 -15
  76. package/dist/Toast/ToastViewport.d.ts.map +1 -1
  77. package/dist/Toast/ToastViewport.js +94 -34
  78. package/dist/Toast/types.d.ts +9 -3
  79. package/dist/Toast/types.d.ts.map +1 -1
  80. package/dist/Tooltip/useTooltip.d.ts +19 -1
  81. package/dist/Tooltip/useTooltip.d.ts.map +1 -1
  82. package/dist/Tooltip/useTooltip.js +34 -53
  83. package/dist/Typeahead/TypeaheadItem.d.ts +2 -1
  84. package/dist/Typeahead/TypeaheadItem.d.ts.map +1 -1
  85. package/dist/animator/createAnimator.d.ts +98 -0
  86. package/dist/animator/createAnimator.d.ts.map +1 -0
  87. package/dist/animator/createAnimator.js +259 -0
  88. package/dist/astryx.css +35 -6
  89. package/dist/gestures/PressTracker.d.ts.map +1 -1
  90. package/dist/gestures/PressTracker.js +4 -3
  91. package/dist/hooks/actionGroupTracker.d.ts +4 -1
  92. package/dist/hooks/actionGroupTracker.d.ts.map +1 -1
  93. package/dist/hooks/actionGroupTracker.js +13 -3
  94. package/dist/hooks/index.d.ts +1 -0
  95. package/dist/hooks/index.d.ts.map +1 -1
  96. package/dist/hooks/index.js +1 -0
  97. package/dist/hooks/pressGroupContext.d.ts +6 -0
  98. package/dist/hooks/pressGroupContext.d.ts.map +1 -0
  99. package/dist/hooks/pressGroupContext.js +20 -0
  100. package/dist/hooks/useActionGroupTracking.d.ts +53 -0
  101. package/dist/hooks/useActionGroupTracking.d.ts.map +1 -0
  102. package/dist/hooks/useActionGroupTracking.js +174 -0
  103. package/dist/hooks/useAnimator.d.ts +41 -0
  104. package/dist/hooks/useAnimator.d.ts.map +1 -0
  105. package/dist/hooks/useAnimator.js +70 -0
  106. package/dist/hooks/useAttachment.d.ts +1 -1
  107. package/dist/hooks/useAttachment.js +1 -1
  108. package/dist/hooks/useInputStatusIcon.d.ts +1 -1
  109. package/dist/hooks/useInputStatusIcon.d.ts.map +1 -1
  110. package/dist/hooks/useInputStatusIcon.js +2 -2
  111. package/dist/hooks/useLongPress.d.ts +6 -2
  112. package/dist/hooks/useLongPress.d.ts.map +1 -1
  113. package/dist/hooks/useLongPress.js +95 -15
  114. package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.d.ts +8 -0
  115. package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.d.ts.map +1 -0
  116. package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.js +42 -0
  117. package/dist/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.d.ts.map +1 -1
  118. package/dist/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.js +6 -0
  119. package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.d.ts +8 -0
  120. package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.d.ts.map +1 -0
  121. package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.js +14 -0
  122. package/dist/i18n/generated-locales/en.generated.d.ts.map +1 -1
  123. package/dist/i18n/generated-locales/en.generated.js +30 -0
  124. package/dist/i18n/generated-locales/pseudo.generated.d.ts.map +1 -1
  125. package/dist/i18n/generated-locales/pseudo.generated.js +30 -0
  126. package/dist/index.d.ts +1 -0
  127. package/dist/index.d.ts.map +1 -1
  128. package/dist/index.js +4 -0
  129. package/dist/internal/indicatorPress.stylex.d.ts +20 -0
  130. package/dist/internal/indicatorPress.stylex.d.ts.map +1 -0
  131. package/dist/internal/indicatorPress.stylex.js +26 -0
  132. package/dist/motion/animator.d.ts +14 -14
  133. package/dist/motion/animator.d.ts.map +1 -1
  134. package/dist/motion/animator.js +41 -18
  135. package/dist/motion/uikit/alert.d.ts +41 -0
  136. package/dist/motion/uikit/alert.d.ts.map +1 -0
  137. package/dist/motion/uikit/alert.js +43 -0
  138. package/dist/privateAttributes/pressGroupItem.stylex.d.ts +15 -0
  139. package/dist/privateAttributes/pressGroupItem.stylex.d.ts.map +1 -0
  140. package/dist/privateAttributes/pressGroupItem.stylex.js +23 -0
  141. package/dist/utils/focusReturn.d.ts +15 -0
  142. package/dist/utils/focusReturn.d.ts.map +1 -1
  143. package/dist/utils/focusReturn.js +28 -0
  144. package/dist/utils/interactionOverlay.stylex.d.ts +3 -2
  145. package/dist/utils/interactionOverlay.stylex.d.ts.map +1 -1
  146. package/dist/utils/interactionOverlay.stylex.js +3 -2
  147. package/dist/utils/pressFeedback.d.ts.map +1 -1
  148. package/dist/utils/pressFeedback.js +19 -6
  149. package/dist/utils/triggerFocus.d.ts +36 -0
  150. package/dist/utils/triggerFocus.d.ts.map +1 -0
  151. package/dist/utils/triggerFocus.js +65 -0
  152. package/locales/en.json +120 -0
  153. package/locales/pseudo.json +90 -0
  154. package/package.json +9 -4
  155. package/src/AlertDialog/AlertDialog.doc.mjs +2 -2
  156. package/src/AlertDialog/AlertDialog.tsx +37 -5
  157. package/src/BottomSheet/BottomSheetPanel.tsx +33 -3
  158. package/src/BottomSheet/useSheetGestures.ts +3 -1
  159. package/src/Button/Button.tsx +26 -4
  160. package/src/CheckboxInput/CheckboxInput.doc.mjs +18 -0
  161. package/src/CheckboxInput/CheckboxInput.tsx +36 -9
  162. package/src/ComplexSelector/ComplexSelector.tsx +20 -5
  163. package/src/ContextMenu/ContextMenu.tsx +2 -2
  164. package/src/Dialog/Dialog.tsx +10 -31
  165. package/src/Field/Field.tsx +2 -2
  166. package/src/HoverCard/HoverCard.doc.mjs +4 -2
  167. package/src/HoverCard/HoverCard.tsx +4 -3
  168. package/src/HoverCard/useHoverCard.doc.mjs +178 -36
  169. package/src/HoverCard/useHoverCard.tsx +46 -52
  170. package/src/Icon/Icon.doc.mjs +49 -8
  171. package/src/Icon/Icon.tsx +15 -7
  172. package/src/Layer/usePressPin.ts +81 -15
  173. package/src/Lightbox/Lightbox.tsx +18 -0
  174. package/src/PowerSearch/PowerSearch.doc.mjs +54 -5
  175. package/src/PowerSearch/PowerSearch.tsx +609 -155
  176. package/src/PowerSearch/PowerSearchBottomSheet.tsx +2515 -0
  177. package/src/PowerSearch/PowerSearchEditPopover.tsx +28 -6
  178. package/src/PowerSearch/PowerSearchValueEditor.tsx +203 -38
  179. package/src/PowerSearch/formatFilterValue.ts +18 -1
  180. package/src/PowerSearch/formatTokenValue.ts +215 -0
  181. package/src/PowerSearch/powerSearchSheetUtils.ts +224 -0
  182. package/src/RadioList/RadioList.tsx +3 -2
  183. package/src/RadioList/RadioListItem.tsx +5 -3
  184. package/src/Resizable/Resizable.doc.mjs +5 -4
  185. package/src/Resizable/ResizeHandle.tsx +167 -109
  186. package/src/SegmentedControl/useSegmentedSelectionMotion.ts +6 -3
  187. package/src/Slider/sliderTouchController.ts +2 -2
  188. package/src/Spinner/Spinner.tsx +77 -63
  189. package/src/Switch/useSwitchTouch.ts +4 -4
  190. package/src/Table/BaseTable.tsx +46 -12
  191. package/src/TextInput/TextInput.tsx +11 -10
  192. package/src/Toast/Toast.doc.mjs +4 -3
  193. package/src/Toast/Toast.tsx +52 -32
  194. package/src/Toast/ToastViewport.tsx +121 -35
  195. package/src/Toast/types.ts +9 -3
  196. package/src/Tooltip/useTooltip.doc.mjs +24 -0
  197. package/src/Tooltip/useTooltip.tsx +61 -56
  198. package/src/Typeahead/TypeaheadItem.doc.mjs +6 -3
  199. package/src/Typeahead/TypeaheadItem.tsx +2 -1
  200. package/src/animator/createAnimator.doc.mjs +153 -0
  201. package/src/animator/createAnimator.ts +324 -0
  202. package/src/gestures/PressTracker.ts +4 -3
  203. package/src/gestures/README.md +7 -1
  204. package/src/hooks/actionGroupTracker.ts +20 -5
  205. package/src/hooks/index.ts +2 -0
  206. package/src/hooks/pressGroupContext.ts +21 -0
  207. package/src/hooks/useActionGroupTracking.ts +224 -0
  208. package/src/hooks/useAnimator.doc.mjs +109 -0
  209. package/src/hooks/useAnimator.ts +67 -0
  210. package/src/hooks/useAttachment.ts +1 -1
  211. package/src/hooks/useInputStatusIcon.tsx +3 -2
  212. package/src/hooks/useLongPress.doc.mjs +2 -2
  213. package/src/hooks/useLongPress.ts +136 -15
  214. package/src/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.ts +43 -0
  215. package/src/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.ts +6 -0
  216. package/src/i18n/generated-english/PowerSearch/formatTokenValue.generated.ts +15 -0
  217. package/src/i18n/generated-locales/en.generated.ts +41 -0
  218. package/src/i18n/generated-locales/pseudo.generated.ts +42 -0
  219. package/src/index.ts +13 -0
  220. package/src/internal/indicatorPress.stylex.ts +24 -0
  221. package/src/motion/README.md +8 -5
  222. package/src/motion/animator.ts +61 -29
  223. package/src/motion/uikit/alert.ts +43 -0
  224. package/src/privateAttributes/pressGroupItem.stylex.ts +23 -0
  225. package/src/utils/focusReturn.ts +30 -0
  226. package/src/utils/interactionOverlay.stylex.ts +3 -2
  227. package/src/utils/pressFeedback.ts +19 -6
  228. package/src/utils/triggerFocus.ts +80 -0
@@ -4,19 +4,25 @@
4
4
 
5
5
  /**
6
6
  * @file PowerSearch.tsx
7
- * @input PowerSearchConfig, filters, onChange
7
+ * @input PowerSearchConfig, filters, onChange; Tokenizer, Field parts, Token,
8
+ * useAdaptivePresentation, and PowerSearchBottomSheet (lazy)
8
9
  * @output Structured filter bar with token-based filter management
9
10
  * @position Main component; forwards DOM ref and exposes tokenizer control via
10
- * handleRef
11
+ * handleRef. The experimental `presentation` option swaps the tokenizer
12
+ * field and editor popover for one trigger that opens PowerSearchBottomSheet.
11
13
  *
12
14
  * SYNC: When modified, update:
13
15
  * - /packages/core/src/PowerSearch/index.ts
16
+ * - /packages/core/src/PowerSearch/PowerSearchBottomSheet.tsx (sheet presentation)
14
17
  * - /packages/cli/assets/templates/blocks/components/PowerSearch/ (showcase blocks)
15
18
  */
16
19
 
17
20
  import React, {
21
+ lazy,
22
+ Suspense,
18
23
  useCallback,
19
24
  useEffect,
25
+ useId,
20
26
  useImperativeHandle,
21
27
  useMemo,
22
28
  useRef,
@@ -37,30 +43,45 @@ import {Token} from '../Token';
37
43
  import {TokenNamingContext} from '../Token/TokenNamingContext';
38
44
  import {Avatar} from '../Avatar';
39
45
  import {layerAnimations} from '../Layer/layerAnimations.stylex';
40
- import {Icon} from '../Icon';
46
+ import {Icon, renderIconSlot} from '../Icon';
41
47
  import type {IconType} from '../Icon';
42
48
  import type {IconName} from '../Icon/globalIconRegistry';
43
49
  import type {InputStatus} from '../Field';
50
+ import {Field} from '../Field/Field';
51
+ import {
52
+ inputStatusBorderStyles,
53
+ inputStatusFocusWithinStyles,
54
+ inputStatusHoverShadowStyles,
55
+ inputWrapperStyles,
56
+ } from '../Field/inputStyles.stylex';
44
57
  import {usePopover} from '../Popover/usePopover';
58
+ import {useTooltip} from '../Tooltip/useTooltip';
45
59
  import {layerViewportInset} from '../Layer/layerViewportInset.stylex';
46
60
  import {useAnnounce} from '../hooks/useAnnounce';
61
+ import {useAdaptivePresentation} from '../hooks/useAdaptivePresentation';
62
+ import {useDevWarning} from '../hooks/useDevWarning';
63
+ import {useIsHydrating} from '../hooks/useIsHydrating';
47
64
  import {
48
65
  spacingVars,
49
66
  colorVars,
67
+ sizeVars,
50
68
  typeScaleVars,
69
+ typographyVars,
51
70
  fontWeightVars,
52
71
  } from '../theme/tokens.stylex';
53
72
  import {useSize} from '../SizeContext/SizeContext';
73
+ import {isFocusDetached} from '../utils/focusReturn';
74
+ import {isRenderable} from '../utils/isRenderable';
54
75
  import {useInternalConfig} from './useInternalConfig';
55
76
  import {usePowerSearchSource} from './usePowerSearchSource';
77
+ import {formatFilterValue} from './formatFilterValue';
78
+ import {NestedEditor, PowerSearchEditPopover} from './PowerSearchEditPopover';
56
79
  import {
57
- formatFilterValue,
58
- formatDateAbsoluteCompact,
59
- } from './formatFilterValue';
60
- import {PowerSearchEditPopover} from './PowerSearchEditPopover';
80
+ buildRelativeDateOptions,
81
+ PowerSearchValueEditor,
82
+ } from './PowerSearchValueEditor';
61
83
  import {resolveOperatorLabel} from './resolveOperatorLabel';
62
84
  import {themeProps} from '../utils/themeProps';
63
- import {truncateCharacters} from '../utils/characters';
64
85
  import {useLocale} from '../i18n/useLocale';
65
86
  import type {Locale} from '../i18n/types';
66
87
  import type {SearchableItem} from '../Typeahead/types';
@@ -74,10 +95,14 @@ import type {
74
95
  PowerSearchHandle,
75
96
  FilterValue,
76
97
  OperatorValue,
77
- EnumItem,
78
98
  PowerSearchComponents,
79
99
  PowerSearchOperator,
80
100
  } from './types';
101
+ import type {
102
+ PowerSearchBottomSheetProps,
103
+ PowerSearchSheetEditors,
104
+ } from './PowerSearchBottomSheet';
105
+ import {formatTokenValueText} from './formatTokenValue';
81
106
 
82
107
  import {useMergedRefs} from '../hooks/useMergedRefs';
83
108
  import type {FieldStatusPlacement} from '../Field/fieldStatusPlacement';
@@ -150,130 +175,127 @@ const resultCountStyles = stylex.create({
150
175
  },
151
176
  });
152
177
 
153
- function truncateString(value: string, limit: number): string {
154
- // Same semantics as before — strings within limit + 3 pass through, longer
155
- // ones cut to limit + '...' — but counted in characters, not code units.
156
- return truncateCharacters(value, limit + 3, '...');
157
- }
178
+ // The sheet presentation's trigger field: the same control box as the
179
+ // tokenizer field, with display-only tokens and one button as its only tab
180
+ // stop.
181
+ const sheetTriggerSizeStyles = stylex.create({
182
+ sm: {minHeight: sizeVars['--size-element-sm']},
183
+ md: {minHeight: sizeVars['--size-element-md']},
184
+ lg: {minHeight: sizeVars['--size-element-lg']},
185
+ });
158
186
 
159
- function getEnumLabel(values: ReadonlyArray<EnumItem>, value: string): string {
160
- return values.find(v => v.value === value)?.label ?? value;
161
- }
187
+ const sheetTriggerStyles = stylex.create({
188
+ wrapper: {
189
+ position: 'relative',
190
+ flexWrap: 'nowrap',
191
+ gap: spacingVars['--spacing-1'],
192
+ height: 'auto',
193
+ cursor: {
194
+ default: 'pointer',
195
+ ':is([aria-disabled="true"])': 'default',
196
+ },
197
+ },
198
+ wrapperWithTokens: {
199
+ paddingBlock: `calc(${spacingVars['--spacing-1']} - 1px)`,
200
+ paddingInline: `calc(${spacingVars['--spacing-1']} - 1px)`,
201
+ },
202
+ contentSection: {
203
+ position: 'relative',
204
+ minWidth: 0,
205
+ flexGrow: 1,
206
+ display: 'flex',
207
+ alignItems: 'center',
208
+ flexWrap: 'wrap',
209
+ columnGap: spacingVars['--spacing-1'],
210
+ rowGap: `calc(${spacingVars['--spacing-1']} - 1px)`,
211
+ },
212
+ startIconWithTokens: {
213
+ marginInlineStart: `calc(${spacingVars['--spacing-2']} - ${spacingVars['--spacing-1']} + 1px)`,
214
+ },
215
+ // The only tab stop in the field. It stays visually borderless while the
216
+ // wrapper delegates taps on tokens and empty space to it.
217
+ trigger: {
218
+ appearance: 'none',
219
+ flex: '1 1 40px',
220
+ minWidth: '40px',
221
+ alignSelf: 'stretch',
222
+ display: 'flex',
223
+ alignItems: 'center',
224
+ paddingBlock: 0,
225
+ paddingInline: spacingVars['--spacing-1'],
226
+ margin: 0,
227
+ borderWidth: 0,
228
+ borderStyle: 'none',
229
+ backgroundColor: 'transparent',
230
+ color: colorVars['--color-text-secondary'],
231
+ fontFamily: typographyVars['--font-family-body'],
232
+ fontSize: typeScaleVars['--text-body-size'],
233
+ lineHeight: typeScaleVars['--text-body-leading'],
234
+ textAlign: 'start',
235
+ whiteSpace: 'nowrap',
236
+ cursor: {
237
+ default: 'pointer',
238
+ ':is([aria-disabled="true"])': 'default',
239
+ },
240
+ outline: 'none',
241
+ },
242
+ // Once a token is present the empty trigger covers the token lane instead
243
+ // of reserving 40px or wrapping onto an otherwise blank row.
244
+ triggerWithTokens: {
245
+ position: 'absolute',
246
+ inset: 0,
247
+ minWidth: 0,
248
+ padding: 0,
249
+ },
250
+ endSection: {
251
+ display: 'flex',
252
+ alignItems: 'center',
253
+ gap: spacingVars['--spacing-2'],
254
+ flexShrink: 0,
255
+ paddingInlineEnd: spacingVars['--spacing-1'],
256
+ },
257
+ });
258
+
259
+ // The sheet flow (three standalone sheets, the sheet editors) only
260
+ // renders for the bottom-sheet presentation. Loading it on demand keeps it out
261
+ // of pages whose PowerSearch stays a tokenizer field.
262
+ // One import promise, shared by the preload and the lazy element: the sheet
263
+ // presentation loads the flow's chunk as soon as it is active, so the first
264
+ // press does not wait for the network, while nothing of the flow is rendered
265
+ // until a press.
266
+ const loadPowerSearchBottomSheet = async () =>
267
+ import('./PowerSearchBottomSheet');
268
+ const LazyPowerSearchBottomSheet = lazy(async () =>
269
+ loadPowerSearchBottomSheet().then(module => ({
270
+ default: module.PowerSearchBottomSheet,
271
+ })),
272
+ );
273
+ // The value step reuses the popover presentation's editors, which this
274
+ // module already loads; see PowerSearchSheetEditors.
275
+ const SHEET_EDITORS: PowerSearchSheetEditors = {
276
+ NestedEditor,
277
+ PowerSearchValueEditor,
278
+ buildRelativeDateOptions,
279
+ };
162
280
 
163
281
  /**
164
- * The visible text of a filter token's value. The token renders it, and the
165
- * token's remove button and editor dialog are named by the same text.
282
+ * Hosts the lazily loaded sheet flow. Renders nothing on the server or in the
283
+ * render that hydrates server HTML: a lazy component that has not loaded yet
284
+ * would leave server markup incomplete and abort hydration. The closed flow
285
+ * has no visible markup, so it first renders right after hydration.
166
286
  */
167
- function tokenValueText(
168
- operatorValue: OperatorValue,
169
- filterValue: FilterValue,
170
- maxLength: number,
171
- locale: Locale,
172
- ): string | null {
173
- switch (filterValue.type) {
174
- case 'empty':
175
- return null;
176
-
177
- case 'string':
178
- return truncateString(filterValue.value, maxLength);
179
-
180
- case 'integer':
181
- case 'float':
182
- return String(filterValue.value);
183
-
184
- case 'enum':
185
- if (operatorValue.type === 'enum') {
186
- return truncateString(
187
- getEnumLabel(operatorValue.values, filterValue.value),
188
- maxLength,
189
- );
190
- }
191
- return truncateString(filterValue.value, maxLength);
192
-
193
- case 'string_list': {
194
- const items = filterValue.value;
195
- if (items.length === 0) {
196
- return null;
197
- }
198
- if (items.length === 1) {
199
- return truncateString(items[0], maxLength);
200
- }
201
- const totalLength = items.reduce((sum, s) => sum + s.length, 0);
202
- if (totalLength > maxLength) {
203
- return `${items.length} items`;
204
- }
205
- return items.join(', ');
206
- }
207
-
208
- case 'enum_list': {
209
- const items = filterValue.value;
210
- if (items.length === 0) {
211
- return null;
212
- }
213
- if (operatorValue.type === 'enum_list') {
214
- const labels = items.map(v => getEnumLabel(operatorValue.values, v));
215
- if (labels.length === 1) {
216
- return truncateString(labels[0], maxLength);
217
- }
218
- const totalLength = labels.reduce((sum, s) => sum + s.length, 0);
219
- if (totalLength > maxLength) {
220
- return `${labels.length} items`;
221
- }
222
- return labels.join(', ');
223
- }
224
- if (items.length === 1) {
225
- return truncateString(items[0], maxLength);
226
- }
227
- return `${items.length} items`;
228
- }
229
-
230
- case 'entity_list': {
231
- const entities = filterValue.value;
232
- if (entities.length === 0) {
233
- return null;
234
- }
235
- if (entities.length === 1) {
236
- return truncateString(entities[0].label, maxLength);
237
- }
238
- const totalLength = entities.reduce((sum, e) => sum + e.label.length, 0);
239
- if (totalLength > maxLength) {
240
- return `${entities.length} items`;
241
- }
242
- return entities.map(e => e.label).join(', ');
243
- }
244
-
245
- case 'time':
246
- return filterValue.value;
247
-
248
- case 'date_absolute':
249
- return truncateString(
250
- formatDateAbsoluteCompact(filterValue.unixSeconds, locale),
251
- maxLength,
252
- );
253
-
254
- case 'date_relative':
255
- return truncateString(filterValue.value, maxLength);
256
-
257
- case 'date_range':
258
- return 'date range';
259
-
260
- case 'custom':
261
- if (operatorValue.type === 'custom') {
262
- return truncateString(
263
- operatorValue.getString(filterValue.value),
264
- maxLength,
265
- );
266
- }
267
- return filterValue.value;
268
-
269
- case 'nested': {
270
- const count = filterValue.value.length;
271
- return count === 1 ? '1 filter' : `${count} filters`;
272
- }
273
-
274
- default:
275
- return null;
287
+ function PowerSearchSheetHost(
288
+ props: Omit<PowerSearchBottomSheetProps, 'editors'>,
289
+ ) {
290
+ const isHydrating = useIsHydrating();
291
+ if (isHydrating) {
292
+ return null;
276
293
  }
294
+ return (
295
+ <Suspense fallback={null}>
296
+ <LazyPowerSearchBottomSheet {...props} editors={SHEET_EDITORS} />
297
+ </Suspense>
298
+ );
277
299
  }
278
300
 
279
301
  function PowerSearchTokenValue({text}: {text: string}) {
@@ -388,6 +410,37 @@ export interface PowerSearchProps extends Omit<
388
410
  * Keys are operator value types (e.g. 'string', 'enum', 'date_absolute').
389
411
  */
390
412
  components?: PowerSearchComponents;
413
+
414
+ /**
415
+ * Experimental options, outside the stable compatibility promise: anything
416
+ * in this object may change or be removed in a patch release. Omit it for
417
+ * the stable behavior.
418
+ * @experimental
419
+ */
420
+ experimental?: {
421
+ /**
422
+ * How the field presents filter editing.
423
+ * - `'popover'`: the tokenizer field with its typeahead and the editor
424
+ * popover — the stable behavior.
425
+ * - `'bottom-sheet'`: the whole field is one trigger showing display-only
426
+ * filter tokens; it opens a stack of sheets. Filters lists the filters
427
+ * as rows that edit or remove one, with Add filter, Done, and Clear
428
+ * all, which asks first and keeps read-only filters. Add filter opens
429
+ * above it with the fields (or the content search with inline
430
+ * suggestions), and a value step opens above that, stages operator →
431
+ * value, and confirms from its footer. Dismissing a step reveals the
432
+ * one beneath. Suited to compact touch screens, where the editor
433
+ * popover competes with the software keyboard.
434
+ * - `'adaptive'`: the bottom sheet on compact coarse-pointer screens,
435
+ * otherwise the popover — the same resolution Selector uses.
436
+ *
437
+ * In the sheet presentation `menuWidth` and `tokenOverflowBehavior` have
438
+ * no surface to act on and warn in development.
439
+ * @experimental
440
+ * @default 'popover'
441
+ */
442
+ presentation?: 'popover' | 'bottom-sheet' | 'adaptive';
443
+ };
391
444
  }
392
445
 
393
446
  // =============================================================================
@@ -524,6 +577,7 @@ export function PowerSearch({
524
577
  className,
525
578
  style,
526
579
  components: componentOverrides,
580
+ experimental,
527
581
  }: PowerSearchProps) {
528
582
  const size = useSize(sizeProp, 'md');
529
583
  const config = useInternalConfig(configProp);
@@ -537,6 +591,105 @@ export function PowerSearch({
537
591
  popoverSaveButtonLabelFromProps ?? t('@astryx.powersearch.editor.apply');
538
592
  const tokenizerRef = useRef<TokenizerHandle>(null);
539
593
 
594
+ // Experimental presentation. `adaptive`
595
+ // resolves through the policy the selection controls share; an open flow
596
+ // keeps its presentation until it closes, so a resolution change mid-task
597
+ // cannot pull the surface out from under the person.
598
+ const presentation = experimental?.presentation ?? 'popover';
599
+ const resolvedPresentation = useAdaptivePresentation(presentation);
600
+ const [isSheetOpen, setIsSheetOpen] = useState(false);
601
+ // Latched for the flow's lifetime: the flow stays presented after it closes
602
+ // until the sheets have run their exit and handed focus back to the trigger.
603
+ // Without the latch, `adaptive` resolving to `popover` mid-session (a phone
604
+ // turned to landscape) would unmount the sheets and the trigger they return
605
+ // focus to in the same render, dropping focus to the page body.
606
+ const [isSheetPresented, setIsSheetPresented] = useState(false);
607
+ const isSheetPresentation =
608
+ isSheetOpen || isSheetPresented || resolvedPresentation === 'bottom-sheet';
609
+ const triggerRef = useRef<HTMLButtonElement>(null);
610
+ // `hasAutoFocus` applies only to the control the field first mounts. A
611
+ // presentation swap remounts the control (combobox input or trigger), and
612
+ // React's `autoFocus` on the new one would pull focus from wherever on the
613
+ // page it was; the roots' callback refs hand over the focus the field held
614
+ // instead. A field that never swaps keeps `autoFocus` on every render, so a
615
+ // Dialog that keeps it mounted still finds its `data-autofocus` on open.
616
+ const [autoFocusState, setAutoFocusState] = useState({
617
+ presentation: isSheetPresentation,
618
+ isFirstControl: true,
619
+ });
620
+ if (autoFocusState.presentation !== isSheetPresentation) {
621
+ setAutoFocusState({
622
+ presentation: isSheetPresentation,
623
+ isFirstControl: false,
624
+ });
625
+ }
626
+ const autoFocusOnMount =
627
+ hasAutoFocus &&
628
+ autoFocusState.isFirstControl &&
629
+ autoFocusState.presentation === isSheetPresentation;
630
+ // A focus the swap moves continues the same visit to the field: the
631
+ // control that held focus is gone (no blur fires for a removed element), so
632
+ // the caller is told of neither a blur nor a new focus.
633
+ const isSwapFocusRef = useRef(false);
634
+ const focusAfterSwap = useCallback((control: {focus(): void} | null) => {
635
+ if (control == null) {
636
+ return;
637
+ }
638
+ isSwapFocusRef.current = true;
639
+ try {
640
+ control.focus();
641
+ } finally {
642
+ isSwapFocusRef.current = false;
643
+ }
644
+ }, []);
645
+ const handleFieldFocus = useCallback(
646
+ (event: React.FocusEvent) => {
647
+ if (!isSwapFocusRef.current) {
648
+ onFocus?.(event);
649
+ }
650
+ },
651
+ [onFocus],
652
+ );
653
+ const handleFieldBlur = useCallback(
654
+ (event: React.FocusEvent) => {
655
+ onBlur?.(event);
656
+ },
657
+ [onBlur],
658
+ );
659
+ // While the flow is open, the sheet announces its own content from inside
660
+ // its dialog; this component announces only with the flow closed, and
661
+ // `useAnnounce` routes those messages by where the field is — into a Dialog
662
+ // or modal Drawer that holds it, or the shared channel when no modal does.
663
+ // A result count that changed during the flow's exit is spoken once the
664
+ // flow has fully closed and focus is back on the trigger: the closing
665
+ // dialog stays modal through its exit, so neither its region nor the
666
+ // page-body channel is heard before.
667
+ const afterCloseResultCountRef = useRef<string | null>(null);
668
+ const triggerId = useId();
669
+ const triggerLabelId = useId();
670
+ const triggerContentId = useId();
671
+ const statusMessageId = useId();
672
+ // A field that becomes disabled cannot keep its flow open, and must not
673
+ // reopen it when re-enabled. Adjusted in the
674
+ // render that sees the change, not an effect, so no frame shows both.
675
+ const [wasDisabled, setWasDisabled] = useState(isDisabled);
676
+ if (isDisabled !== wasDisabled) {
677
+ setWasDisabled(isDisabled);
678
+ if (isDisabled && isSheetOpen) {
679
+ setIsSheetOpen(false);
680
+ }
681
+ }
682
+ useDevWarning(
683
+ 'PowerSearch',
684
+ '`menuWidth` has no surface in the bottom-sheet presentation: the sheet flow has no typeahead popover to size. Scope it to the popover presentation or leave it out.',
685
+ isSheetPresentation && menuWidth != null,
686
+ );
687
+ useDevWarning(
688
+ 'PowerSearch',
689
+ '`tokenOverflowBehavior` has no surface in the bottom-sheet presentation: the trigger wraps its display-only tokens. Scope it to the popover presentation or leave it out.',
690
+ isSheetPresentation && tokenOverflowBehavior != null,
691
+ );
692
+
540
693
  const [popoverState, setPopoverStateRaw] = useState<PopoverState>({
541
694
  type: 'idle',
542
695
  });
@@ -552,7 +705,7 @@ export function PowerSearch({
552
705
  const operatorLabel = operator ? resolveOperatorLabel(operator, t) : '';
553
706
  const label = `${fieldLabel}: ${operatorLabel}`.trim();
554
707
  const value = operator
555
- ? tokenValueText(
708
+ ? formatTokenValueText(
556
709
  operator.value,
557
710
  filter.value,
558
711
  Math.max(
@@ -581,9 +734,21 @@ export function PowerSearch({
581
734
  componentOverrides?.[editedOperator.value.type]?.Token == null
582
735
  ? editedFilter
583
736
  : undefined;
737
+ // Whether the editor popover is open, for the hand-off below, which runs
738
+ // in the commit that swaps presentations.
739
+ const isPopoverOpenRef = useRef(false);
740
+ // When `adaptive` flips to the sheet while the editor popover is open (a
741
+ // phone rotated), the editing ends with the popover: its state returns to
742
+ // idle (through the raw setter, since the tokenizer input is gone), in the
743
+ // render that sees the swap, so a later switch back does not reopen a stale
744
+ // editor.
745
+ if (isSheetPresentation && popoverState.type !== 'idle') {
746
+ setPopoverStateRaw({type: 'idle'});
747
+ }
584
748
 
585
749
  // Layer for positioning the edit popover anchored to the tokenizer
586
750
  const handleLayerHide = useCallback(() => {
751
+ isPopoverOpenRef.current = false;
587
752
  setPopoverStateRaw({type: 'idle'});
588
753
  }, []);
589
754
 
@@ -604,9 +769,54 @@ export function PowerSearch({
604
769
  : undefined,
605
770
  });
606
771
 
772
+ // A presentation swap removes the focused control, so the other
773
+ // presentation's primary control (the combobox input or the trigger) takes
774
+ // focus and focus never falls to the page body. Each presentation keys its
775
+ // root, so a swap mounts a new root. The detaching root notes that it held
776
+ // focus, which also covers an input focused by server-rendered `autofocus`
777
+ // before hydration. The editor popover is portaled outside the root, so an
778
+ // open editor counts as held focus. The attaching root gives focus to its
779
+ // primary control when focus has fallen to the page body; the sheet root
780
+ // also hides a popover layer left open.
781
+ const isFocusPendingHandOffRef = useRef(false);
782
+ const hidePopover = popover.hide;
783
+ const handOffFocusRef = useCallback(
784
+ (node: HTMLDivElement | null) => {
785
+ if (node == null) {
786
+ return;
787
+ }
788
+ const trigger = triggerRef.current;
789
+ const isSheetRoot = trigger != null && node.contains(trigger);
790
+ // The sheet presentation preloads the flow's chunk, so the first press
791
+ // opens without waiting for the network; nothing renders.
792
+ if (isSheetRoot) {
793
+ void loadPowerSearchBottomSheet();
794
+ }
795
+ if (isSheetRoot && isPopoverOpenRef.current) {
796
+ isPopoverOpenRef.current = false;
797
+ hidePopover();
798
+ }
799
+ const takesFocus = isFocusPendingHandOffRef.current;
800
+ isFocusPendingHandOffRef.current = false;
801
+ if (takesFocus && isFocusDetached(node.ownerDocument)) {
802
+ focusAfterSwap(isSheetRoot ? trigger : tokenizerRef.current);
803
+ }
804
+ return () => {
805
+ if (
806
+ node.contains(node.ownerDocument.activeElement) ||
807
+ isPopoverOpenRef.current
808
+ ) {
809
+ isFocusPendingHandOffRef.current = true;
810
+ }
811
+ };
812
+ },
813
+ [focusAfterSwap, hidePopover],
814
+ );
815
+
607
816
  // Wrapper that manages layer visibility and tokenizer focus alongside state
608
817
  const setPopoverState = useCallback(
609
818
  (state: PopoverState) => {
819
+ isPopoverOpenRef.current = state.type !== 'idle';
610
820
  setPopoverStateRaw(state);
611
821
  if (state.type !== 'idle') {
612
822
  // Schedule after the current frame so React can render the popover
@@ -623,13 +833,22 @@ export function PowerSearch({
623
833
  [popover],
624
834
  );
625
835
 
626
- // Expose imperative handle
836
+ // Expose imperative handle; in the sheet presentation the trigger is the
837
+ // field's focusable control.
627
838
  useImperativeHandle(handleRef, () => ({
628
839
  focusTypeahead() {
629
- tokenizerRef.current?.focus();
840
+ if (isSheetPresentation) {
841
+ triggerRef.current?.focus();
842
+ } else {
843
+ tokenizerRef.current?.focus();
844
+ }
630
845
  },
631
846
  blurTypeahead() {
632
- tokenizerRef.current?.blur();
847
+ if (isSheetPresentation) {
848
+ triggerRef.current?.blur();
849
+ } else {
850
+ tokenizerRef.current?.blur();
851
+ }
633
852
  },
634
853
  }));
635
854
 
@@ -833,10 +1052,12 @@ export function PowerSearch({
833
1052
  setPopoverState({type: 'idle'});
834
1053
  }, [setPopoverState]);
835
1054
 
836
- // Custom token renderer
837
- // Custom token renderer
838
- const renderToken = useCallback(
839
- (item: PowerSearchItem, onRemove: () => void) => {
1055
+ // Token renderer for both presentations. Given `onRemove`, the token is
1056
+ // the tokenizer field's: click edits, × removes. Without it (the sheet
1057
+ // presentation's trigger) the token is display-only; the field as a whole
1058
+ // opens the flow.
1059
+ const renderFilterToken = useCallback(
1060
+ (item: PowerSearchItem, onRemove: (() => void) | undefined) => {
840
1061
  const auxData = item.auxiliaryData;
841
1062
  const filterIndex = auxData?.filterIndex ?? -1;
842
1063
  const filter = filterIndex >= 0 ? filters[filterIndex] : undefined;
@@ -846,7 +1067,8 @@ export function PowerSearch({
846
1067
  ? config.getOperator(auxData.fieldKey, auxData.operatorKey)
847
1068
  : undefined;
848
1069
 
849
- const canInteract = !isReadOnly && !isDisabled && !filter?.isReadOnly;
1070
+ const canInteract =
1071
+ onRemove != null && !isReadOnly && !isDisabled && !filter?.isReadOnly;
850
1072
  const handleClick = canInteract
851
1073
  ? () => handleTokenClick(filterIndex)
852
1074
  : undefined;
@@ -959,6 +1181,12 @@ export function PowerSearch({
959
1181
  ],
960
1182
  );
961
1183
 
1184
+ const renderToken = useCallback(
1185
+ (item: PowerSearchItem, onRemove: () => void) =>
1186
+ renderFilterToken(item, onRemove),
1187
+ [renderFilterToken],
1188
+ );
1189
+
962
1190
  // Custom typeahead item renderer — adds field icon and description
963
1191
  const renderItem = useCallback(
964
1192
  (item: PowerSearchItem) => {
@@ -1076,13 +1304,18 @@ export function PowerSearch({
1076
1304
  return resultCount;
1077
1305
  }, [resultCount, t]);
1078
1306
 
1079
- // Announce result-count changes to screen readers through a polite live
1080
- // region, mirroring the way Typeahead announces its dropdown result count.
1081
- // The count is otherwise only shown visually and stays silent to assistive
1082
- // tech. Only a change after mount is spoken: the guard compares against the
1083
- // last announced text rather than a mounted flag, so StrictMode's effect
1084
- // replay (which resets a flag and would speak the count present on mount
1085
- // unprompted) announces nothing until the count changes.
1307
+ // This Effect synchronizes a polite live region with the result count,
1308
+ // mirroring the way Typeahead announces its dropdown result count: the count
1309
+ // is otherwise only shown visually and stays silent to assistive tech. The
1310
+ // region follows where the field is: the modal that holds the field (a
1311
+ // Dialog, a modal Drawer), else the shared channel. While a sheet of the flow is open the sheet itself announces the
1312
+ // count from inside its dialog, and this Effect stays quiet. Only a
1313
+ // change after mount is spoken — the count present on mount is not
1314
+ // announced unprompted — and the guard compares against the last announced
1315
+ // text rather than a mounted flag, so StrictMode's effect replay announces
1316
+ // nothing either. A change that lands while the flow is closing waits for
1317
+ // the trigger focus, since the dialog is still modal through its exit. The
1318
+ // announcement acquires no resource, so there is no cleanup.
1086
1319
  const announce = useAnnounce();
1087
1320
  // PowerSearch words its Clear all as its record does; the field announces
1088
1321
  // these words instead of Tokenizer's (component:Tokenizer AR7).
@@ -1095,15 +1328,20 @@ export function PowerSearch({
1095
1328
  [hasReadOnlyFilter, t],
1096
1329
  );
1097
1330
  const announcedResultCountRef = useRef(resultCountText);
1331
+ const isSheetExiting = isSheetPresented && !isSheetOpen;
1098
1332
  useEffect(() => {
1099
1333
  if (resultCountText === announcedResultCountRef.current) {
1100
1334
  return;
1101
1335
  }
1102
1336
  announcedResultCountRef.current = resultCountText;
1103
1337
  if (resultCountText != null) {
1104
- announce(resultCountText);
1338
+ if (isSheetExiting) {
1339
+ afterCloseResultCountRef.current = resultCountText;
1340
+ } else if (!isSheetOpen) {
1341
+ announce(resultCountText);
1342
+ }
1105
1343
  }
1106
- }, [resultCountText, announce]);
1344
+ }, [resultCountText, announce, isSheetExiting, isSheetOpen]);
1107
1345
 
1108
1346
  // Build combined endContent from resultCount + endContent props
1109
1347
  const combinedEndContent = useMemo((): React.ReactNode => {
@@ -1124,14 +1362,230 @@ export function PowerSearch({
1124
1362
  return resultCountNode || endContent || undefined;
1125
1363
  }, [resultCountText, endContent]);
1126
1364
 
1365
+ // ------------------------------------------------------- sheet trigger --
1366
+
1367
+ // Disabled-reason tooltip for the sheet trigger. Disabled controls swallow
1368
+ // pointer events, so the listeners attach to the field's control box; the
1369
+ // trigger stays perceivable through aria-disabled.
1370
+ const showsDisabledMessage = isDisabled && !!disabledMessage;
1371
+ const disabledMessageTooltip = useTooltip({
1372
+ placement: 'above',
1373
+ focusTrigger: 'always',
1374
+ isEnabled: isSheetPresentation && showsDisabledMessage,
1375
+ });
1376
+ const rootRef = useMergedRefs(
1377
+ ref,
1378
+ popover.triggerRef as React.Ref<HTMLDivElement>,
1379
+ handOffFocusRef,
1380
+ );
1381
+
1382
+ const openSheet = useCallback(() => {
1383
+ if (isDisabled) {
1384
+ return;
1385
+ }
1386
+ // The flow restores focus to the element that was active when it opened;
1387
+ // make sure that is the trigger even for a tap on a token.
1388
+ triggerRef.current?.focus({preventScroll: true});
1389
+ setIsSheetPresented(true);
1390
+ setIsSheetOpen(true);
1391
+ }, [isDisabled]);
1392
+
1393
+ // The field's end lane — the result count and `endContent` — sits outside
1394
+ // the trigger button: a caller's action button there keeps its own tab stop
1395
+ // and taps, and an interactive control must not nest in a component
1396
+ // button, so a tap on it must not open the flow.
1397
+ const endLaneRef = useRef<HTMLDivElement>(null);
1398
+ const handleTriggerWrapperClick = useCallback(
1399
+ (event: React.MouseEvent<HTMLDivElement>) => {
1400
+ // Tokens are display-only; a tap on them or the empty space around them
1401
+ // opens the flow. The trigger button handles its own click, and the end
1402
+ // lane handles its own.
1403
+ if (
1404
+ event.target instanceof Node &&
1405
+ (triggerRef.current?.contains(event.target) ||
1406
+ endLaneRef.current?.contains(event.target))
1407
+ ) {
1408
+ return;
1409
+ }
1410
+ openSheet();
1411
+ },
1412
+ [openSheet],
1413
+ );
1414
+
1415
+ const handleTriggerFocusWithin = useCallback(
1416
+ (event: React.FocusEvent<HTMLDivElement>) => {
1417
+ // The flow focuses the trigger only after its exit completes; that focus
1418
+ // is the signal that the retained sheets can leave. If the resolution
1419
+ // moved to the popover meanwhile, the tokenizer input takes over the
1420
+ // focus once it mounts (the hand-off above).
1421
+ if (!isSheetOpen && isSheetPresented) {
1422
+ setIsSheetPresented(false);
1423
+ // The dialogs have closed: the page-body channel is exposed again.
1424
+ const resultCount = afterCloseResultCountRef.current;
1425
+ afterCloseResultCountRef.current = null;
1426
+ if (resultCount != null) {
1427
+ announce(resultCount);
1428
+ }
1429
+ }
1430
+ if (
1431
+ !(event.relatedTarget instanceof Node) ||
1432
+ !event.currentTarget.contains(event.relatedTarget)
1433
+ ) {
1434
+ handleFieldFocus(event);
1435
+ }
1436
+ },
1437
+ [announce, handleFieldFocus, isSheetOpen, isSheetPresented],
1438
+ );
1439
+ const handleTriggerBlurWithin = useCallback(
1440
+ (event: React.FocusEvent<HTMLDivElement>) => {
1441
+ if (
1442
+ !(event.relatedTarget instanceof Node) ||
1443
+ !event.currentTarget.contains(event.relatedTarget)
1444
+ ) {
1445
+ handleFieldBlur(event);
1446
+ }
1447
+ },
1448
+ [handleFieldBlur],
1449
+ );
1450
+
1451
+ if (isSheetPresentation) {
1452
+ const triggerDescribedBy =
1453
+ [
1454
+ status?.message ? statusMessageId : null,
1455
+ showsDisabledMessage ? disabledMessageTooltip.describedBy : null,
1456
+ ]
1457
+ .filter(Boolean)
1458
+ .join(' ') || undefined;
1459
+
1460
+ return (
1461
+ <div key="sheet" ref={rootRef} {...themeProps('power-search')}>
1462
+ <Field
1463
+ label={label}
1464
+ isLabelHidden={isLabelHidden}
1465
+ inputID={triggerId}
1466
+ labelID={triggerLabelId}
1467
+ isDisabled={isDisabled}
1468
+ status={
1469
+ status
1470
+ ? {
1471
+ type: status.type,
1472
+ message: status.message,
1473
+ messageID: status.message ? statusMessageId : undefined,
1474
+ }
1475
+ : undefined
1476
+ }
1477
+ statusVariant={statusVariant}
1478
+ xstyle={xstyle}
1479
+ className={className}
1480
+ style={style}>
1481
+ <div
1482
+ ref={disabledMessageTooltip.ref}
1483
+ onClick={handleTriggerWrapperClick}
1484
+ onFocus={handleTriggerFocusWithin}
1485
+ onBlur={handleTriggerBlurWithin}
1486
+ aria-disabled={isDisabled ? true : undefined}
1487
+ {...stylex.props(
1488
+ inputWrapperStyles.base,
1489
+ sheetTriggerStyles.wrapper,
1490
+ filters.length > 0 && sheetTriggerStyles.wrapperWithTokens,
1491
+ sheetTriggerSizeStyles[size],
1492
+ isDisabled && inputWrapperStyles.disabled,
1493
+ status && inputStatusBorderStyles[status.type],
1494
+ status &&
1495
+ !isDisabled &&
1496
+ inputStatusHoverShadowStyles[status.type],
1497
+ status && inputStatusFocusWithinStyles[status.type],
1498
+ )}>
1499
+ {/* The trigger's name is the label plus everything visible here:
1500
+ the placeholder, or the tokens, so speech input can say what
1501
+ it sees and assistive technology hears the selected filters
1502
+ (WCAG 2.5.3). */}
1503
+ <div
1504
+ id={triggerContentId}
1505
+ {...stylex.props(sheetTriggerStyles.contentSection)}>
1506
+ {isRenderable(startIcon as React.ReactNode) && (
1507
+ <span
1508
+ {...stylex.props(
1509
+ filters.length > 0 &&
1510
+ sheetTriggerStyles.startIconWithTokens,
1511
+ )}>
1512
+ {renderIconSlot(startIcon, {size: 'sm', color: 'secondary'})}
1513
+ </span>
1514
+ )}
1515
+ {tokenizerValue.map(item => (
1516
+ <React.Fragment key={item.id}>
1517
+ {renderFilterToken(item, undefined)}
1518
+ </React.Fragment>
1519
+ ))}
1520
+ <button
1521
+ type="button"
1522
+ id={triggerId}
1523
+ ref={triggerRef}
1524
+ // The field's primary control: `data-testid` lands here, as it
1525
+ // lands on the combobox input in the popover presentation.
1526
+ data-testid={testId}
1527
+ autoFocus={autoFocusOnMount}
1528
+ onClick={openSheet}
1529
+ aria-disabled={isDisabled ? true : undefined}
1530
+ aria-haspopup="dialog"
1531
+ aria-expanded={isSheetOpen}
1532
+ aria-labelledby={`${triggerLabelId} ${triggerContentId}`}
1533
+ aria-describedby={triggerDescribedBy}
1534
+ {...stylex.props(
1535
+ sheetTriggerStyles.trigger,
1536
+ filters.length > 0 && sheetTriggerStyles.triggerWithTokens,
1537
+ )}>
1538
+ {filters.length === 0 ? placeholder : null}
1539
+ </button>
1540
+ </div>
1541
+ {(endContent || isRenderable(resultCountText)) && (
1542
+ <div
1543
+ ref={endLaneRef}
1544
+ {...stylex.props(sheetTriggerStyles.endSection)}>
1545
+ {isRenderable(resultCountText) && (
1546
+ <span {...stylex.props(resultCountStyles.text)}>
1547
+ {resultCountText}
1548
+ </span>
1549
+ )}
1550
+ {endContent}
1551
+ </div>
1552
+ )}
1553
+ </div>
1554
+ {showsDisabledMessage &&
1555
+ disabledMessageTooltip.renderTooltip(disabledMessage)}
1556
+ </Field>
1557
+ {/* Mounted from the press until the flow's exit has completed and
1558
+ focus is back on the trigger (`isSheetPresented`): at rest the
1559
+ field renders its trigger alone — no closed dialogs, rows, search
1560
+ field or editors in the DOM. */}
1561
+ {(isSheetOpen || isSheetPresented) && (
1562
+ <PowerSearchSheetHost
1563
+ isOpen={isSheetOpen}
1564
+ onOpenChange={setIsSheetOpen}
1565
+ finalFocusRef={triggerRef}
1566
+ resultCountText={resultCountText}
1567
+ config={config}
1568
+ configProp={configProp}
1569
+ filters={filters}
1570
+ onChange={onChange}
1571
+ searchSource={searchSource}
1572
+ placeholder={placeholder}
1573
+ isReadOnly={isReadOnly}
1574
+ isDisabled={isDisabled}
1575
+ hasClear={hasClear}
1576
+ maxOperatorMenuItems={maxOperatorMenuItems}
1577
+ maxSearchResults={maxSearchResults}
1578
+ saveButtonLabel={popoverSaveButtonLabelFromProps}
1579
+ components={componentOverrides}
1580
+ />
1581
+ )}
1582
+ </div>
1583
+ );
1584
+ }
1585
+
1127
1586
  return (
1128
1587
  <>
1129
- <div
1130
- ref={useMergedRefs(
1131
- ref,
1132
- popover.triggerRef as React.Ref<HTMLDivElement>,
1133
- )}
1134
- {...themeProps('power-search')}>
1588
+ <div key="popover" ref={rootRef} {...themeProps('power-search')}>
1135
1589
  {/* The field's Clear all announces PowerSearch's own words
1136
1590
  (component:PowerSearch; component:Tokenizer AR7). */}
1137
1591
  <TokenizerClearAllMessageContext value={clearAllMessage}>
@@ -1148,7 +1602,7 @@ export function PowerSearch({
1148
1602
  maxMenuItems={MAX_BROWSE_MENU_ITEMS}
1149
1603
  menuWidth={menuWidth}
1150
1604
  placeholder={filters.length === 0 ? placeholder : ''}
1151
- hasAutoFocus={hasAutoFocus}
1605
+ hasAutoFocus={autoFocusOnMount}
1152
1606
  hasClear={hasClear && !isReadOnly}
1153
1607
  startIcon={startIcon}
1154
1608
  endContent={combinedEndContent}
@@ -1160,8 +1614,8 @@ export function PowerSearch({
1160
1614
  debounceMs={0}
1161
1615
  status={status}
1162
1616
  statusVariant={statusVariant}
1163
- onFocus={onFocus}
1164
- onBlur={onBlur}
1617
+ onFocus={handleFieldFocus}
1618
+ onBlur={handleFieldBlur}
1165
1619
  containerXstyle={xstyle}
1166
1620
  containerClassName={className}
1167
1621
  containerStyle={style}