@wordpress/components 25.6.1 → 25.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1064) hide show
  1. package/CHANGELOG.md +70 -1
  2. package/CONTRIBUTING.md +1 -1
  3. package/README.md +3 -8
  4. package/build/animation/index.js +6 -0
  5. package/build/animation/index.js.map +1 -1
  6. package/build/border-control/border-control-dropdown/component.js +1 -1
  7. package/build/border-control/border-control-dropdown/component.js.map +1 -1
  8. package/build/border-control/styles.js +20 -20
  9. package/build/border-control/styles.js.map +1 -1
  10. package/build/box-control/unit-control.js +1 -1
  11. package/build/box-control/unit-control.js.map +1 -1
  12. package/build/button/index.js +9 -1
  13. package/build/button/index.js.map +1 -1
  14. package/build/button/types.js.map +1 -1
  15. package/build/circular-option-picker/circular-option-picker-actions.js +53 -0
  16. package/build/circular-option-picker/circular-option-picker-actions.js.map +1 -0
  17. package/build/circular-option-picker/circular-option-picker-context.js +14 -0
  18. package/build/circular-option-picker/circular-option-picker-context.js.map +1 -0
  19. package/build/circular-option-picker/circular-option-picker-option-group.js +26 -0
  20. package/build/circular-option-picker/circular-option-picker-option-group.js.map +1 -0
  21. package/build/circular-option-picker/circular-option-picker-option.js +122 -0
  22. package/build/circular-option-picker/circular-option-picker-option.js.map +1 -0
  23. package/build/circular-option-picker/circular-option-picker.js +172 -0
  24. package/build/circular-option-picker/circular-option-picker.js.map +1 -0
  25. package/build/circular-option-picker/index.js +29 -137
  26. package/build/circular-option-picker/index.js.map +1 -1
  27. package/build/circular-option-picker/types.js.map +1 -1
  28. package/build/color-palette/index.js +58 -19
  29. package/build/color-palette/index.js.map +1 -1
  30. package/build/color-palette/types.js.map +1 -1
  31. package/build/color-picker/hsv-color-picker.native.js +92 -0
  32. package/build/color-picker/hsv-color-picker.native.js.map +1 -0
  33. package/build/color-picker/hue-picker.native.js +195 -0
  34. package/build/color-picker/hue-picker.native.js.map +1 -0
  35. package/build/color-picker/index.native.js +3 -2
  36. package/build/color-picker/index.native.js.map +1 -1
  37. package/build/color-picker/saturation-picker.native.js +178 -0
  38. package/build/color-picker/saturation-picker.native.js.map +1 -0
  39. package/build/combobox-control/index.js +0 -3
  40. package/build/combobox-control/index.js.map +1 -1
  41. package/build/composite/index.js.map +1 -1
  42. package/build/custom-gradient-picker/gradient-bar/control-points.js.map +1 -1
  43. package/build/date-time/time/timezone.js +1 -1
  44. package/build/date-time/time/timezone.js.map +1 -1
  45. package/build/dropdown/index.js +11 -23
  46. package/build/dropdown/index.js.map +1 -1
  47. package/build/dropdown/types.js.map +1 -1
  48. package/build/dropdown-menu/index.js +7 -1
  49. package/build/dropdown-menu/index.js.map +1 -1
  50. package/build/dropdown-menu/types.js.map +1 -1
  51. package/build/dropdown-menu-v2/styles.js +16 -16
  52. package/build/dropdown-menu-v2/styles.js.map +1 -1
  53. package/build/duotone-picker/color-list-picker/index.js +18 -3
  54. package/build/duotone-picker/color-list-picker/index.js.map +1 -1
  55. package/build/duotone-picker/duotone-picker.js +33 -1
  56. package/build/duotone-picker/duotone-picker.js.map +1 -1
  57. package/build/duotone-picker/types.js.map +1 -1
  58. package/build/focusable-iframe/index.js +0 -4
  59. package/build/focusable-iframe/index.js.map +1 -1
  60. package/build/focusable-iframe/types.js +6 -0
  61. package/build/focusable-iframe/types.js.map +1 -0
  62. package/build/form-token-field/index.js +6 -2
  63. package/build/form-token-field/index.js.map +1 -1
  64. package/build/form-token-field/types.js.map +1 -1
  65. package/build/gradient-picker/index.js +57 -15
  66. package/build/gradient-picker/index.js.map +1 -1
  67. package/build/gradient-picker/types.js.map +1 -1
  68. package/build/higher-order/navigate-regions/index.js.map +1 -1
  69. package/build/higher-order/with-focus-outside/index.js +1 -2
  70. package/build/higher-order/with-focus-outside/index.js.map +1 -1
  71. package/build/higher-order/with-spoken-messages/index.js.map +1 -1
  72. package/build/index.js +6 -0
  73. package/build/index.js.map +1 -1
  74. package/build/input-control/styles/input-control-styles.js +22 -22
  75. package/build/input-control/styles/input-control-styles.js.map +1 -1
  76. package/build/item-group/item/component.js +0 -1
  77. package/build/item-group/item/component.js.map +1 -1
  78. package/build/item-group/item-group/component.js +0 -1
  79. package/build/item-group/item-group/component.js.map +1 -1
  80. package/build/menu-item/index.js +6 -4
  81. package/build/menu-item/index.js.map +1 -1
  82. package/build/menu-item/types.js.map +1 -1
  83. package/build/mobile/bottom-sheet/index.native.js +1 -0
  84. package/build/mobile/bottom-sheet/index.native.js.map +1 -1
  85. package/build/mobile/global-styles-context/index.native.js.map +1 -1
  86. package/build/mobile/link-settings/link-settings-navigation.native.js +1 -1
  87. package/build/mobile/link-settings/link-settings-navigation.native.js.map +1 -1
  88. package/build/navigation/index.js +0 -1
  89. package/build/navigation/index.js.map +1 -1
  90. package/build/navigation/use-navigation-tree-nodes.js.map +1 -1
  91. package/build/navigator/navigator-provider/component.js +1 -2
  92. package/build/navigator/navigator-provider/component.js.map +1 -1
  93. package/build/notice/index.js +19 -7
  94. package/build/notice/index.js.map +1 -1
  95. package/build/palette-edit/styles.js +10 -10
  96. package/build/palette-edit/styles.js.map +1 -1
  97. package/build/placeholder/index.js.map +1 -1
  98. package/build/popover/index.js +68 -151
  99. package/build/popover/index.js.map +1 -1
  100. package/build/popover/overlay-middlewares.js.map +1 -1
  101. package/build/popover/types.js.map +1 -1
  102. package/build/popover/utils.js +10 -87
  103. package/build/popover/utils.js.map +1 -1
  104. package/build/progress-bar/styles.js +6 -5
  105. package/build/progress-bar/styles.js.map +1 -1
  106. package/build/search-control/index.js +12 -3
  107. package/build/search-control/index.js.map +1 -1
  108. package/build/search-control/index.native.js +27 -24
  109. package/build/search-control/index.native.js.map +1 -1
  110. package/build/search-control/types.js.map +1 -1
  111. package/build/shortcut/index.js +13 -0
  112. package/build/shortcut/index.js.map +1 -1
  113. package/build/slot-fill/bubbles-virtually/slot-fill-context.js +3 -1
  114. package/build/slot-fill/bubbles-virtually/slot-fill-context.js.map +1 -1
  115. package/build/slot-fill/bubbles-virtually/slot.js +14 -8
  116. package/build/slot-fill/bubbles-virtually/slot.js.map +1 -1
  117. package/build/slot-fill/index.js +5 -0
  118. package/build/slot-fill/index.js.map +1 -1
  119. package/build/spinner/index.js +0 -1
  120. package/build/spinner/index.js.map +1 -1
  121. package/build/text/styles.js +7 -7
  122. package/build/text/styles.js.map +1 -1
  123. package/build/theme/index.js +0 -1
  124. package/build/theme/index.js.map +1 -1
  125. package/build/toggle-group-control/toggle-group-control/as-button-group.js +30 -45
  126. package/build/toggle-group-control/toggle-group-control/as-button-group.js.map +1 -1
  127. package/build/toggle-group-control/toggle-group-control/as-radio-group.js +40 -41
  128. package/build/toggle-group-control/toggle-group-control/as-radio-group.js.map +1 -1
  129. package/build/toggle-group-control/toggle-group-control/component.js +10 -5
  130. package/build/toggle-group-control/toggle-group-control/component.js.map +1 -1
  131. package/build/toggle-group-control/toggle-group-control/styles.js +9 -16
  132. package/build/toggle-group-control/toggle-group-control/styles.js.map +1 -1
  133. package/build/toggle-group-control/toggle-group-control/utils.js +44 -0
  134. package/build/toggle-group-control/toggle-group-control/utils.js.map +1 -0
  135. package/build/toggle-group-control/toggle-group-control-option-base/component.js +36 -17
  136. package/build/toggle-group-control/toggle-group-control-option-base/component.js.map +1 -1
  137. package/build/toggle-group-control/toggle-group-control-option-base/styles.js +10 -8
  138. package/build/toggle-group-control/toggle-group-control-option-base/styles.js.map +1 -1
  139. package/build/toggle-group-control/types.js.map +1 -1
  140. package/build/toolbar/toolbar/index.js +7 -1
  141. package/build/toolbar/toolbar/index.js.map +1 -1
  142. package/build/toolbar/toolbar-dropdown-menu/index.js +1 -3
  143. package/build/toolbar/toolbar-dropdown-menu/index.js.map +1 -1
  144. package/build/toolbar/toolbar-group/index.js +16 -12
  145. package/build/toolbar/toolbar-group/index.js.map +1 -1
  146. package/build/toolbar/toolbar-group/toolbar-group-collapsed.js +0 -2
  147. package/build/toolbar/toolbar-group/toolbar-group-collapsed.js.map +1 -1
  148. package/build/toolbar/toolbar-group/toolbar-group-container.js +3 -1
  149. package/build/toolbar/toolbar-group/toolbar-group-container.js.map +1 -1
  150. package/build/toolbar/toolbar-group/types.js +6 -0
  151. package/build/toolbar/toolbar-group/types.js.map +1 -0
  152. package/build/toolbar/toolbar-item/index.js +1 -1
  153. package/build/toolbar/toolbar-item/index.js.map +1 -1
  154. package/build/tools-panel/tools-panel/component.js +0 -1
  155. package/build/tools-panel/tools-panel/component.js.map +1 -1
  156. package/build/tools-panel/tools-panel-header/component.js +5 -1
  157. package/build/tools-panel/tools-panel-header/component.js.map +1 -1
  158. package/build/tooltip/index.js +51 -225
  159. package/build/tooltip/index.js.map +1 -1
  160. package/build/tooltip/types.js +6 -0
  161. package/build/tooltip/types.js.map +1 -0
  162. package/build/tree-select/index.js +0 -1
  163. package/build/tree-select/index.js.map +1 -1
  164. package/build/ui/context/context-connect.js.map +1 -1
  165. package/build/ui/context/wordpress-component.js.map +1 -1
  166. package/build/unit-control/index.js +0 -1
  167. package/build/unit-control/index.js.map +1 -1
  168. package/build/unit-control/styles/unit-control-styles.js +7 -7
  169. package/build/unit-control/styles/unit-control-styles.js.map +1 -1
  170. package/build/utils/colors-values.js +1 -1
  171. package/build/utils/colors-values.js.map +1 -1
  172. package/build/utils/hooks/use-cx.js +2 -1
  173. package/build/utils/hooks/use-cx.js.map +1 -1
  174. package/build/utils/use-deprecated-props.js.map +1 -1
  175. package/build/view/component.js +1 -2
  176. package/build/view/component.js.map +1 -1
  177. package/build-module/animation/index.js +1 -1
  178. package/build-module/animation/index.js.map +1 -1
  179. package/build-module/border-control/border-control-dropdown/component.js +1 -1
  180. package/build-module/border-control/border-control-dropdown/component.js.map +1 -1
  181. package/build-module/border-control/styles.js +20 -20
  182. package/build-module/border-control/styles.js.map +1 -1
  183. package/build-module/box-control/unit-control.js +1 -1
  184. package/build-module/box-control/unit-control.js.map +1 -1
  185. package/build-module/button/index.js +9 -1
  186. package/build-module/button/index.js.map +1 -1
  187. package/build-module/button/types.js.map +1 -1
  188. package/build-module/circular-option-picker/circular-option-picker-actions.js +44 -0
  189. package/build-module/circular-option-picker/circular-option-picker-actions.js.map +1 -0
  190. package/build-module/circular-option-picker/circular-option-picker-context.js +11 -0
  191. package/build-module/circular-option-picker/circular-option-picker-context.js.map +1 -0
  192. package/build-module/circular-option-picker/circular-option-picker-option-group.js +23 -0
  193. package/build-module/circular-option-picker/circular-option-picker-option-group.js.map +1 -0
  194. package/build-module/circular-option-picker/circular-option-picker-option.js +114 -0
  195. package/build-module/circular-option-picker/circular-option-picker-option.js.map +1 -0
  196. package/build-module/circular-option-picker/circular-option-picker.js +165 -0
  197. package/build-module/circular-option-picker/circular-option-picker.js.map +1 -0
  198. package/build-module/circular-option-picker/index.js +4 -132
  199. package/build-module/circular-option-picker/index.js.map +1 -1
  200. package/build-module/circular-option-picker/types.js.map +1 -1
  201. package/build-module/color-palette/index.js +58 -19
  202. package/build-module/color-palette/index.js.map +1 -1
  203. package/build-module/color-palette/types.js.map +1 -1
  204. package/build-module/color-picker/hsv-color-picker.native.js +84 -0
  205. package/build-module/color-picker/hsv-color-picker.native.js.map +1 -0
  206. package/build-module/color-picker/hue-picker.native.js +185 -0
  207. package/build-module/color-picker/hue-picker.native.js.map +1 -0
  208. package/build-module/color-picker/index.native.js +2 -1
  209. package/build-module/color-picker/index.native.js.map +1 -1
  210. package/build-module/color-picker/saturation-picker.native.js +168 -0
  211. package/build-module/color-picker/saturation-picker.native.js.map +1 -0
  212. package/build-module/combobox-control/index.js +0 -3
  213. package/build-module/combobox-control/index.js.map +1 -1
  214. package/build-module/composite/index.js +2 -0
  215. package/build-module/composite/index.js.map +1 -1
  216. package/build-module/custom-gradient-picker/gradient-bar/control-points.js.map +1 -1
  217. package/build-module/date-time/time/timezone.js +1 -1
  218. package/build-module/date-time/time/timezone.js.map +1 -1
  219. package/build-module/dropdown/index.js +12 -24
  220. package/build-module/dropdown/index.js.map +1 -1
  221. package/build-module/dropdown/types.js.map +1 -1
  222. package/build-module/dropdown-menu/index.js +7 -1
  223. package/build-module/dropdown-menu/index.js.map +1 -1
  224. package/build-module/dropdown-menu/types.js.map +1 -1
  225. package/build-module/dropdown-menu-v2/styles.js +16 -16
  226. package/build-module/dropdown-menu-v2/styles.js.map +1 -1
  227. package/build-module/duotone-picker/color-list-picker/index.js +18 -3
  228. package/build-module/duotone-picker/color-list-picker/index.js.map +1 -1
  229. package/build-module/duotone-picker/duotone-picker.js +33 -1
  230. package/build-module/duotone-picker/duotone-picker.js.map +1 -1
  231. package/build-module/duotone-picker/types.js.map +1 -1
  232. package/build-module/focusable-iframe/index.js +2 -3
  233. package/build-module/focusable-iframe/index.js.map +1 -1
  234. package/build-module/focusable-iframe/types.js +2 -0
  235. package/build-module/focusable-iframe/types.js.map +1 -0
  236. package/build-module/form-token-field/index.js +6 -2
  237. package/build-module/form-token-field/index.js.map +1 -1
  238. package/build-module/form-token-field/types.js.map +1 -1
  239. package/build-module/gradient-picker/index.js +57 -15
  240. package/build-module/gradient-picker/index.js.map +1 -1
  241. package/build-module/gradient-picker/types.js.map +1 -1
  242. package/build-module/higher-order/navigate-regions/index.js.map +1 -1
  243. package/build-module/higher-order/with-focus-outside/index.js +1 -3
  244. package/build-module/higher-order/with-focus-outside/index.js.map +1 -1
  245. package/build-module/higher-order/with-spoken-messages/index.js.map +1 -1
  246. package/build-module/index.js +1 -1
  247. package/build-module/index.js.map +1 -1
  248. package/build-module/input-control/styles/input-control-styles.js +23 -23
  249. package/build-module/input-control/styles/input-control-styles.js.map +1 -1
  250. package/build-module/item-group/item/component.js +0 -1
  251. package/build-module/item-group/item/component.js.map +1 -1
  252. package/build-module/item-group/item-group/component.js +0 -1
  253. package/build-module/item-group/item-group/component.js.map +1 -1
  254. package/build-module/menu-item/index.js +4 -2
  255. package/build-module/menu-item/index.js.map +1 -1
  256. package/build-module/menu-item/types.js.map +1 -1
  257. package/build-module/mobile/bottom-sheet/index.native.js +1 -0
  258. package/build-module/mobile/bottom-sheet/index.native.js.map +1 -1
  259. package/build-module/mobile/global-styles-context/index.native.js.map +1 -1
  260. package/build-module/mobile/link-settings/link-settings-navigation.native.js +1 -1
  261. package/build-module/mobile/link-settings/link-settings-navigation.native.js.map +1 -1
  262. package/build-module/navigation/index.js +0 -1
  263. package/build-module/navigation/index.js.map +1 -1
  264. package/build-module/navigation/use-navigation-tree-nodes.js.map +1 -1
  265. package/build-module/navigator/navigator-provider/component.js +1 -2
  266. package/build-module/navigator/navigator-provider/component.js.map +1 -1
  267. package/build-module/notice/index.js +19 -7
  268. package/build-module/notice/index.js.map +1 -1
  269. package/build-module/palette-edit/styles.js +10 -10
  270. package/build-module/palette-edit/styles.js.map +1 -1
  271. package/build-module/placeholder/index.js.map +1 -1
  272. package/build-module/popover/index.js +72 -155
  273. package/build-module/popover/index.js.map +1 -1
  274. package/build-module/popover/overlay-middlewares.js.map +1 -1
  275. package/build-module/popover/types.js.map +1 -1
  276. package/build-module/popover/utils.js +9 -83
  277. package/build-module/popover/utils.js.map +1 -1
  278. package/build-module/progress-bar/styles.js +6 -5
  279. package/build-module/progress-bar/styles.js.map +1 -1
  280. package/build-module/search-control/index.js +12 -3
  281. package/build-module/search-control/index.js.map +1 -1
  282. package/build-module/search-control/index.native.js +28 -25
  283. package/build-module/search-control/index.native.js.map +1 -1
  284. package/build-module/search-control/types.js.map +1 -1
  285. package/build-module/shortcut/index.js +13 -0
  286. package/build-module/shortcut/index.js.map +1 -1
  287. package/build-module/slot-fill/bubbles-virtually/slot-fill-context.js +3 -1
  288. package/build-module/slot-fill/bubbles-virtually/slot-fill-context.js.map +1 -1
  289. package/build-module/slot-fill/bubbles-virtually/slot.js +14 -8
  290. package/build-module/slot-fill/bubbles-virtually/slot.js.map +1 -1
  291. package/build-module/slot-fill/index.js +6 -1
  292. package/build-module/slot-fill/index.js.map +1 -1
  293. package/build-module/spinner/index.js +0 -1
  294. package/build-module/spinner/index.js.map +1 -1
  295. package/build-module/text/styles.js +7 -7
  296. package/build-module/text/styles.js.map +1 -1
  297. package/build-module/theme/index.js +0 -1
  298. package/build-module/theme/index.js.map +1 -1
  299. package/build-module/toggle-group-control/toggle-group-control/as-button-group.js +32 -47
  300. package/build-module/toggle-group-control/toggle-group-control/as-button-group.js.map +1 -1
  301. package/build-module/toggle-group-control/toggle-group-control/as-radio-group.js +41 -42
  302. package/build-module/toggle-group-control/toggle-group-control/as-radio-group.js.map +1 -1
  303. package/build-module/toggle-group-control/toggle-group-control/component.js +10 -6
  304. package/build-module/toggle-group-control/toggle-group-control/component.js.map +1 -1
  305. package/build-module/toggle-group-control/toggle-group-control/styles.js +8 -14
  306. package/build-module/toggle-group-control/toggle-group-control/styles.js.map +1 -1
  307. package/build-module/toggle-group-control/toggle-group-control/utils.js +42 -0
  308. package/build-module/toggle-group-control/toggle-group-control/utils.js.map +1 -0
  309. package/build-module/toggle-group-control/toggle-group-control-option-base/component.js +35 -16
  310. package/build-module/toggle-group-control/toggle-group-control-option-base/component.js.map +1 -1
  311. package/build-module/toggle-group-control/toggle-group-control-option-base/styles.js +8 -7
  312. package/build-module/toggle-group-control/toggle-group-control-option-base/styles.js.map +1 -1
  313. package/build-module/toggle-group-control/types.js.map +1 -1
  314. package/build-module/toolbar/toolbar/index.js +7 -1
  315. package/build-module/toolbar/toolbar/index.js.map +1 -1
  316. package/build-module/toolbar/toolbar-dropdown-menu/index.js +5 -3
  317. package/build-module/toolbar/toolbar-dropdown-menu/index.js.map +1 -1
  318. package/build-module/toolbar/toolbar-group/index.js +15 -12
  319. package/build-module/toolbar/toolbar-group/index.js.map +1 -1
  320. package/build-module/toolbar/toolbar-group/toolbar-group-collapsed.js +0 -2
  321. package/build-module/toolbar/toolbar-group/toolbar-group-collapsed.js.map +1 -1
  322. package/build-module/toolbar/toolbar-group/toolbar-group-container.js +3 -1
  323. package/build-module/toolbar/toolbar-group/toolbar-group-container.js.map +1 -1
  324. package/build-module/toolbar/toolbar-group/types.js +2 -0
  325. package/build-module/toolbar/toolbar-group/types.js.map +1 -0
  326. package/build-module/toolbar/toolbar-item/index.js +1 -1
  327. package/build-module/toolbar/toolbar-item/index.js.map +1 -1
  328. package/build-module/tools-panel/tools-panel/component.js +0 -1
  329. package/build-module/tools-panel/tools-panel/component.js.map +1 -1
  330. package/build-module/tools-panel/tools-panel-header/component.js +5 -1
  331. package/build-module/tools-panel/tools-panel-header/component.js.map +1 -1
  332. package/build-module/tooltip/index.js +53 -224
  333. package/build-module/tooltip/index.js.map +1 -1
  334. package/build-module/tooltip/types.js +2 -0
  335. package/build-module/tooltip/types.js.map +1 -0
  336. package/build-module/tree-select/index.js +0 -1
  337. package/build-module/tree-select/index.js.map +1 -1
  338. package/build-module/ui/context/context-connect.js.map +1 -1
  339. package/build-module/ui/context/wordpress-component.js.map +1 -1
  340. package/build-module/unit-control/index.js +0 -1
  341. package/build-module/unit-control/index.js.map +1 -1
  342. package/build-module/unit-control/styles/unit-control-styles.js +7 -7
  343. package/build-module/unit-control/styles/unit-control-styles.js.map +1 -1
  344. package/build-module/utils/colors-values.js +1 -1
  345. package/build-module/utils/colors-values.js.map +1 -1
  346. package/build-module/utils/hooks/use-cx.js +2 -1
  347. package/build-module/utils/hooks/use-cx.js.map +1 -1
  348. package/build-module/utils/use-deprecated-props.js.map +1 -1
  349. package/build-module/view/component.js +1 -2
  350. package/build-module/view/component.js.map +1 -1
  351. package/build-style/style-rtl.css +35 -63
  352. package/build-style/style.css +35 -63
  353. package/build-types/alignment-matrix-control/stories/index.story.d.ts +2 -2
  354. package/build-types/alignment-matrix-control/stories/index.story.d.ts.map +1 -1
  355. package/build-types/angle-picker-control/stories/index.story.d.ts +2 -2
  356. package/build-types/angle-picker-control/stories/index.story.d.ts.map +1 -1
  357. package/build-types/animate/stories/index.story.d.ts +9 -9
  358. package/build-types/animate/stories/index.story.d.ts.map +1 -1
  359. package/build-types/animation/index.d.ts +1 -1
  360. package/build-types/animation/index.d.ts.map +1 -1
  361. package/build-types/base-control/hooks.d.ts +1 -1
  362. package/build-types/base-control/stories/index.story.d.ts +4 -4
  363. package/build-types/base-control/stories/index.story.d.ts.map +1 -1
  364. package/build-types/border-box-control/border-box-control/component.d.ts +1 -1
  365. package/build-types/border-box-control/border-box-control/hook.d.ts +46 -46
  366. package/build-types/border-box-control/border-box-control-linked-button/hook.d.ts +51 -51
  367. package/build-types/border-box-control/border-box-control-split-controls/component.d.ts +1 -1
  368. package/build-types/border-box-control/border-box-control-split-controls/hook.d.ts +46 -46
  369. package/build-types/border-box-control/border-box-control-visualizer/hook.d.ts +46 -46
  370. package/build-types/border-box-control/stories/index.story.d.ts +4 -4
  371. package/build-types/border-box-control/stories/index.story.d.ts.map +1 -1
  372. package/build-types/border-control/border-control/hook.d.ts +45 -45
  373. package/build-types/border-control/border-control-dropdown/hook.d.ts +45 -45
  374. package/build-types/border-control/border-control-style-picker/hook.d.ts +45 -45
  375. package/build-types/border-control/stories/index.story.d.ts +8 -8
  376. package/build-types/border-control/stories/index.story.d.ts.map +1 -1
  377. package/build-types/box-control/styles/box-control-styles.d.ts +1 -1
  378. package/build-types/button/deprecated.d.ts +16 -22
  379. package/build-types/button/deprecated.d.ts.map +1 -1
  380. package/build-types/button/index.d.ts.map +1 -1
  381. package/build-types/button/stories/e2e/index.story.d.ts +3 -3
  382. package/build-types/button/stories/e2e/index.story.d.ts.map +1 -1
  383. package/build-types/button/stories/index.story.d.ts +10 -9
  384. package/build-types/button/stories/index.story.d.ts.map +1 -1
  385. package/build-types/button/types.d.ts +0 -4
  386. package/build-types/button/types.d.ts.map +1 -1
  387. package/build-types/button-group/stories/index.story.d.ts +3 -3
  388. package/build-types/button-group/stories/index.story.d.ts.map +1 -1
  389. package/build-types/card/card/hook.d.ts +46 -46
  390. package/build-types/card/card-body/hook.d.ts +46 -46
  391. package/build-types/card/card-divider/hook.d.ts +47 -47
  392. package/build-types/card/card-footer/hook.d.ts +46 -46
  393. package/build-types/card/card-header/hook.d.ts +46 -46
  394. package/build-types/card/card-media/hook.d.ts +46 -46
  395. package/build-types/card/stories/index.story.d.ts +4 -4
  396. package/build-types/card/stories/index.story.d.ts.map +1 -1
  397. package/build-types/checkbox-control/stories/index.story.d.ts +4 -4
  398. package/build-types/checkbox-control/stories/index.story.d.ts.map +1 -1
  399. package/build-types/circular-option-picker/circular-option-picker-actions.d.ts +7 -0
  400. package/build-types/circular-option-picker/circular-option-picker-actions.d.ts.map +1 -0
  401. package/build-types/circular-option-picker/circular-option-picker-context.d.ts +7 -0
  402. package/build-types/circular-option-picker/circular-option-picker-context.d.ts.map +1 -0
  403. package/build-types/circular-option-picker/circular-option-picker-option-group.d.ts +7 -0
  404. package/build-types/circular-option-picker/circular-option-picker-option-group.d.ts.map +1 -0
  405. package/build-types/circular-option-picker/circular-option-picker-option.d.ts +4 -0
  406. package/build-types/circular-option-picker/circular-option-picker-option.d.ts.map +1 -0
  407. package/build-types/circular-option-picker/circular-option-picker.d.ts +11 -0
  408. package/build-types/circular-option-picker/circular-option-picker.d.ts.map +1 -0
  409. package/build-types/circular-option-picker/index.d.ts +5 -56
  410. package/build-types/circular-option-picker/index.d.ts.map +1 -1
  411. package/build-types/circular-option-picker/stories/index.story.d.ts +5 -3
  412. package/build-types/circular-option-picker/stories/index.story.d.ts.map +1 -1
  413. package/build-types/circular-option-picker/test/index.d.ts +2 -0
  414. package/build-types/circular-option-picker/test/index.d.ts.map +1 -0
  415. package/build-types/circular-option-picker/types.d.ts +53 -1
  416. package/build-types/circular-option-picker/types.d.ts.map +1 -1
  417. package/build-types/color-indicator/stories/index.story.d.ts +3 -3
  418. package/build-types/color-indicator/stories/index.story.d.ts.map +1 -1
  419. package/build-types/color-palette/index.d.ts +3 -19
  420. package/build-types/color-palette/index.d.ts.map +1 -1
  421. package/build-types/color-palette/stories/index.story.d.ts +6 -39
  422. package/build-types/color-palette/stories/index.story.d.ts.map +1 -1
  423. package/build-types/color-palette/styles.d.ts +1 -1
  424. package/build-types/color-palette/types.d.ts +31 -1
  425. package/build-types/color-palette/types.d.ts.map +1 -1
  426. package/build-types/color-picker/component.d.ts +1 -1
  427. package/build-types/color-picker/stories/index.story.d.ts +3 -3
  428. package/build-types/color-picker/stories/index.story.d.ts.map +1 -1
  429. package/build-types/color-picker/styles.d.ts +6 -6
  430. package/build-types/combobox-control/index.d.ts.map +1 -1
  431. package/build-types/combobox-control/stories/index.story.d.ts +4 -4
  432. package/build-types/combobox-control/stories/index.story.d.ts.map +1 -1
  433. package/build-types/composite/index.d.ts +14 -1
  434. package/build-types/composite/index.d.ts.map +1 -1
  435. package/build-types/custom-gradient-picker/stories/index.story.d.ts +2 -2
  436. package/build-types/custom-gradient-picker/stories/index.story.d.ts.map +1 -1
  437. package/build-types/custom-gradient-picker/styles/custom-gradient-picker-styles.d.ts +2 -2
  438. package/build-types/date-time/date/styles.d.ts +3 -3
  439. package/build-types/date-time/date-time/styles.d.ts +2 -2
  440. package/build-types/date-time/stories/date-time.story.d.ts +5 -5
  441. package/build-types/date-time/stories/date-time.story.d.ts.map +1 -1
  442. package/build-types/date-time/stories/date.story.d.ts +5 -5
  443. package/build-types/date-time/stories/date.story.d.ts.map +1 -1
  444. package/build-types/date-time/stories/time.story.d.ts +3 -3
  445. package/build-types/date-time/stories/time.story.d.ts.map +1 -1
  446. package/build-types/date-time/time/styles.d.ts +12 -12
  447. package/build-types/dimension-control/stories/index.story.d.ts.map +1 -1
  448. package/build-types/disabled/stories/index.story.d.ts +4 -4
  449. package/build-types/disabled/stories/index.story.d.ts.map +1 -1
  450. package/build-types/divider/stories/index.story.d.ts +5 -5
  451. package/build-types/divider/stories/index.story.d.ts.map +1 -1
  452. package/build-types/draggable/stories/index.story.d.ts +4 -4
  453. package/build-types/draggable/stories/index.story.d.ts.map +1 -1
  454. package/build-types/drop-zone/stories/index.story.d.ts +2 -2
  455. package/build-types/drop-zone/stories/index.story.d.ts.map +1 -1
  456. package/build-types/dropdown/index.d.ts.map +1 -1
  457. package/build-types/dropdown/stories/index.story.d.ts +6 -5
  458. package/build-types/dropdown/stories/index.story.d.ts.map +1 -1
  459. package/build-types/dropdown/types.d.ts +12 -4
  460. package/build-types/dropdown/types.d.ts.map +1 -1
  461. package/build-types/dropdown-menu/index.d.ts.map +1 -1
  462. package/build-types/dropdown-menu/stories/index.story.d.ts +2 -2
  463. package/build-types/dropdown-menu/stories/index.story.d.ts.map +1 -1
  464. package/build-types/dropdown-menu/types.d.ts +22 -5
  465. package/build-types/dropdown-menu/types.d.ts.map +1 -1
  466. package/build-types/dropdown-menu-v2/stories/index.story.d.ts +2 -2
  467. package/build-types/dropdown-menu-v2/stories/index.story.d.ts.map +1 -1
  468. package/build-types/duotone-picker/color-list-picker/index.d.ts.map +1 -1
  469. package/build-types/duotone-picker/duotone-picker.d.ts +1 -1
  470. package/build-types/duotone-picker/duotone-picker.d.ts.map +1 -1
  471. package/build-types/duotone-picker/stories/duotone-picker.story.d.ts +2 -2
  472. package/build-types/duotone-picker/stories/duotone-picker.story.d.ts.map +1 -1
  473. package/build-types/duotone-picker/stories/duotone-swatch.story.d.ts +2 -2
  474. package/build-types/duotone-picker/stories/duotone-swatch.story.d.ts.map +1 -1
  475. package/build-types/duotone-picker/types.d.ts +31 -1
  476. package/build-types/duotone-picker/types.d.ts.map +1 -1
  477. package/build-types/elevation/hook.d.ts +46 -46
  478. package/build-types/elevation/stories/index.story.d.ts +5 -5
  479. package/build-types/elevation/stories/index.story.d.ts.map +1 -1
  480. package/build-types/external-link/stories/index.story.d.ts +3 -3
  481. package/build-types/external-link/stories/index.story.d.ts.map +1 -1
  482. package/build-types/external-link/styles/external-link-styles.d.ts +1 -1
  483. package/build-types/flex/flex/hook.d.ts +46 -46
  484. package/build-types/flex/flex-block/hook.d.ts +46 -46
  485. package/build-types/flex/flex-item/hook.d.ts +46 -46
  486. package/build-types/flex/stories/index.story.d.ts +4 -4
  487. package/build-types/flex/stories/index.story.d.ts.map +1 -1
  488. package/build-types/focal-point-picker/stories/index.story.d.ts +10 -10
  489. package/build-types/focal-point-picker/stories/index.story.d.ts.map +1 -1
  490. package/build-types/focal-point-picker/styles/focal-point-picker-style.d.ts +1 -1
  491. package/build-types/focusable-iframe/index.d.ts +4 -5
  492. package/build-types/focusable-iframe/index.d.ts.map +1 -1
  493. package/build-types/focusable-iframe/types.d.ts +8 -0
  494. package/build-types/focusable-iframe/types.d.ts.map +1 -0
  495. package/build-types/font-size-picker/stories/e2e/index.story.d.ts +2 -2
  496. package/build-types/font-size-picker/stories/e2e/index.story.d.ts.map +1 -1
  497. package/build-types/font-size-picker/stories/index.story.d.ts +8 -8
  498. package/build-types/font-size-picker/stories/index.story.d.ts.map +1 -1
  499. package/build-types/font-size-picker/styles.d.ts +2 -2
  500. package/build-types/form-file-upload/stories/index.story.d.ts +2 -2
  501. package/build-types/form-file-upload/stories/index.story.d.ts.map +1 -1
  502. package/build-types/form-toggle/stories/index.story.d.ts +3 -3
  503. package/build-types/form-toggle/stories/index.story.d.ts.map +1 -1
  504. package/build-types/form-token-field/index.d.ts.map +1 -1
  505. package/build-types/form-token-field/stories/index.story.d.ts +7 -7
  506. package/build-types/form-token-field/stories/index.story.d.ts.map +1 -1
  507. package/build-types/form-token-field/types.d.ts +6 -0
  508. package/build-types/form-token-field/types.d.ts.map +1 -1
  509. package/build-types/gradient-picker/index.d.ts +1 -1
  510. package/build-types/gradient-picker/index.d.ts.map +1 -1
  511. package/build-types/gradient-picker/stories/index.story.d.ts +5 -38
  512. package/build-types/gradient-picker/stories/index.story.d.ts.map +1 -1
  513. package/build-types/gradient-picker/types.d.ts +31 -1
  514. package/build-types/gradient-picker/types.d.ts.map +1 -1
  515. package/build-types/grid/hook.d.ts +46 -46
  516. package/build-types/grid/stories/index.story.d.ts +3 -3
  517. package/build-types/grid/stories/index.story.d.ts.map +1 -1
  518. package/build-types/guide/stories/index.story.d.ts +2 -2
  519. package/build-types/guide/stories/index.story.d.ts.map +1 -1
  520. package/build-types/h-stack/component.d.ts +1 -1
  521. package/build-types/h-stack/hook.d.ts +46 -46
  522. package/build-types/h-stack/stories/e2e/index.story.d.ts +3 -3
  523. package/build-types/h-stack/stories/e2e/index.story.d.ts.map +1 -1
  524. package/build-types/h-stack/stories/index.story.d.ts +3 -3
  525. package/build-types/h-stack/stories/index.story.d.ts.map +1 -1
  526. package/build-types/heading/hook.d.ts +45 -45
  527. package/build-types/heading/stories/index.story.d.ts +3 -3
  528. package/build-types/heading/stories/index.story.d.ts.map +1 -1
  529. package/build-types/higher-order/navigate-regions/index.d.ts.map +1 -1
  530. package/build-types/higher-order/with-focus-outside/index.d.ts +1 -0
  531. package/build-types/higher-order/with-focus-outside/index.d.ts.map +1 -1
  532. package/build-types/higher-order/with-focus-outside/test/index.d.ts +2 -0
  533. package/build-types/higher-order/with-focus-outside/test/index.d.ts.map +1 -0
  534. package/build-types/higher-order/with-spoken-messages/index.d.ts.map +1 -1
  535. package/build-types/icon/stories/index.story.d.ts +4 -4
  536. package/build-types/icon/stories/index.story.d.ts.map +1 -1
  537. package/build-types/index.d.ts +1 -1
  538. package/build-types/index.d.ts.map +1 -1
  539. package/build-types/input-control/stories/index.story.d.ts +2 -2
  540. package/build-types/input-control/stories/index.story.d.ts.map +1 -1
  541. package/build-types/isolated-event-container/test/index.d.ts +2 -0
  542. package/build-types/isolated-event-container/test/index.d.ts.map +1 -0
  543. package/build-types/item-group/item/component.d.ts +0 -1
  544. package/build-types/item-group/item/component.d.ts.map +1 -1
  545. package/build-types/item-group/item/hook.d.ts +46 -46
  546. package/build-types/item-group/item-group/component.d.ts +0 -1
  547. package/build-types/item-group/item-group/component.d.ts.map +1 -1
  548. package/build-types/item-group/item-group/hook.d.ts +46 -46
  549. package/build-types/item-group/stories/index.story.d.ts +6 -6
  550. package/build-types/item-group/stories/index.story.d.ts.map +1 -1
  551. package/build-types/keyboard-shortcuts/stories/index.story.d.ts +2 -2
  552. package/build-types/keyboard-shortcuts/stories/index.story.d.ts.map +1 -1
  553. package/build-types/menu-group/stories/index.story.d.ts +3 -3
  554. package/build-types/menu-group/stories/index.story.d.ts.map +1 -1
  555. package/build-types/menu-item/index.d.ts +5 -58
  556. package/build-types/menu-item/index.d.ts.map +1 -1
  557. package/build-types/menu-item/stories/index.story.d.ts +74 -0
  558. package/build-types/menu-item/stories/index.story.d.ts.map +1 -0
  559. package/build-types/menu-item/types.d.ts +3 -2
  560. package/build-types/menu-item/types.d.ts.map +1 -1
  561. package/build-types/menu-items-choice/stories/index.story.d.ts +3 -3
  562. package/build-types/menu-items-choice/stories/index.story.d.ts.map +1 -1
  563. package/build-types/modal/stories/index.story.d.ts +4 -4
  564. package/build-types/modal/stories/index.story.d.ts.map +1 -1
  565. package/build-types/navigable-container/menu.d.ts +1 -1
  566. package/build-types/navigable-container/stories/navigable-menu.story.d.ts +3 -3
  567. package/build-types/navigable-container/stories/navigable-menu.story.d.ts.map +1 -1
  568. package/build-types/navigable-container/stories/tabbable-container.story.d.ts +3 -3
  569. package/build-types/navigable-container/stories/tabbable-container.story.d.ts.map +1 -1
  570. package/build-types/navigation/back-button/index.d.ts +1 -1
  571. package/build-types/navigation/index.d.ts +0 -1
  572. package/build-types/navigation/index.d.ts.map +1 -1
  573. package/build-types/navigation/stories/index.story.d.ts +2 -2
  574. package/build-types/navigation/stories/index.story.d.ts.map +1 -1
  575. package/build-types/navigation/stories/utils/controlled-state.d.ts +2 -2
  576. package/build-types/navigation/stories/utils/controlled-state.d.ts.map +1 -1
  577. package/build-types/navigation/stories/utils/default.d.ts +2 -2
  578. package/build-types/navigation/stories/utils/default.d.ts.map +1 -1
  579. package/build-types/navigation/stories/utils/group.d.ts +2 -2
  580. package/build-types/navigation/stories/utils/group.d.ts.map +1 -1
  581. package/build-types/navigation/stories/utils/hide-if-empty.d.ts +2 -2
  582. package/build-types/navigation/stories/utils/hide-if-empty.d.ts.map +1 -1
  583. package/build-types/navigation/stories/utils/more-examples.d.ts +2 -2
  584. package/build-types/navigation/stories/utils/more-examples.d.ts.map +1 -1
  585. package/build-types/navigation/stories/utils/search.d.ts +2 -2
  586. package/build-types/navigation/stories/utils/search.d.ts.map +1 -1
  587. package/build-types/navigation/styles/navigation-styles.d.ts +5 -3
  588. package/build-types/navigation/styles/navigation-styles.d.ts.map +1 -1
  589. package/build-types/navigator/navigator-back-button/component.d.ts +2 -3
  590. package/build-types/navigator/navigator-back-button/component.d.ts.map +1 -1
  591. package/build-types/navigator/navigator-back-button/hook.d.ts +53 -54
  592. package/build-types/navigator/navigator-back-button/hook.d.ts.map +1 -1
  593. package/build-types/navigator/navigator-button/component.d.ts +2 -3
  594. package/build-types/navigator/navigator-button/component.d.ts.map +1 -1
  595. package/build-types/navigator/navigator-button/hook.d.ts +53 -54
  596. package/build-types/navigator/navigator-button/hook.d.ts.map +1 -1
  597. package/build-types/navigator/navigator-provider/component.d.ts +0 -1
  598. package/build-types/navigator/navigator-provider/component.d.ts.map +1 -1
  599. package/build-types/navigator/navigator-to-parent-button/component.d.ts +2 -3
  600. package/build-types/navigator/navigator-to-parent-button/component.d.ts.map +1 -1
  601. package/build-types/navigator/stories/index.story.d.ts +5 -5
  602. package/build-types/navigator/stories/index.story.d.ts.map +1 -1
  603. package/build-types/notice/index.d.ts.map +1 -1
  604. package/build-types/notice/stories/index.story.d.ts +3 -3
  605. package/build-types/notice/stories/index.story.d.ts.map +1 -1
  606. package/build-types/number-control/index.d.ts +3 -3
  607. package/build-types/number-control/stories/index.story.d.ts +5 -5
  608. package/build-types/number-control/stories/index.story.d.ts.map +1 -1
  609. package/build-types/palette-edit/stories/index.story.d.ts +2 -2
  610. package/build-types/palette-edit/stories/index.story.d.ts.map +1 -1
  611. package/build-types/palette-edit/styles.d.ts +4 -4
  612. package/build-types/panel/stories/index.story.d.ts +6 -6
  613. package/build-types/panel/stories/index.story.d.ts.map +1 -1
  614. package/build-types/placeholder/index.d.ts.map +1 -1
  615. package/build-types/placeholder/stories/index.story.d.ts +3 -3
  616. package/build-types/placeholder/stories/index.story.d.ts.map +1 -1
  617. package/build-types/popover/index.d.ts +1 -1
  618. package/build-types/popover/index.d.ts.map +1 -1
  619. package/build-types/popover/overlay-middlewares.d.ts +3 -3
  620. package/build-types/popover/overlay-middlewares.d.ts.map +1 -1
  621. package/build-types/popover/stories/e2e/index.story.d.ts +1 -1
  622. package/build-types/popover/stories/index.story.d.ts +7 -7
  623. package/build-types/popover/stories/index.story.d.ts.map +1 -1
  624. package/build-types/popover/types.d.ts +6 -4
  625. package/build-types/popover/types.d.ts.map +1 -1
  626. package/build-types/popover/utils.d.ts +3 -27
  627. package/build-types/popover/utils.d.ts.map +1 -1
  628. package/build-types/progress-bar/stories/index.story.d.ts +3 -3
  629. package/build-types/progress-bar/stories/index.story.d.ts.map +1 -1
  630. package/build-types/progress-bar/styles.d.ts.map +1 -1
  631. package/build-types/query-controls/stories/index.story.d.ts +4 -4
  632. package/build-types/query-controls/stories/index.story.d.ts.map +1 -1
  633. package/build-types/radio-control/stories/index.story.d.ts +3 -3
  634. package/build-types/radio-control/stories/index.story.d.ts.map +1 -1
  635. package/build-types/range-control/index.d.ts +1 -1
  636. package/build-types/range-control/stories/index.story.d.ts +9 -9
  637. package/build-types/range-control/stories/index.story.d.ts.map +1 -1
  638. package/build-types/range-control/styles/range-control-styles.d.ts +3 -3
  639. package/build-types/resizable-box/index.d.ts +1 -1
  640. package/build-types/resizable-box/resize-tooltip/index.d.ts +1 -1
  641. package/build-types/resizable-box/resize-tooltip/label.d.ts +1 -1
  642. package/build-types/resizable-box/stories/index.story.d.ts +4 -4
  643. package/build-types/resizable-box/stories/index.story.d.ts.map +1 -1
  644. package/build-types/responsive-wrapper/stories/index.story.d.ts +3 -3
  645. package/build-types/responsive-wrapper/stories/index.story.d.ts.map +1 -1
  646. package/build-types/sandbox/stories/index.story.d.ts +2 -2
  647. package/build-types/sandbox/stories/index.story.d.ts.map +1 -1
  648. package/build-types/scroll-lock/stories/index.story.d.ts +3 -3
  649. package/build-types/scroll-lock/stories/index.story.d.ts.map +1 -1
  650. package/build-types/scrollable/hook.d.ts +46 -46
  651. package/build-types/scrollable/stories/index.story.d.ts +3 -3
  652. package/build-types/scrollable/stories/index.story.d.ts.map +1 -1
  653. package/build-types/search-control/index.d.ts +4 -2
  654. package/build-types/search-control/index.d.ts.map +1 -1
  655. package/build-types/search-control/stories/index.story.d.ts +10 -6
  656. package/build-types/search-control/stories/index.story.d.ts.map +1 -1
  657. package/build-types/search-control/types.d.ts +12 -0
  658. package/build-types/search-control/types.d.ts.map +1 -1
  659. package/build-types/select-control/stories/index.story.d.ts +2 -2
  660. package/build-types/select-control/stories/index.story.d.ts.map +1 -1
  661. package/build-types/shortcut/index.d.ts +13 -0
  662. package/build-types/shortcut/index.d.ts.map +1 -1
  663. package/build-types/shortcut/stories/index.story.d.ts +13 -0
  664. package/build-types/shortcut/stories/index.story.d.ts.map +1 -0
  665. package/build-types/slot-fill/bubbles-virtually/slot-fill-context.d.ts +1 -0
  666. package/build-types/slot-fill/bubbles-virtually/slot-fill-context.d.ts.map +1 -1
  667. package/build-types/slot-fill/bubbles-virtually/slot.d.ts +1 -6
  668. package/build-types/slot-fill/index.d.ts +1 -1
  669. package/build-types/slot-fill/index.d.ts.map +1 -1
  670. package/build-types/snackbar/stories/index.story.d.ts +7 -7
  671. package/build-types/snackbar/stories/index.story.d.ts.map +1 -1
  672. package/build-types/snackbar/stories/list.story.d.ts +3 -3
  673. package/build-types/snackbar/stories/list.story.d.ts.map +1 -1
  674. package/build-types/spacer/hook.d.ts +46 -46
  675. package/build-types/spacer/stories/index.story.d.ts +3 -3
  676. package/build-types/spacer/stories/index.story.d.ts.map +1 -1
  677. package/build-types/spinner/index.d.ts +1 -2
  678. package/build-types/spinner/index.d.ts.map +1 -1
  679. package/build-types/spinner/stories/index.story.d.ts +4 -4
  680. package/build-types/spinner/stories/index.story.d.ts.map +1 -1
  681. package/build-types/surface/hook.d.ts +46 -46
  682. package/build-types/surface/stories/index.story.d.ts +3 -3
  683. package/build-types/surface/stories/index.story.d.ts.map +1 -1
  684. package/build-types/tab-panel/stories/index.story.d.ts +2 -2
  685. package/build-types/tab-panel/stories/index.story.d.ts.map +1 -1
  686. package/build-types/text/hook.d.ts +46 -46
  687. package/build-types/text/styles.d.ts.map +1 -1
  688. package/build-types/text-control/index.d.ts +3 -3
  689. package/build-types/text-control/stories/index.story.d.ts +4 -4
  690. package/build-types/text-control/stories/index.story.d.ts.map +1 -1
  691. package/build-types/text-highlight/stories/index.story.d.ts +3 -3
  692. package/build-types/text-highlight/stories/index.story.d.ts.map +1 -1
  693. package/build-types/textarea-control/stories/index.story.d.ts +3 -3
  694. package/build-types/textarea-control/stories/index.story.d.ts.map +1 -1
  695. package/build-types/theme/index.d.ts +0 -1
  696. package/build-types/theme/index.d.ts.map +1 -1
  697. package/build-types/theme/stories/index.story.d.ts +4 -4
  698. package/build-types/theme/stories/index.story.d.ts.map +1 -1
  699. package/build-types/tip/stories/index.story.d.ts +3 -3
  700. package/build-types/tip/stories/index.story.d.ts.map +1 -1
  701. package/build-types/toggle-control/stories/index.story.d.ts +4 -4
  702. package/build-types/toggle-control/stories/index.story.d.ts.map +1 -1
  703. package/build-types/toggle-group-control/stories/index.story.d.ts +6 -6
  704. package/build-types/toggle-group-control/stories/index.story.d.ts.map +1 -1
  705. package/build-types/toggle-group-control/toggle-group-control/as-button-group.d.ts +2 -4
  706. package/build-types/toggle-group-control/toggle-group-control/as-button-group.d.ts.map +1 -1
  707. package/build-types/toggle-group-control/toggle-group-control/as-radio-group.d.ts +2 -4
  708. package/build-types/toggle-group-control/toggle-group-control/as-radio-group.d.ts.map +1 -1
  709. package/build-types/toggle-group-control/toggle-group-control/component.d.ts +2 -2
  710. package/build-types/toggle-group-control/toggle-group-control/component.d.ts.map +1 -1
  711. package/build-types/toggle-group-control/toggle-group-control/styles.d.ts +1 -5
  712. package/build-types/toggle-group-control/toggle-group-control/styles.d.ts.map +1 -1
  713. package/build-types/toggle-group-control/toggle-group-control/utils.d.ts +18 -0
  714. package/build-types/toggle-group-control/toggle-group-control/utils.d.ts.map +1 -0
  715. package/build-types/toggle-group-control/toggle-group-control-option/component.d.ts +1 -1
  716. package/build-types/toggle-group-control/toggle-group-control-option-base/component.d.ts +5 -1
  717. package/build-types/toggle-group-control/toggle-group-control-option-base/component.d.ts.map +1 -1
  718. package/build-types/toggle-group-control/toggle-group-control-option-base/styles.d.ts +1 -0
  719. package/build-types/toggle-group-control/toggle-group-control-option-base/styles.d.ts.map +1 -1
  720. package/build-types/toggle-group-control/toggle-group-control-option-icon/component.d.ts +1 -1
  721. package/build-types/toggle-group-control/types.d.ts +13 -24
  722. package/build-types/toggle-group-control/types.d.ts.map +1 -1
  723. package/build-types/toolbar/stories/index.story.d.ts +2 -2
  724. package/build-types/toolbar/stories/index.story.d.ts.map +1 -1
  725. package/build-types/toolbar/toolbar/index.d.ts.map +1 -1
  726. package/build-types/toolbar/toolbar-button/index.d.ts +16 -22
  727. package/build-types/toolbar/toolbar-button/index.d.ts.map +1 -1
  728. package/build-types/toolbar/toolbar-dropdown-menu/index.d.ts +3 -1
  729. package/build-types/toolbar/toolbar-dropdown-menu/index.d.ts.map +1 -1
  730. package/build-types/toolbar/toolbar-group/index.d.ts +10 -14
  731. package/build-types/toolbar/toolbar-group/index.d.ts.map +1 -1
  732. package/build-types/toolbar/toolbar-group/toolbar-group-collapsed.d.ts +3 -5
  733. package/build-types/toolbar/toolbar-group/toolbar-group-collapsed.d.ts.map +1 -1
  734. package/build-types/toolbar/toolbar-group/toolbar-group-container.d.ts +7 -5
  735. package/build-types/toolbar/toolbar-group/toolbar-group-container.d.ts.map +1 -1
  736. package/build-types/toolbar/toolbar-group/types.d.ts +77 -0
  737. package/build-types/toolbar/toolbar-group/types.d.ts.map +1 -0
  738. package/build-types/toolbar/toolbar-item/index.d.ts.map +1 -1
  739. package/build-types/tools-panel/stories/index.story.d.ts +8 -8
  740. package/build-types/tools-panel/stories/index.story.d.ts.map +1 -1
  741. package/build-types/tools-panel/tools-panel/component.d.ts +0 -1
  742. package/build-types/tools-panel/tools-panel/component.d.ts.map +1 -1
  743. package/build-types/tools-panel/tools-panel/hook.d.ts +46 -46
  744. package/build-types/tools-panel/tools-panel-header/component.d.ts.map +1 -1
  745. package/build-types/tools-panel/tools-panel-header/hook.d.ts +46 -46
  746. package/build-types/tools-panel/tools-panel-item/hook.d.ts +46 -46
  747. package/build-types/tooltip/index.d.ts +8 -5
  748. package/build-types/tooltip/index.d.ts.map +1 -1
  749. package/build-types/tooltip/stories/index.story.d.ts +13 -0
  750. package/build-types/tooltip/stories/index.story.d.ts.map +1 -0
  751. package/build-types/tooltip/test/index.d.ts +2 -0
  752. package/build-types/tooltip/test/index.d.ts.map +1 -0
  753. package/build-types/tooltip/test/utils/index.d.ts +11 -0
  754. package/build-types/tooltip/test/utils/index.d.ts.map +1 -0
  755. package/build-types/tooltip/types.d.ts +61 -0
  756. package/build-types/tooltip/types.d.ts.map +1 -0
  757. package/build-types/tree-grid/stories/index.story.d.ts +2 -2
  758. package/build-types/tree-grid/stories/index.story.d.ts.map +1 -1
  759. package/build-types/tree-select/index.d.ts +0 -1
  760. package/build-types/tree-select/index.d.ts.map +1 -1
  761. package/build-types/tree-select/stories/index.story.d.ts +2 -2
  762. package/build-types/tree-select/stories/index.story.d.ts.map +1 -1
  763. package/build-types/truncate/hook.d.ts +46 -46
  764. package/build-types/truncate/stories/index.story.d.ts +4 -4
  765. package/build-types/truncate/stories/index.story.d.ts.map +1 -1
  766. package/build-types/ui/tooltip/content.d.ts +1 -1
  767. package/build-types/unit-control/index.d.ts +1 -2
  768. package/build-types/unit-control/index.d.ts.map +1 -1
  769. package/build-types/unit-control/stories/index.story.d.ts +7 -7
  770. package/build-types/unit-control/stories/index.story.d.ts.map +1 -1
  771. package/build-types/unit-control/styles/unit-control-styles.d.ts +3 -3
  772. package/build-types/unit-control/styles/unit-control-styles.d.ts.map +1 -1
  773. package/build-types/unit-control/unit-select-control.d.ts +1 -1
  774. package/build-types/utils/hooks/use-cx.d.ts +2 -1
  775. package/build-types/utils/hooks/use-cx.d.ts.map +1 -1
  776. package/build-types/utils/use-deprecated-props.d.ts +1 -1
  777. package/build-types/v-stack/component.d.ts +1 -1
  778. package/build-types/v-stack/hook.d.ts +46 -46
  779. package/build-types/v-stack/stories/e2e/index.story.d.ts +3 -3
  780. package/build-types/v-stack/stories/e2e/index.story.d.ts.map +1 -1
  781. package/build-types/v-stack/stories/index.story.d.ts +4 -4
  782. package/build-types/v-stack/stories/index.story.d.ts.map +1 -1
  783. package/build-types/view/component.d.ts +0 -1
  784. package/build-types/view/component.d.ts.map +1 -1
  785. package/build-types/view/stories/index.story.d.ts +3 -3
  786. package/build-types/view/stories/index.story.d.ts.map +1 -1
  787. package/build-types/visually-hidden/stories/index.story.d.ts +5 -5
  788. package/build-types/visually-hidden/stories/index.story.d.ts.map +1 -1
  789. package/build-types/z-stack/stories/index.story.d.ts +3 -3
  790. package/build-types/z-stack/stories/index.story.d.ts.map +1 -1
  791. package/package.json +20 -20
  792. package/src/alignment-matrix-control/stories/index.story.tsx +7 -3
  793. package/src/angle-picker-control/stories/index.story.tsx +3 -3
  794. package/src/animate/stories/index.story.tsx +12 -10
  795. package/src/animation/index.tsx +1 -0
  796. package/src/base-control/stories/index.story.tsx +5 -9
  797. package/src/border-box-control/stories/index.story.tsx +5 -9
  798. package/src/border-control/border-control/README.md +2 -2
  799. package/src/border-control/border-control-dropdown/component.tsx +1 -1
  800. package/src/border-control/stories/index.story.tsx +8 -14
  801. package/src/border-control/styles.ts +7 -7
  802. package/src/border-control/test/index.js +79 -69
  803. package/src/box-control/unit-control.tsx +1 -1
  804. package/src/button/README.md +0 -6
  805. package/src/button/index.tsx +9 -1
  806. package/src/button/stories/e2e/index.story.tsx +3 -3
  807. package/src/button/stories/index.story.tsx +10 -10
  808. package/src/button/test/index.tsx +19 -0
  809. package/src/button/types.ts +0 -4
  810. package/src/button-group/stories/index.story.tsx +4 -6
  811. package/src/card/stories/index.story.tsx +5 -5
  812. package/src/checkbox-control/stories/index.story.tsx +7 -6
  813. package/src/circular-option-picker/README.md +14 -0
  814. package/src/circular-option-picker/circular-option-picker-actions.tsx +60 -0
  815. package/src/circular-option-picker/circular-option-picker-context.tsx +12 -0
  816. package/src/circular-option-picker/circular-option-picker-option-group.tsx +34 -0
  817. package/src/circular-option-picker/circular-option-picker-option.tsx +139 -0
  818. package/src/circular-option-picker/circular-option-picker.tsx +202 -0
  819. package/src/circular-option-picker/index.tsx +7 -174
  820. package/src/circular-option-picker/stories/index.story.tsx +42 -5
  821. package/src/circular-option-picker/style.scss +11 -7
  822. package/src/circular-option-picker/test/index.tsx +133 -0
  823. package/src/circular-option-picker/types.ts +64 -1
  824. package/src/color-indicator/stories/index.story.tsx +4 -6
  825. package/src/color-palette/README.md +14 -0
  826. package/src/color-palette/index.tsx +69 -28
  827. package/src/color-palette/stories/index.story.tsx +24 -19
  828. package/src/color-palette/test/index.tsx +32 -30
  829. package/src/color-palette/types.ts +34 -1
  830. package/src/color-picker/hsv-color-picker.native.js +88 -0
  831. package/src/color-picker/hue-picker.native.js +194 -0
  832. package/src/color-picker/index.native.js +2 -1
  833. package/src/color-picker/saturation-picker.native.js +163 -0
  834. package/src/color-picker/stories/index.story.tsx +3 -3
  835. package/src/color-picker/style.native.scss +23 -0
  836. package/src/combobox-control/index.tsx +7 -5
  837. package/src/combobox-control/stories/index.story.tsx +3 -3
  838. package/src/composite/{index.js → index.ts} +3 -0
  839. package/src/confirm-dialog/stories/index.story.js +13 -14
  840. package/src/confirm-dialog/test/index.js +10 -18
  841. package/src/custom-gradient-picker/gradient-bar/control-points.tsx +1 -1
  842. package/src/custom-gradient-picker/gradient-bar/test/utils.ts +5 -5
  843. package/src/custom-gradient-picker/stories/index.story.tsx +3 -3
  844. package/src/date-time/stories/date-time.story.tsx +8 -10
  845. package/src/date-time/stories/date.story.tsx +8 -9
  846. package/src/date-time/stories/time.story.tsx +4 -4
  847. package/src/date-time/time/timezone.tsx +1 -1
  848. package/src/dimension-control/stories/index.story.tsx +3 -3
  849. package/src/disabled/stories/index.story.tsx +4 -4
  850. package/src/divider/stories/index.story.tsx +6 -6
  851. package/src/draggable/stories/index.story.tsx +5 -7
  852. package/src/drop-zone/stories/index.story.tsx +3 -3
  853. package/src/dropdown/README.md +13 -3
  854. package/src/dropdown/index.tsx +16 -34
  855. package/src/dropdown/stories/index.story.tsx +17 -12
  856. package/src/dropdown/types.ts +12 -4
  857. package/src/dropdown-menu/README.md +18 -0
  858. package/src/dropdown-menu/index.tsx +8 -1
  859. package/src/dropdown-menu/stories/index.story.tsx +8 -3
  860. package/src/dropdown-menu/types.ts +23 -6
  861. package/src/dropdown-menu-v2/stories/index.story.tsx +24 -10
  862. package/src/dropdown-menu-v2/styles.ts +1 -1
  863. package/src/duotone-picker/README.md +14 -0
  864. package/src/duotone-picker/color-list-picker/index.tsx +28 -12
  865. package/src/duotone-picker/duotone-picker.tsx +33 -0
  866. package/src/duotone-picker/stories/duotone-picker.story.tsx +3 -6
  867. package/src/duotone-picker/stories/duotone-swatch.story.tsx +3 -3
  868. package/src/duotone-picker/types.ts +34 -1
  869. package/src/elevation/stories/index.story.tsx +7 -7
  870. package/src/external-link/stories/index.story.tsx +4 -6
  871. package/src/flex/stories/index.story.tsx +6 -6
  872. package/src/focal-point-picker/stories/index.story.tsx +3 -3
  873. package/src/focusable-iframe/{index.js → index.tsx} +7 -4
  874. package/src/focusable-iframe/types.ts +9 -0
  875. package/src/font-size-picker/stories/e2e/index.story.tsx +3 -3
  876. package/src/font-size-picker/stories/index.story.tsx +10 -10
  877. package/src/form-file-upload/stories/index.story.tsx +3 -3
  878. package/src/form-toggle/stories/index.story.tsx +4 -7
  879. package/src/form-token-field/README.md +1 -0
  880. package/src/form-token-field/index.tsx +5 -1
  881. package/src/form-token-field/stories/index.story.tsx +10 -11
  882. package/src/form-token-field/style.scss +5 -9
  883. package/src/form-token-field/test/index.tsx +36 -1
  884. package/src/form-token-field/types.ts +7 -1
  885. package/src/gradient-picker/README.md +14 -0
  886. package/src/gradient-picker/index.tsx +60 -11
  887. package/src/gradient-picker/stories/index.story.tsx +3 -3
  888. package/src/gradient-picker/types.ts +34 -1
  889. package/src/grid/stories/index.story.tsx +4 -4
  890. package/src/guide/stories/index.story.tsx +3 -3
  891. package/src/h-stack/stories/e2e/index.story.tsx +4 -4
  892. package/src/h-stack/stories/index.story.tsx +4 -4
  893. package/src/heading/stories/index.story.tsx +3 -3
  894. package/src/higher-order/navigate-regions/index.tsx +5 -6
  895. package/src/higher-order/with-filters/test/index.tsx +36 -43
  896. package/src/higher-order/with-focus-outside/{index.js → index.tsx} +8 -5
  897. package/src/higher-order/with-focus-outside/test/{index.js → index.tsx} +13 -11
  898. package/src/higher-order/with-notices/test/index.tsx +1 -1
  899. package/src/higher-order/with-spoken-messages/index.tsx +7 -8
  900. package/src/icon/stories/index.story.tsx +5 -5
  901. package/src/index.ts +5 -1
  902. package/src/input-control/stories/index.story.tsx +5 -3
  903. package/src/input-control/styles/input-control-styles.tsx +2 -2
  904. package/src/isolated-event-container/test/{index.js → index.tsx} +1 -1
  905. package/src/item-group/item/component.tsx +0 -1
  906. package/src/item-group/item-group/component.tsx +0 -1
  907. package/src/item-group/stories/index.story.tsx +11 -12
  908. package/src/keyboard-shortcuts/stories/index.story.tsx +3 -3
  909. package/src/menu-group/stories/index.story.tsx +5 -5
  910. package/src/menu-item/README.md +1 -1
  911. package/src/menu-item/index.tsx +5 -2
  912. package/src/menu-item/stories/index.story.tsx +80 -0
  913. package/src/menu-item/types.ts +3 -2
  914. package/src/menu-items-choice/stories/index.story.tsx +4 -6
  915. package/src/mobile/bottom-sheet/index.native.js +1 -0
  916. package/src/mobile/global-styles-context/index.native.js +7 -8
  917. package/src/mobile/link-settings/link-settings-navigation.native.js +1 -1
  918. package/src/modal/stories/index.story.tsx +5 -10
  919. package/src/modal/test/index.tsx +107 -0
  920. package/src/navigable-container/stories/navigable-menu.story.tsx +3 -3
  921. package/src/navigable-container/stories/tabbable-container.story.tsx +3 -3
  922. package/src/navigation/index.tsx +0 -1
  923. package/src/navigation/stories/index.story.tsx +16 -2
  924. package/src/navigation/stories/utils/controlled-state.tsx +2 -2
  925. package/src/navigation/stories/utils/default.tsx +2 -2
  926. package/src/navigation/stories/utils/group.tsx +2 -2
  927. package/src/navigation/stories/utils/hide-if-empty.tsx +2 -2
  928. package/src/navigation/stories/utils/more-examples.tsx +2 -2
  929. package/src/navigation/stories/utils/search.tsx +2 -2
  930. package/src/navigation/use-navigation-tree-nodes.tsx +1 -1
  931. package/src/navigator/navigator-provider/component.tsx +0 -1
  932. package/src/navigator/stories/index.story.tsx +9 -10
  933. package/src/notice/index.tsx +18 -6
  934. package/src/notice/stories/index.story.tsx +6 -6
  935. package/src/notice/style.scss +0 -1
  936. package/src/notice/test/__snapshots__/index.tsx.snap +9 -1
  937. package/src/number-control/stories/index.story.tsx +3 -3
  938. package/src/palette-edit/stories/index.story.tsx +3 -3
  939. package/src/palette-edit/styles.js +2 -2
  940. package/src/panel/stories/index.story.tsx +9 -11
  941. package/src/placeholder/index.tsx +1 -0
  942. package/src/placeholder/stories/index.story.tsx +4 -6
  943. package/src/placeholder/style.scss +2 -4
  944. package/src/popover/README.md +2 -2
  945. package/src/popover/index.tsx +106 -203
  946. package/src/popover/overlay-middlewares.tsx +2 -2
  947. package/src/popover/stories/index.story.tsx +8 -10
  948. package/src/popover/test/index.tsx +18 -4
  949. package/src/popover/types.ts +6 -5
  950. package/src/popover/utils.ts +19 -118
  951. package/src/progress-bar/stories/index.story.tsx +4 -6
  952. package/src/progress-bar/styles.ts +4 -1
  953. package/src/query-controls/stories/index.story.tsx +5 -6
  954. package/src/radio-control/stories/index.story.tsx +4 -6
  955. package/src/radio-group/stories/index.story.js +1 -0
  956. package/src/range-control/stories/index.story.tsx +12 -18
  957. package/src/resizable-box/stories/index.story.tsx +3 -3
  958. package/src/responsive-wrapper/stories/index.story.tsx +4 -5
  959. package/src/sandbox/stories/index.story.tsx +3 -5
  960. package/src/scroll-lock/stories/index.story.tsx +3 -3
  961. package/src/scrollable/stories/index.story.tsx +4 -4
  962. package/src/search-control/README.md +7 -0
  963. package/src/search-control/index.native.js +39 -27
  964. package/src/search-control/index.tsx +10 -1
  965. package/src/search-control/stories/index.story.tsx +3 -3
  966. package/src/search-control/style.scss +14 -7
  967. package/src/search-control/types.ts +12 -0
  968. package/src/select-control/stories/index.story.tsx +3 -3
  969. package/src/shortcut/index.tsx +13 -0
  970. package/src/shortcut/stories/index.story.tsx +33 -0
  971. package/src/slot-fill/README.md +5 -5
  972. package/src/slot-fill/bubbles-virtually/slot-fill-context.js +3 -0
  973. package/src/slot-fill/bubbles-virtually/slot.js +17 -5
  974. package/src/slot-fill/index.js +6 -1
  975. package/src/slot-fill/stories/index.story.js +2 -0
  976. package/src/slot-fill/test/__snapshots__/slot.js.snap +12 -4
  977. package/src/snackbar/stories/index.story.tsx +10 -13
  978. package/src/snackbar/stories/list.story.tsx +3 -3
  979. package/src/spacer/stories/index.story.tsx +4 -4
  980. package/src/spinner/index.tsx +0 -1
  981. package/src/spinner/stories/index.story.tsx +5 -5
  982. package/src/surface/stories/index.story.tsx +4 -4
  983. package/src/tab-panel/stories/index.story.tsx +5 -13
  984. package/src/tab-panel/test/index.tsx +14 -25
  985. package/src/text/styles.js +2 -1
  986. package/src/text-control/stories/index.story.tsx +7 -6
  987. package/src/text-highlight/stories/index.story.tsx +4 -6
  988. package/src/textarea-control/stories/index.story.tsx +4 -6
  989. package/src/theme/README.md +5 -5
  990. package/src/theme/index.tsx +0 -1
  991. package/src/theme/stories/index.story.tsx +5 -5
  992. package/src/tip/stories/index.story.tsx +4 -4
  993. package/src/toggle-control/stories/index.story.tsx +3 -3
  994. package/src/toggle-group-control/stories/index.story.tsx +17 -11
  995. package/src/toggle-group-control/test/__snapshots__/index.tsx.snap +567 -59
  996. package/src/toggle-group-control/test/index.tsx +110 -56
  997. package/src/toggle-group-control/toggle-group-control/README.md +0 -1
  998. package/src/toggle-group-control/toggle-group-control/as-button-group.tsx +39 -57
  999. package/src/toggle-group-control/toggle-group-control/as-radio-group.tsx +52 -48
  1000. package/src/toggle-group-control/toggle-group-control/component.tsx +12 -6
  1001. package/src/toggle-group-control/toggle-group-control/styles.ts +2 -19
  1002. package/src/toggle-group-control/toggle-group-control/utils.ts +50 -0
  1003. package/src/toggle-group-control/toggle-group-control-option-base/component.tsx +70 -20
  1004. package/src/toggle-group-control/toggle-group-control-option-base/styles.ts +17 -3
  1005. package/src/toggle-group-control/types.ts +14 -32
  1006. package/src/toolbar/stories/index.story.tsx +16 -8
  1007. package/src/toolbar/test/toolbar-group.tsx +13 -7
  1008. package/src/toolbar/toolbar/index.tsx +9 -1
  1009. package/src/toolbar/toolbar-dropdown-menu/{index.js → index.tsx} +11 -4
  1010. package/src/toolbar/toolbar-group/README.md +2 -2
  1011. package/src/toolbar/toolbar-group/{index.js → index.tsx} +19 -14
  1012. package/src/toolbar/toolbar-group/{toolbar-group-collapsed.js → toolbar-group-collapsed.tsx} +10 -4
  1013. package/src/toolbar/toolbar-group/toolbar-group-container.tsx +16 -0
  1014. package/src/toolbar/toolbar-group/types.ts +92 -0
  1015. package/src/toolbar/toolbar-item/index.tsx +3 -1
  1016. package/src/tools-panel/stories/index.story.tsx +17 -12
  1017. package/src/tools-panel/tools-panel/component.tsx +0 -1
  1018. package/src/tools-panel/tools-panel-header/component.tsx +3 -0
  1019. package/src/tooltip/README.md +31 -28
  1020. package/src/tooltip/index.tsx +106 -0
  1021. package/src/tooltip/stories/index.story.tsx +59 -0
  1022. package/src/tooltip/style.scss +2 -27
  1023. package/src/tooltip/test/index.tsx +335 -0
  1024. package/src/tooltip/test/utils/index.tsx +20 -0
  1025. package/src/tooltip/types.ts +61 -0
  1026. package/src/tree-grid/stories/index.story.tsx +5 -3
  1027. package/src/tree-select/index.tsx +0 -1
  1028. package/src/tree-select/stories/index.story.tsx +3 -3
  1029. package/src/truncate/stories/index.story.tsx +5 -7
  1030. package/src/ui/context/context-connect.ts +3 -3
  1031. package/src/ui/context/wordpress-component.ts +4 -4
  1032. package/src/unit-control/index.tsx +9 -5
  1033. package/src/unit-control/stories/index.story.tsx +10 -9
  1034. package/src/unit-control/styles/unit-control-styles.ts +3 -1
  1035. package/src/unit-control/test/utils.ts +1 -1
  1036. package/src/utils/colors-values.js +1 -1
  1037. package/src/utils/hooks/use-cx.ts +2 -1
  1038. package/src/utils/use-deprecated-props.ts +1 -1
  1039. package/src/v-stack/stories/e2e/index.story.tsx +4 -4
  1040. package/src/v-stack/stories/index.story.tsx +3 -3
  1041. package/src/view/component.tsx +0 -1
  1042. package/src/view/stories/index.story.tsx +4 -4
  1043. package/src/visually-hidden/stories/index.story.tsx +7 -7
  1044. package/src/z-stack/stories/index.story.tsx +4 -4
  1045. package/tsconfig.tsbuildinfo +1 -1
  1046. package/build/popover/limit-shift.js +0 -129
  1047. package/build/popover/limit-shift.js.map +0 -1
  1048. package/build/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.js +0 -78
  1049. package/build/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.js.map +0 -1
  1050. package/build-module/popover/limit-shift.js +0 -122
  1051. package/build-module/popover/limit-shift.js.map +0 -1
  1052. package/build-module/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.js +0 -76
  1053. package/build-module/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.js.map +0 -1
  1054. package/build-types/popover/limit-shift.d.ts +0 -87
  1055. package/build-types/popover/limit-shift.d.ts.map +0 -1
  1056. package/build-types/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.d.ts +0 -9
  1057. package/build-types/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.d.ts.map +0 -1
  1058. package/src/color-palette/test/__snapshots__/index.tsx.snap +0 -288
  1059. package/src/popover/limit-shift.ts +0 -205
  1060. package/src/toggle-group-control/toggle-group-control/toggle-group-control-backdrop.tsx +0 -84
  1061. package/src/toolbar/toolbar-group/toolbar-group-container.js +0 -8
  1062. package/src/tooltip/index.js +0 -293
  1063. package/src/tooltip/stories/index.story.js +0 -85
  1064. package/src/tooltip/test/index.js +0 -323
@@ -0,0 +1,335 @@
1
+ /**
2
+ * External dependencies
3
+ */
4
+ import { render, screen, waitFor } from '@testing-library/react';
5
+ import userEvent from '@testing-library/user-event';
6
+
7
+ /**
8
+ * WordPress dependencies
9
+ */
10
+ import { shortcutAriaLabel } from '@wordpress/keycodes';
11
+
12
+ /**
13
+ * Internal dependencies
14
+ */
15
+ import Button from '../../button';
16
+ import Modal from '../../modal';
17
+ import Tooltip, { TOOLTIP_DELAY } from '..';
18
+ import cleanupTooltip from './utils/';
19
+
20
+ const props = {
21
+ children: <Button>Button</Button>,
22
+ text: 'tooltip text',
23
+ };
24
+
25
+ describe( 'Tooltip', () => {
26
+ it( 'should not render the tooltip if multiple children are passed', async () => {
27
+ render(
28
+ // expected TS error since Tooltip cannot have more than one child element
29
+ // @ts-expect-error
30
+ <Tooltip { ...props }>
31
+ <Button>This is a button</Button>
32
+ <Button>This is another button</Button>
33
+ </Tooltip>
34
+ );
35
+
36
+ expect(
37
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
38
+ ).not.toBeInTheDocument();
39
+ } );
40
+
41
+ it( 'should not render the tooltip if there is no focus', () => {
42
+ render( <Tooltip { ...props } /> );
43
+
44
+ expect(
45
+ screen.getByRole( 'button', { name: /Button/i } )
46
+ ).toBeVisible();
47
+
48
+ expect(
49
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
50
+ ).not.toBeInTheDocument();
51
+ } );
52
+
53
+ it( 'should render the tooltip when focusing on the tooltip anchor via tab', async () => {
54
+ const user = userEvent.setup();
55
+
56
+ render( <Tooltip { ...props } /> );
57
+
58
+ await user.tab();
59
+
60
+ expect(
61
+ screen.getByRole( 'button', { name: /Button/i } )
62
+ ).toHaveFocus();
63
+
64
+ expect(
65
+ await screen.findByRole( 'tooltip', { name: /tooltip text/i } )
66
+ ).toBeVisible();
67
+
68
+ await cleanupTooltip( user );
69
+ } );
70
+
71
+ it( 'should render the tooltip when the tooltip anchor is hovered', async () => {
72
+ const user = userEvent.setup();
73
+
74
+ render( <Tooltip { ...props } /> );
75
+
76
+ await user.hover( screen.getByRole( 'button', { name: /Button/i } ) );
77
+
78
+ expect(
79
+ await screen.findByRole( 'tooltip', { name: /tooltip text/i } )
80
+ ).toBeVisible();
81
+
82
+ await cleanupTooltip( user );
83
+ } );
84
+
85
+ it( 'should not show tooltip on focus as result of mouse click', async () => {
86
+ const user = userEvent.setup();
87
+
88
+ render( <Tooltip { ...props } /> );
89
+
90
+ await user.click( screen.getByRole( 'button', { name: /Button/i } ) );
91
+
92
+ expect(
93
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
94
+ ).not.toBeInTheDocument();
95
+
96
+ await cleanupTooltip( user );
97
+ } );
98
+
99
+ it( 'should respect custom delay prop when showing tooltip', async () => {
100
+ const user = userEvent.setup();
101
+ const ADDITIONAL_DELAY = 100;
102
+
103
+ render(
104
+ <Tooltip { ...props } delay={ TOOLTIP_DELAY + ADDITIONAL_DELAY } />
105
+ );
106
+
107
+ await user.hover( screen.getByRole( 'button', { name: /Button/i } ) );
108
+
109
+ // Advance time by default delay
110
+ await new Promise( ( resolve ) =>
111
+ setTimeout( resolve, TOOLTIP_DELAY )
112
+ );
113
+
114
+ // Tooltip hasn't appeared yet
115
+ expect(
116
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
117
+ ).not.toBeInTheDocument();
118
+
119
+ // wait for additional delay for tooltip to appear
120
+ await waitFor(
121
+ () =>
122
+ new Promise( ( resolve ) =>
123
+ setTimeout( resolve, ADDITIONAL_DELAY )
124
+ )
125
+ );
126
+
127
+ expect(
128
+ screen.getByRole( 'tooltip', { name: /tooltip text/i } )
129
+ ).toBeVisible();
130
+
131
+ await cleanupTooltip( user );
132
+ } );
133
+
134
+ it( 'should show tooltip when an element is disabled', async () => {
135
+ const user = userEvent.setup();
136
+
137
+ render(
138
+ <Tooltip { ...props }>
139
+ <Button aria-disabled>Button</Button>
140
+ </Tooltip>
141
+ );
142
+
143
+ const button = screen.getByRole( 'button', { name: /Button/i } );
144
+
145
+ expect( button ).toBeVisible();
146
+ expect( button ).toHaveAttribute( 'aria-disabled' );
147
+
148
+ await user.hover( button );
149
+
150
+ expect(
151
+ await screen.findByRole( 'tooltip', { name: /tooltip text/i } )
152
+ ).toBeVisible();
153
+
154
+ await cleanupTooltip( user );
155
+ } );
156
+
157
+ it( 'should not show tooltip if the mouse leaves the tooltip anchor before set delay', async () => {
158
+ const user = userEvent.setup();
159
+ const onMouseEnterMock = jest.fn();
160
+ const onMouseLeaveMock = jest.fn();
161
+ const MOUSE_LEAVE_DELAY = TOOLTIP_DELAY - 200;
162
+
163
+ render(
164
+ <>
165
+ <Tooltip { ...props }>
166
+ <Button
167
+ onMouseEnter={ onMouseEnterMock }
168
+ onMouseLeave={ onMouseLeaveMock }
169
+ >
170
+ Button 1
171
+ </Button>
172
+ </Tooltip>
173
+ <Button>Button 2</Button>
174
+ </>
175
+ );
176
+
177
+ await user.hover(
178
+ screen.getByRole( 'button', {
179
+ name: 'Button 1',
180
+ } )
181
+ );
182
+
183
+ // Tooltip hasn't appeared yet
184
+ expect(
185
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
186
+ ).not.toBeInTheDocument();
187
+ expect( onMouseEnterMock ).toHaveBeenCalledTimes( 1 );
188
+
189
+ // Advance time by MOUSE_LEAVE_DELAY time
190
+ await new Promise( ( resolve ) =>
191
+ setTimeout( resolve, MOUSE_LEAVE_DELAY )
192
+ );
193
+
194
+ expect(
195
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
196
+ ).not.toBeInTheDocument();
197
+
198
+ // Hover the other button, meaning that the mouse will leave the tooltip anchor
199
+ await user.hover(
200
+ screen.getByRole( 'button', {
201
+ name: 'Button 2',
202
+ } )
203
+ );
204
+
205
+ // Tooltip still hasn't appeared yet
206
+ expect(
207
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
208
+ ).not.toBeInTheDocument();
209
+ expect( onMouseEnterMock ).toHaveBeenCalledTimes( 1 );
210
+ expect( onMouseLeaveMock ).toHaveBeenCalledTimes( 1 );
211
+
212
+ // Advance time again, so that we reach the full TOOLTIP_DELAY time
213
+ await new Promise( ( resolve ) =>
214
+ setTimeout( resolve, TOOLTIP_DELAY )
215
+ );
216
+
217
+ // Tooltip won't show, since the mouse has left the tooltip anchor
218
+ expect(
219
+ screen.queryByRole( 'tooltip', { name: /tooltip text/i } )
220
+ ).not.toBeInTheDocument();
221
+
222
+ await cleanupTooltip( user );
223
+ } );
224
+
225
+ it( 'should render the shortcut display text when a string is passed as the shortcut', async () => {
226
+ const user = userEvent.setup();
227
+
228
+ render( <Tooltip { ...props } shortcut="shortcut text" /> );
229
+
230
+ await user.hover( screen.getByRole( 'button', { name: /Button/i } ) );
231
+
232
+ await waitFor( () =>
233
+ expect( screen.getByText( 'shortcut text' ) ).toBeVisible()
234
+ );
235
+
236
+ await cleanupTooltip( user );
237
+ } );
238
+
239
+ it( 'should render the keyboard shortcut display text and aria-label when an object is passed as the shortcut', async () => {
240
+ const user = userEvent.setup();
241
+
242
+ render(
243
+ <Tooltip
244
+ { ...props }
245
+ shortcut={ {
246
+ display: '⇧⌘,',
247
+ ariaLabel: shortcutAriaLabel.primaryShift( ',' ),
248
+ } }
249
+ />
250
+ );
251
+
252
+ await user.hover( screen.getByRole( 'button', { name: /Button/i } ) );
253
+
254
+ await waitFor( () =>
255
+ expect( screen.getByText( '⇧⌘,' ) ).toBeVisible()
256
+ );
257
+
258
+ expect( screen.getByText( '⇧⌘,' ) ).toHaveAttribute(
259
+ 'aria-label',
260
+ 'Control + Shift + Comma'
261
+ );
262
+
263
+ await cleanupTooltip( user );
264
+ } );
265
+
266
+ it( 'esc should close modal even when tooltip is visible', async () => {
267
+ const user = userEvent.setup();
268
+ const onRequestClose = jest.fn();
269
+ render(
270
+ <Modal onRequestClose={ onRequestClose }>
271
+ <p>Modal content</p>
272
+ </Modal>
273
+ );
274
+
275
+ expect(
276
+ screen.queryByRole( 'tooltip', { name: /close/i } )
277
+ ).not.toBeInTheDocument();
278
+
279
+ await user.hover(
280
+ screen.getByRole( 'button', {
281
+ name: /Close/i,
282
+ } )
283
+ );
284
+
285
+ await waitFor( () =>
286
+ expect(
287
+ screen.getByRole( 'tooltip', { name: /close/i } )
288
+ ).toBeVisible()
289
+ );
290
+
291
+ await user.keyboard( '[Escape]' );
292
+
293
+ expect( onRequestClose ).toHaveBeenCalled();
294
+
295
+ await cleanupTooltip( user );
296
+ } );
297
+
298
+ it( 'should associate the tooltip text with its anchor via the accessible description when visible', async () => {
299
+ const user = userEvent.setup();
300
+
301
+ render( <Tooltip { ...props } /> );
302
+
303
+ await user.hover(
304
+ screen.getByRole( 'button', {
305
+ name: /Button/i,
306
+ } )
307
+ );
308
+
309
+ expect(
310
+ await screen.findByRole( 'button', { description: 'tooltip text' } )
311
+ ).toBeInTheDocument();
312
+ } );
313
+
314
+ it( 'should not hide tooltip when the anchor is clicked if hideOnClick is false', async () => {
315
+ const user = userEvent.setup();
316
+
317
+ render( <Tooltip { ...props } hideOnClick={ false } /> );
318
+
319
+ const button = screen.getByRole( 'button', { name: /Button/i } );
320
+
321
+ await user.hover( button );
322
+
323
+ expect(
324
+ await screen.findByRole( 'tooltip', { name: /tooltip text/i } )
325
+ ).toBeVisible();
326
+
327
+ await user.click( button );
328
+
329
+ expect(
330
+ screen.getByRole( 'tooltip', { name: /tooltip text/i } )
331
+ ).toBeVisible();
332
+
333
+ await cleanupTooltip( user );
334
+ } );
335
+ } );
@@ -0,0 +1,20 @@
1
+ /**
2
+ * External dependencies
3
+ */
4
+ import type { UserEvent } from '@testing-library/user-event/dist/types/setup/setup';
5
+
6
+ // TODO: may need to be tested with Playwright; further context:
7
+ // https://github.com/WordPress/gutenberg/pull/52133#issuecomment-1613691258
8
+ // below workaround ensures tooltip is umounted after each test to prevent leaking
9
+ // similarly to ariakit tooltip tests: https://github.com/ariakit/ariakit/blob/249d376e41115e6d4ceba244e231a95fa457bd04/examples/tooltip/test.ts#L12-L14
10
+
11
+ /**
12
+ * Ensures the async behaviors and animations in tooltip complete
13
+ * to avoid leaking into other tests
14
+ *
15
+ */
16
+ export default async function cleanupTooltip( user: UserEvent ) {
17
+ await user.tab();
18
+ await user.tab();
19
+ await user.click( document.body );
20
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * External dependencies
3
+ */
4
+ import type { Placement } from '@floating-ui/react-dom';
5
+
6
+ /**
7
+ * Internal dependencies
8
+ */
9
+ import type { PopoverProps } from '../popover/types';
10
+ import type { ShortcutProps } from '../shortcut/types';
11
+
12
+ export type TooltipProps = {
13
+ /**
14
+ * The anchor for the tooltip.
15
+ *
16
+ * **Note**: Accepts only one child element.
17
+ */
18
+ children: React.ReactElement;
19
+ /**
20
+ * Option to hide the tooltip when the anchor is clicked.
21
+ *
22
+ * @default true
23
+ */
24
+ hideOnClick?: boolean;
25
+ /**
26
+ * The amount of time in milliseconds to wait before showing the tooltip.
27
+ *
28
+ * @default 700
29
+ */
30
+ delay?: number;
31
+ /**
32
+ * Where the tooltip should be positioned relative to its parent.
33
+ *
34
+ * @default bottom
35
+ */
36
+ placement?: Placement;
37
+ /**
38
+ * _Note: this prop is deprecated. Please use the `placement` prop instead._
39
+ *
40
+ * Legacy way of specifying the tooltip's position relative to its parent.
41
+ *
42
+ * Specify y- and x-axis as a space-separated string. Supports `"top"`,
43
+ * `"bottom"` y axis, and `"left"`, `"center"`, `"right"` x axis.
44
+ *
45
+ * @deprecated
46
+ * @default bottom
47
+ */
48
+ position?: PopoverProps[ 'position' ];
49
+ /**
50
+ * An option for adding accessible keyboard shortcuts.
51
+ *
52
+ * If shortcut is a string, it is expecting the display text. If shortcut is an
53
+ * object, it will accept the properties of `display` (string) and `ariaLabel`
54
+ * (string).
55
+ */
56
+ shortcut?: ShortcutProps[ 'shortcut' ];
57
+ /**
58
+ * The text shown in the tooltip when anchor element is focused or hovered.
59
+ */
60
+ text?: string;
61
+ };
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * External dependencies
3
3
  */
4
- import type { ComponentMeta, ComponentStory } from '@storybook/react';
4
+ import type { Meta, StoryFn } from '@storybook/react';
5
5
 
6
6
  /**
7
7
  * WordPress dependencies
@@ -15,9 +15,11 @@ import TreeGrid, { TreeGridRow, TreeGridCell } from '..';
15
15
  import { Button } from '../../button';
16
16
  import InputControl from '../../input-control';
17
17
 
18
- const meta: ComponentMeta< typeof TreeGrid > = {
18
+ const meta: Meta< typeof TreeGrid > = {
19
19
  title: 'Components (Experimental)/TreeGrid',
20
20
  component: TreeGrid,
21
+ // @ts-expect-error - See https://github.com/storybookjs/storybook/issues/23170
22
+ subcomponents: { TreeGridRow, TreeGridCell },
21
23
  argTypes: {
22
24
  children: { control: { type: null } },
23
25
  },
@@ -133,7 +135,7 @@ const Rows = ( {
133
135
  );
134
136
  };
135
137
 
136
- const Template: ComponentStory< typeof TreeGrid > = ( args ) => (
138
+ const Template: StoryFn< typeof TreeGrid > = ( args ) => (
137
139
  <TreeGrid { ...args } />
138
140
  );
139
141
 
@@ -27,7 +27,6 @@ function getSelectOptions(
27
27
  /**
28
28
  * TreeSelect component is used to generate select input fields.
29
29
  *
30
- * @example
31
30
  * ```jsx
32
31
  * import { TreeSelect } from '@wordpress/components';
33
32
  * import { useState } from '@wordpress/element';
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * External dependencies
3
3
  */
4
- import type { ComponentMeta, ComponentStory } from '@storybook/react';
4
+ import type { Meta, StoryFn } from '@storybook/react';
5
5
  import type { ComponentProps } from 'react';
6
6
  /**
7
7
  * WordPress dependencies
@@ -13,7 +13,7 @@ import { useState } from '@wordpress/element';
13
13
  */
14
14
  import TreeSelect from '../';
15
15
 
16
- const meta: ComponentMeta< typeof TreeSelect > = {
16
+ const meta: Meta< typeof TreeSelect > = {
17
17
  title: 'Components/TreeSelect',
18
18
  component: TreeSelect,
19
19
  argTypes: {
@@ -33,7 +33,7 @@ const meta: ComponentMeta< typeof TreeSelect > = {
33
33
 
34
34
  export default meta;
35
35
 
36
- const TreeSelectWithState: ComponentStory< typeof TreeSelect > = ( props ) => {
36
+ const TreeSelectWithState: StoryFn< typeof TreeSelect > = ( props ) => {
37
37
  const [ selection, setSelection ] =
38
38
  useState< ComponentProps< typeof TreeSelect >[ 'selectedId' ] >();
39
39
 
@@ -1,14 +1,14 @@
1
1
  /**
2
2
  * External dependencies
3
3
  */
4
- import type { ComponentMeta, ComponentStory } from '@storybook/react';
4
+ import type { Meta, StoryFn } from '@storybook/react';
5
5
 
6
6
  /**
7
7
  * Internal dependencies
8
8
  */
9
9
  import { Truncate } from '..';
10
10
 
11
- const meta: ComponentMeta< typeof Truncate > = {
11
+ const meta: Meta< typeof Truncate > = {
12
12
  component: Truncate,
13
13
  title: 'Components (Experimental)/Truncate',
14
14
  argTypes: {
@@ -27,19 +27,17 @@ export default meta;
27
27
  const defaultText =
28
28
  'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut facilisis dictum tortor, eu tincidunt justo scelerisque tincidunt. Duis semper dui id augue malesuada, ut feugiat nisi aliquam. Vestibulum venenatis diam sem, finibus dictum massa semper in. Nulla facilisi. Nunc vulputate faucibus diam, in lobortis arcu ornare vel. In dignissim nunc sed facilisis finibus. Etiam imperdiet mattis arcu, sed rutrum sapien blandit gravida. Aenean sollicitudin neque eget enim blandit, sit amet rutrum leo vehicula. Nunc malesuada ultricies eros ut faucibus. Aliquam erat volutpat. Nulla nec feugiat risus. Vivamus iaculis dui aliquet ante ultricies feugiat. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Vivamus nec pretium velit, sit amet consectetur ante. Praesent porttitor ex eget fermentum mattis.';
29
29
 
30
- const Template: ComponentStory< typeof Truncate > = ( args ) => {
30
+ const Template: StoryFn< typeof Truncate > = ( args ) => {
31
31
  return <Truncate { ...args } />;
32
32
  };
33
33
 
34
- export const Default: ComponentStory< typeof Truncate > = Template.bind( {} );
34
+ export const Default: StoryFn< typeof Truncate > = Template.bind( {} );
35
35
  Default.args = {
36
36
  numberOfLines: 2,
37
37
  children: defaultText,
38
38
  };
39
39
 
40
- export const CharacterCount: ComponentStory< typeof Truncate > = Template.bind(
41
- {}
42
- );
40
+ export const CharacterCount: StoryFn< typeof Truncate > = Template.bind( {} );
43
41
  CharacterCount.args = {
44
42
  limit: 23,
45
43
  children: defaultText,
@@ -18,7 +18,7 @@ import type { WordPressComponentFromProps } from '.';
18
18
 
19
19
  type AcceptsTwoArgs<
20
20
  F extends ( ...args: any ) => any,
21
- ErrorMessage = never
21
+ ErrorMessage = never,
22
22
  > = Parameters< F >[ 'length' ] extends 2 ? {} : ErrorMessage;
23
23
 
24
24
  type ContextConnectOptions = {
@@ -34,7 +34,7 @@ type ContextConnectOptions = {
34
34
  * @return The connected WordPressComponent
35
35
  */
36
36
  export function contextConnect<
37
- C extends ( props: any, ref: ForwardedRef< any > ) => JSX.Element | null
37
+ C extends ( props: any, ref: ForwardedRef< any > ) => JSX.Element | null,
38
38
  >(
39
39
  Component: C &
40
40
  AcceptsTwoArgs<
@@ -66,7 +66,7 @@ export function contextConnectWithoutRef< P >(
66
66
  // component wrappers.
67
67
  function _contextConnect<
68
68
  C extends ( props: any, ref: ForwardedRef< any > ) => JSX.Element | null,
69
- O extends ContextConnectOptions
69
+ O extends ContextConnectOptions,
70
70
  >(
71
71
  Component: C,
72
72
  namespace: string,
@@ -10,11 +10,11 @@ export type WordPressComponentProps<
10
10
  /** The HTML element to inherit props from. */
11
11
  T extends React.ElementType,
12
12
  /** Supports polymorphism through the `as` prop. */
13
- IsPolymorphic extends boolean = true
13
+ IsPolymorphic extends boolean = true,
14
14
  > = P &
15
15
  // The `children` prop is being explicitly omitted since it is otherwise implicitly added
16
16
  // by `ComponentPropsWithRef`. The context is that components should require the `children`
17
- // prop explicitely when needed (see https://github.com/WordPress/gutenberg/pull/31817).
17
+ // prop explicitly when needed (see https://github.com/WordPress/gutenberg/pull/31817).
18
18
  Omit< React.ComponentPropsWithoutRef< T >, 'as' | keyof P | 'children' > &
19
19
  ( IsPolymorphic extends true
20
20
  ? {
@@ -26,7 +26,7 @@ export type WordPressComponentProps<
26
26
  export type WordPressComponent<
27
27
  T extends React.ElementType,
28
28
  O,
29
- IsPolymorphic extends boolean
29
+ IsPolymorphic extends boolean,
30
30
  > = {
31
31
  < TT extends React.ElementType >(
32
32
  props: WordPressComponentProps< O, TT, IsPolymorphic > &
@@ -49,7 +49,7 @@ export type WordPressComponent<
49
49
 
50
50
  export type WordPressComponentFromProps<
51
51
  Props,
52
- ForwardsRef extends boolean = true
52
+ ForwardsRef extends boolean = true,
53
53
  > = Props extends WordPressComponentProps< infer P, infer T, infer I >
54
54
  ? WordPressComponent<
55
55
  T,
@@ -76,10 +76,15 @@ function UnforwardedUnitControl(
76
76
  unitsProp
77
77
  );
78
78
  const [ { value: firstUnitValue = '' } = {}, ...rest ] = list;
79
- const firstCharacters = rest.reduce( ( carry, { value } ) => {
80
- const first = escapeRegExp( value?.substring( 0, 1 ) || '' );
81
- return carry.includes( first ) ? carry : `${ carry }|${ first }`;
82
- }, escapeRegExp( firstUnitValue.substring( 0, 1 ) ) );
79
+ const firstCharacters = rest.reduce(
80
+ ( carry, { value } ) => {
81
+ const first = escapeRegExp( value?.substring( 0, 1 ) || '' );
82
+ return carry.includes( first )
83
+ ? carry
84
+ : `${ carry }|${ first }`;
85
+ },
86
+ escapeRegExp( firstUnitValue.substring( 0, 1 ) )
87
+ );
83
88
  return [ list, new RegExp( `^(?:${ firstCharacters })$`, 'i' ) ];
84
89
  }, [ nonNullValueProp, unitProp, unitsProp ] );
85
90
  const [ parsedQuantity, parsedUnit ] = getParsedQuantityAndUnit(
@@ -223,7 +228,6 @@ function UnforwardedUnitControl(
223
228
  * `UnitControl` allows the user to set a numeric quantity as well as a unit (e.g. `px`).
224
229
  *
225
230
  *
226
- * @example
227
231
  * ```jsx
228
232
  * import { __experimentalUnitControl as UnitControl } from '@wordpress/components';
229
233
  * import { useState } from '@wordpress/element';
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * External dependencies
3
3
  */
4
- import type { ComponentMeta, ComponentStory } from '@storybook/react';
4
+ import type { Meta, StoryFn } from '@storybook/react';
5
5
 
6
6
  /**
7
7
  * WordPress dependencies
@@ -14,7 +14,7 @@ import { useState } from '@wordpress/element';
14
14
  import { UnitControl } from '../';
15
15
  import { CSS_UNITS } from '../utils';
16
16
 
17
- const meta: ComponentMeta< typeof UnitControl > = {
17
+ const meta: Meta< typeof UnitControl > = {
18
18
  component: UnitControl,
19
19
  title: 'Components (Experimental)/UnitControl',
20
20
  argTypes: {
@@ -35,7 +35,7 @@ const meta: ComponentMeta< typeof UnitControl > = {
35
35
  };
36
36
  export default meta;
37
37
 
38
- const DefaultTemplate: ComponentStory< typeof UnitControl > = ( {
38
+ const DefaultTemplate: StoryFn< typeof UnitControl > = ( {
39
39
  onChange,
40
40
  ...args
41
41
  } ) => {
@@ -53,8 +53,9 @@ const DefaultTemplate: ComponentStory< typeof UnitControl > = ( {
53
53
  );
54
54
  };
55
55
 
56
- export const Default: ComponentStory< typeof UnitControl > =
57
- DefaultTemplate.bind( {} );
56
+ export const Default: StoryFn< typeof UnitControl > = DefaultTemplate.bind(
57
+ {}
58
+ );
58
59
  Default.args = {
59
60
  label: 'Label',
60
61
  };
@@ -64,7 +65,7 @@ Default.args = {
64
65
  * will not fire while a new value is typed in the input field (you can verify this
65
66
  * behavior by inspecting the console's output).
66
67
  */
67
- export const PressEnterToChange: ComponentStory< typeof UnitControl > =
68
+ export const PressEnterToChange: StoryFn< typeof UnitControl > =
68
69
  DefaultTemplate.bind( {} );
69
70
  PressEnterToChange.args = {
70
71
  ...Default.args,
@@ -75,7 +76,7 @@ PressEnterToChange.args = {
75
76
  * Most of `NumberControl`'s props can be passed to `UnitControl`, and they will
76
77
  * affect its numeric input field.
77
78
  */
78
- export const TweakingTheNumberInput: ComponentStory< typeof UnitControl > =
79
+ export const TweakingTheNumberInput: StoryFn< typeof UnitControl > =
79
80
  DefaultTemplate.bind( {} );
80
81
  TweakingTheNumberInput.args = {
81
82
  ...Default.args,
@@ -88,7 +89,7 @@ TweakingTheNumberInput.args = {
88
89
  /**
89
90
  * When only one unit is available, the unit selection dropdown becomes static text.
90
91
  */
91
- export const WithSingleUnit: ComponentStory< typeof UnitControl > =
92
+ export const WithSingleUnit: StoryFn< typeof UnitControl > =
92
93
  DefaultTemplate.bind( {} );
93
94
  WithSingleUnit.args = {
94
95
  ...Default.args,
@@ -100,7 +101,7 @@ WithSingleUnit.args = {
100
101
  * if the `isResetValueOnUnitChange` is set to `true`, the input's quantity is
101
102
  * reset to the new unit's default value.
102
103
  */
103
- export const WithCustomUnits: ComponentStory< typeof UnitControl > = ( {
104
+ export const WithCustomUnits: StoryFn< typeof UnitControl > = ( {
104
105
  onChange,
105
106
  ...args
106
107
  } ) => {