@wordpress/components 33.0.0 → 33.1.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 (817) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/build/alignment-matrix-control/cell.cjs +79 -5
  3. package/build/alignment-matrix-control/cell.cjs.map +3 -3
  4. package/build/alignment-matrix-control/index.cjs +79 -5
  5. package/build/alignment-matrix-control/index.cjs.map +3 -3
  6. package/build/angle-picker-control/angle-circle.cjs +79 -5
  7. package/build/angle-picker-control/angle-circle.cjs.map +3 -3
  8. package/build/autocomplete/autocompleter-ui.cjs.map +2 -2
  9. package/build/color-palette/index.cjs +14 -8
  10. package/build/color-palette/index.cjs.map +2 -2
  11. package/build/color-palette/utils.cjs +9 -2
  12. package/build/color-palette/utils.cjs.map +2 -2
  13. package/build/color-picker/hex-input.cjs +1 -1
  14. package/build/color-picker/hex-input.cjs.map +2 -2
  15. package/build/custom-gradient-picker/index.cjs.map +2 -2
  16. package/build/focal-point-picker/index.cjs.map +2 -2
  17. package/build/modal/index.cjs +1 -5
  18. package/build/modal/index.cjs.map +2 -2
  19. package/build/modal/use-modal-exit-animation.cjs +52 -41
  20. package/build/modal/use-modal-exit-animation.cjs.map +2 -2
  21. package/build/palette-edit/index.cjs.map +2 -2
  22. package/build/slot-fill/fill.cjs +2 -2
  23. package/build/slot-fill/fill.cjs.map +2 -2
  24. package/build/style-provider/index.cjs +82 -3
  25. package/build/style-provider/index.cjs.map +4 -4
  26. package/build/text/styles.cjs +7 -7
  27. package/build/text/styles.cjs.map +2 -2
  28. package/build/utils/config-values.cjs +3 -0
  29. package/build/utils/config-values.cjs.map +2 -2
  30. package/build/utils/dropdown-motion.cjs +2 -2
  31. package/build/utils/dropdown-motion.cjs.map +2 -2
  32. package/build-module/alignment-matrix-control/cell.mjs +79 -5
  33. package/build-module/alignment-matrix-control/cell.mjs.map +3 -3
  34. package/build-module/alignment-matrix-control/index.mjs +79 -5
  35. package/build-module/alignment-matrix-control/index.mjs.map +3 -3
  36. package/build-module/angle-picker-control/angle-circle.mjs +79 -5
  37. package/build-module/angle-picker-control/angle-circle.mjs.map +3 -3
  38. package/build-module/autocomplete/autocompleter-ui.mjs.map +2 -2
  39. package/build-module/color-palette/index.mjs +14 -8
  40. package/build-module/color-palette/index.mjs.map +2 -2
  41. package/build-module/color-palette/utils.mjs +9 -2
  42. package/build-module/color-palette/utils.mjs.map +2 -2
  43. package/build-module/color-picker/hex-input.mjs +1 -1
  44. package/build-module/color-picker/hex-input.mjs.map +2 -2
  45. package/build-module/custom-gradient-picker/index.mjs.map +2 -2
  46. package/build-module/focal-point-picker/index.mjs.map +2 -2
  47. package/build-module/modal/index.mjs +1 -5
  48. package/build-module/modal/index.mjs.map +2 -2
  49. package/build-module/modal/use-modal-exit-animation.mjs +52 -41
  50. package/build-module/modal/use-modal-exit-animation.mjs.map +2 -2
  51. package/build-module/palette-edit/index.mjs.map +2 -2
  52. package/build-module/slot-fill/fill.mjs +2 -2
  53. package/build-module/slot-fill/fill.mjs.map +2 -2
  54. package/build-module/style-provider/index.mjs +82 -3
  55. package/build-module/style-provider/index.mjs.map +4 -4
  56. package/build-module/text/styles.mjs +7 -7
  57. package/build-module/text/styles.mjs.map +2 -2
  58. package/build-module/utils/config-values.mjs +3 -0
  59. package/build-module/utils/config-values.mjs.map +2 -2
  60. package/build-module/utils/dropdown-motion.mjs +2 -2
  61. package/build-module/utils/dropdown-motion.mjs.map +2 -2
  62. package/build-style/style-rtl.css +64 -32
  63. package/build-style/style.css +64 -32
  64. package/build-types/alignment-matrix-control/icon.d.ts.map +1 -1
  65. package/build-types/alignment-matrix-control/index.d.ts.map +1 -1
  66. package/build-types/alignment-matrix-control/stories/index.story.d.ts +1 -1
  67. package/build-types/alignment-matrix-control/stories/index.story.d.ts.map +1 -1
  68. package/build-types/angle-picker-control/angle-circle.d.ts.map +1 -1
  69. package/build-types/angle-picker-control/index.d.ts +1 -1
  70. package/build-types/angle-picker-control/index.d.ts.map +1 -1
  71. package/build-types/angle-picker-control/stories/index.story.d.ts +1 -1
  72. package/build-types/angle-picker-control/stories/index.story.d.ts.map +1 -1
  73. package/build-types/animate/index.d.ts.map +1 -1
  74. package/build-types/animate/stories/index.story.d.ts.map +1 -1
  75. package/build-types/autocomplete/autocompleter-ui.d.ts +1 -1
  76. package/build-types/autocomplete/autocompleter-ui.d.ts.map +1 -1
  77. package/build-types/autocomplete/get-default-use-items.d.ts.map +1 -1
  78. package/build-types/autocomplete/index.d.ts +3 -3
  79. package/build-types/autocomplete/index.d.ts.map +1 -1
  80. package/build-types/badge/index.d.ts.map +1 -1
  81. package/build-types/badge/stories/index.story.d.ts.map +1 -1
  82. package/build-types/base-control/hooks.d.ts +4 -4
  83. package/build-types/base-control/index.d.ts +2 -2
  84. package/build-types/base-control/index.d.ts.map +1 -1
  85. package/build-types/base-control/stories/index.story.d.ts.map +1 -1
  86. package/build-types/border-box-control/border-box-control/component.d.ts +4 -4
  87. package/build-types/border-box-control/border-box-control/component.d.ts.map +1 -1
  88. package/build-types/border-box-control/border-box-control/hook.d.ts +124 -124
  89. package/build-types/border-box-control/border-box-control/hook.d.ts.map +1 -1
  90. package/build-types/border-box-control/border-box-control-linked-button/component.d.ts.map +1 -1
  91. package/build-types/border-box-control/border-box-control-linked-button/hook.d.ts +117 -117
  92. package/build-types/border-box-control/border-box-control-split-controls/component.d.ts +4 -4
  93. package/build-types/border-box-control/border-box-control-split-controls/component.d.ts.map +1 -1
  94. package/build-types/border-box-control/border-box-control-split-controls/hook.d.ts +116 -116
  95. package/build-types/border-box-control/border-box-control-visualizer/component.d.ts.map +1 -1
  96. package/build-types/border-box-control/border-box-control-visualizer/hook.d.ts +106 -106
  97. package/build-types/border-box-control/stories/index.story.d.ts +5 -5
  98. package/build-types/border-box-control/stories/index.story.d.ts.map +1 -1
  99. package/build-types/border-box-control/styles.d.ts +3 -3
  100. package/build-types/border-box-control/styles.d.ts.map +1 -1
  101. package/build-types/border-box-control/utils.d.ts.map +1 -1
  102. package/build-types/border-control/border-control/component.d.ts +5 -5
  103. package/build-types/border-control/border-control/component.d.ts.map +1 -1
  104. package/build-types/border-control/border-control/hook.d.ts +129 -129
  105. package/build-types/border-control/border-control/hook.d.ts.map +1 -1
  106. package/build-types/border-control/border-control-dropdown/component.d.ts +3 -3
  107. package/build-types/border-control/border-control-dropdown/component.d.ts.map +1 -1
  108. package/build-types/border-control/border-control-dropdown/hook.d.ts +122 -122
  109. package/build-types/border-control/border-control-dropdown/hook.d.ts.map +1 -1
  110. package/build-types/border-control/border-control-style-picker/component.d.ts +1 -1
  111. package/build-types/border-control/border-control-style-picker/component.d.ts.map +1 -1
  112. package/build-types/border-control/stories/index.story.d.ts +30 -30
  113. package/build-types/border-control/stories/index.story.d.ts.map +1 -1
  114. package/build-types/border-control/styles.d.ts +2 -2
  115. package/build-types/border-control/styles.d.ts.map +1 -1
  116. package/build-types/box-control/index.d.ts +1 -1
  117. package/build-types/box-control/index.d.ts.map +1 -1
  118. package/build-types/box-control/stories/index.story.d.ts.map +1 -1
  119. package/build-types/box-control/styles/box-control-styles.d.ts +15 -15
  120. package/build-types/box-control/styles/box-control-styles.d.ts.map +1 -1
  121. package/build-types/box-control/utils.d.ts +2 -2
  122. package/build-types/box-control/utils.d.ts.map +1 -1
  123. package/build-types/button/deprecated.d.ts +34 -34
  124. package/build-types/button/deprecated.d.ts.map +1 -1
  125. package/build-types/button/index.d.ts.map +1 -1
  126. package/build-types/button/stories/e2e/index.story.d.ts.map +1 -1
  127. package/build-types/button/stories/index.story.d.ts.map +1 -1
  128. package/build-types/button-group/index.d.ts.map +1 -1
  129. package/build-types/button-group/stories/index.story.d.ts.map +1 -1
  130. package/build-types/calendar/date-calendar/index.d.ts.map +1 -1
  131. package/build-types/calendar/date-range-calendar/index.d.ts +1 -1
  132. package/build-types/calendar/date-range-calendar/index.d.ts.map +1 -1
  133. package/build-types/calendar/stories/date-calendar.story.d.ts.map +1 -1
  134. package/build-types/calendar/stories/date-range-calendar.story.d.ts.map +1 -1
  135. package/build-types/calendar/test/__utils__/index.d.ts.map +1 -1
  136. package/build-types/calendar/utils/constants.d.ts +2 -2
  137. package/build-types/calendar/utils/constants.d.ts.map +1 -1
  138. package/build-types/calendar/utils/use-localization-props.d.ts +3 -3
  139. package/build-types/calendar/utils/use-localization-props.d.ts.map +1 -1
  140. package/build-types/card/card/component.d.ts.map +1 -1
  141. package/build-types/card/card/hook.d.ts +110 -110
  142. package/build-types/card/card-body/component.d.ts.map +1 -1
  143. package/build-types/card/card-body/hook.d.ts +107 -107
  144. package/build-types/card/card-divider/component.d.ts +2 -2
  145. package/build-types/card/card-divider/component.d.ts.map +1 -1
  146. package/build-types/card/card-divider/hook.d.ts +108 -108
  147. package/build-types/card/card-footer/component.d.ts.map +1 -1
  148. package/build-types/card/card-footer/hook.d.ts +113 -113
  149. package/build-types/card/card-header/component.d.ts.map +1 -1
  150. package/build-types/card/card-header/hook.d.ts +113 -113
  151. package/build-types/card/card-media/component.d.ts.map +1 -1
  152. package/build-types/card/card-media/hook.d.ts +106 -106
  153. package/build-types/card/get-padding-by-size.d.ts +1 -1
  154. package/build-types/card/get-padding-by-size.d.ts.map +1 -1
  155. package/build-types/card/stories/index.story.d.ts.map +1 -1
  156. package/build-types/checkbox-control/index.d.ts.map +1 -1
  157. package/build-types/checkbox-control/stories/index.story.d.ts.map +1 -1
  158. package/build-types/circular-option-picker/circular-option-picker-actions.d.ts +1 -1
  159. package/build-types/circular-option-picker/circular-option-picker-actions.d.ts.map +1 -1
  160. package/build-types/circular-option-picker/circular-option-picker.d.ts +8 -0
  161. package/build-types/circular-option-picker/circular-option-picker.d.ts.map +1 -1
  162. package/build-types/circular-option-picker/index.d.ts.map +1 -1
  163. package/build-types/circular-option-picker/stories/index.story.d.ts.map +1 -1
  164. package/build-types/color-indicator/index.d.ts +1 -1
  165. package/build-types/color-indicator/index.d.ts.map +1 -1
  166. package/build-types/color-indicator/stories/index.story.d.ts.map +1 -1
  167. package/build-types/color-palette/index.d.ts.map +1 -1
  168. package/build-types/color-palette/stories/index.story.d.ts +1 -0
  169. package/build-types/color-palette/stories/index.story.d.ts.map +1 -1
  170. package/build-types/color-palette/styles.d.ts +5 -5
  171. package/build-types/color-palette/types.d.ts +16 -2
  172. package/build-types/color-palette/types.d.ts.map +1 -1
  173. package/build-types/color-palette/utils.d.ts +1 -1
  174. package/build-types/color-palette/utils.d.ts.map +1 -1
  175. package/build-types/color-picker/color-copy-button.d.ts.map +1 -1
  176. package/build-types/color-picker/color-input.d.ts.map +1 -1
  177. package/build-types/color-picker/component.d.ts +1 -1
  178. package/build-types/color-picker/component.d.ts.map +1 -1
  179. package/build-types/color-picker/hex-input.d.ts.map +1 -1
  180. package/build-types/color-picker/hsl-input.d.ts.map +1 -1
  181. package/build-types/color-picker/input-with-slider.d.ts.map +1 -1
  182. package/build-types/color-picker/legacy-adapter.d.ts.map +1 -1
  183. package/build-types/color-picker/picker.d.ts.map +1 -1
  184. package/build-types/color-picker/rgb-input.d.ts.map +1 -1
  185. package/build-types/color-picker/stories/index.story.d.ts.map +1 -1
  186. package/build-types/color-picker/styles.d.ts +20 -20
  187. package/build-types/color-picker/styles.d.ts.map +1 -1
  188. package/build-types/combobox-control/index.d.ts.map +1 -1
  189. package/build-types/combobox-control/stories/index.story.d.ts +8 -8
  190. package/build-types/combobox-control/stories/index.story.d.ts.map +1 -1
  191. package/build-types/combobox-control/styles.d.ts +1 -1
  192. package/build-types/composite/index.d.ts +25 -25
  193. package/build-types/composite/legacy/stories/index.story.d.ts.map +1 -1
  194. package/build-types/composite/legacy/stories/utils.d.ts.map +1 -1
  195. package/build-types/composite/stories/index.story.d.ts.map +1 -1
  196. package/build-types/confirm-dialog/component.d.ts.map +1 -1
  197. package/build-types/confirm-dialog/stories/index.story.d.ts +2 -2
  198. package/build-types/confirm-dialog/stories/index.story.d.ts.map +1 -1
  199. package/build-types/context/constants.d.ts +3 -3
  200. package/build-types/context/constants.d.ts.map +1 -1
  201. package/build-types/context/context-system-provider.d.ts +4 -4
  202. package/build-types/context/context-system-provider.d.ts.map +1 -1
  203. package/build-types/context/use-context-system.d.ts +4 -4
  204. package/build-types/context/use-context-system.d.ts.map +1 -1
  205. package/build-types/context/utils.d.ts +2 -2
  206. package/build-types/context/utils.d.ts.map +1 -1
  207. package/build-types/custom-gradient-picker/constants.d.ts +2 -2
  208. package/build-types/custom-gradient-picker/constants.d.ts.map +1 -1
  209. package/build-types/custom-gradient-picker/gradient-bar/control-points.d.ts +1 -1
  210. package/build-types/custom-gradient-picker/gradient-bar/control-points.d.ts.map +1 -1
  211. package/build-types/custom-gradient-picker/gradient-bar/index.d.ts +1 -1
  212. package/build-types/custom-gradient-picker/gradient-bar/index.d.ts.map +1 -1
  213. package/build-types/custom-gradient-picker/index.d.ts +1 -1
  214. package/build-types/custom-gradient-picker/index.d.ts.map +1 -1
  215. package/build-types/custom-gradient-picker/serializer.d.ts +3 -3
  216. package/build-types/custom-gradient-picker/serializer.d.ts.map +1 -1
  217. package/build-types/custom-gradient-picker/stories/index.story.d.ts.map +1 -1
  218. package/build-types/custom-gradient-picker/styles/custom-gradient-picker-styles.d.ts +2 -2
  219. package/build-types/custom-select-control/index.d.ts.map +1 -1
  220. package/build-types/custom-select-control/stories/index.story.d.ts.map +1 -1
  221. package/build-types/custom-select-control-v2/custom-select.d.ts.map +1 -1
  222. package/build-types/custom-select-control-v2/index.d.ts.map +1 -1
  223. package/build-types/custom-select-control-v2/item.d.ts.map +1 -1
  224. package/build-types/custom-select-control-v2/stories/index.story.d.ts +6 -6
  225. package/build-types/custom-select-control-v2/stories/index.story.d.ts.map +1 -1
  226. package/build-types/custom-select-control-v2/styles.d.ts +6 -6
  227. package/build-types/dashicon/index.d.ts.map +1 -1
  228. package/build-types/date-time/date-picker/index.d.ts +1 -1
  229. package/build-types/date-time/date-picker/index.d.ts.map +1 -1
  230. package/build-types/date-time/date-picker/styles.d.ts +9 -9
  231. package/build-types/date-time/date-picker/use-lilius/index.d.ts.map +1 -1
  232. package/build-types/date-time/date-time/index.d.ts +1 -1
  233. package/build-types/date-time/date-time/index.d.ts.map +1 -1
  234. package/build-types/date-time/date-time/styles.d.ts +4 -4
  235. package/build-types/date-time/index.d.ts.map +1 -1
  236. package/build-types/date-time/stories/date-time.story.d.ts.map +1 -1
  237. package/build-types/date-time/stories/date.story.d.ts.map +1 -1
  238. package/build-types/date-time/stories/time.story.d.ts.map +1 -1
  239. package/build-types/date-time/time-picker/index.d.ts +1 -1
  240. package/build-types/date-time/time-picker/index.d.ts.map +1 -1
  241. package/build-types/date-time/time-picker/styles.d.ts +28 -28
  242. package/build-types/date-time/time-picker/time-input/index.d.ts +1 -1
  243. package/build-types/date-time/time-picker/time-input/index.d.ts.map +1 -1
  244. package/build-types/date-time/time-picker/timezone.d.ts.map +1 -1
  245. package/build-types/date-time/utils.d.ts.map +1 -1
  246. package/build-types/disabled/context.d.ts.map +1 -1
  247. package/build-types/disabled/index.d.ts +2 -0
  248. package/build-types/disabled/index.d.ts.map +1 -1
  249. package/build-types/disabled/stories/index.story.d.ts.map +1 -1
  250. package/build-types/disclosure/index.d.ts.map +1 -1
  251. package/build-types/divider/component.d.ts +2 -2
  252. package/build-types/divider/component.d.ts.map +1 -1
  253. package/build-types/divider/stories/index.story.d.ts.map +1 -1
  254. package/build-types/divider/styles.d.ts +2 -2
  255. package/build-types/draggable/index.d.ts +1 -1
  256. package/build-types/draggable/index.d.ts.map +1 -1
  257. package/build-types/draggable/stories/index.story.d.ts.map +1 -1
  258. package/build-types/drop-zone/index.d.ts.map +1 -1
  259. package/build-types/drop-zone/provider.d.ts +1 -1
  260. package/build-types/drop-zone/provider.d.ts.map +1 -1
  261. package/build-types/drop-zone/stories/index.story.d.ts +1 -1
  262. package/build-types/drop-zone/stories/index.story.d.ts.map +1 -1
  263. package/build-types/dropdown/dropdown-content-wrapper.d.ts.map +1 -1
  264. package/build-types/dropdown/index.d.ts.map +1 -1
  265. package/build-types/dropdown/stories/index.story.d.ts.map +1 -1
  266. package/build-types/dropdown-menu/index.d.ts.map +1 -1
  267. package/build-types/dropdown-menu/stories/index.story.d.ts.map +1 -1
  268. package/build-types/duotone-picker/color-list-picker/index.d.ts +1 -1
  269. package/build-types/duotone-picker/color-list-picker/index.d.ts.map +1 -1
  270. package/build-types/duotone-picker/custom-duotone-bar.d.ts +1 -1
  271. package/build-types/duotone-picker/custom-duotone-bar.d.ts.map +1 -1
  272. package/build-types/duotone-picker/duotone-picker.d.ts.map +1 -1
  273. package/build-types/duotone-picker/duotone-swatch.d.ts.map +1 -1
  274. package/build-types/duotone-picker/stories/duotone-picker.story.d.ts.map +1 -1
  275. package/build-types/duotone-picker/stories/duotone-swatch.story.d.ts.map +1 -1
  276. package/build-types/elevation/component.d.ts.map +1 -1
  277. package/build-types/elevation/hook.d.ts +105 -105
  278. package/build-types/elevation/stories/index.story.d.ts.map +1 -1
  279. package/build-types/external-link/index.d.ts.map +1 -1
  280. package/build-types/external-link/stories/index.story.d.ts.map +1 -1
  281. package/build-types/flex/context.d.ts +2 -2
  282. package/build-types/flex/flex/component.d.ts.map +1 -1
  283. package/build-types/flex/flex/hook.d.ts +108 -108
  284. package/build-types/flex/flex-block/component.d.ts.map +1 -1
  285. package/build-types/flex/flex-block/hook.d.ts +106 -106
  286. package/build-types/flex/flex-item/component.d.ts.map +1 -1
  287. package/build-types/flex/flex-item/hook.d.ts +106 -106
  288. package/build-types/flex/stories/index.story.d.ts.map +1 -1
  289. package/build-types/focal-point-picker/controls.d.ts +1 -1
  290. package/build-types/focal-point-picker/controls.d.ts.map +1 -1
  291. package/build-types/focal-point-picker/index.d.ts +16 -11
  292. package/build-types/focal-point-picker/index.d.ts.map +1 -1
  293. package/build-types/focal-point-picker/stories/index.story.d.ts +16 -16
  294. package/build-types/focal-point-picker/stories/index.story.d.ts.map +1 -1
  295. package/build-types/focal-point-picker/styles/focal-point-picker-style.d.ts +254 -254
  296. package/build-types/focal-point-picker/utils.d.ts.map +1 -1
  297. package/build-types/font-size-picker/constants.d.ts +2 -2
  298. package/build-types/font-size-picker/font-size-picker-select.d.ts.map +1 -1
  299. package/build-types/font-size-picker/font-size-picker-toggle-group.d.ts.map +1 -1
  300. package/build-types/font-size-picker/index.d.ts.map +1 -1
  301. package/build-types/font-size-picker/stories/e2e/index.story.d.ts.map +1 -1
  302. package/build-types/font-size-picker/stories/index.story.d.ts.map +1 -1
  303. package/build-types/font-size-picker/styles.d.ts +5 -5
  304. package/build-types/form-file-upload/index.d.ts.map +1 -1
  305. package/build-types/form-file-upload/stories/index.story.d.ts.map +1 -1
  306. package/build-types/form-toggle/index.d.ts +1 -1
  307. package/build-types/form-toggle/index.d.ts.map +1 -1
  308. package/build-types/form-toggle/stories/index.story.d.ts.map +1 -1
  309. package/build-types/form-token-field/index.d.ts.map +1 -1
  310. package/build-types/form-token-field/stories/index.story.d.ts.map +1 -1
  311. package/build-types/form-token-field/styles.d.ts +1 -1
  312. package/build-types/form-token-field/suggestions-list.d.ts +1 -1
  313. package/build-types/form-token-field/suggestions-list.d.ts.map +1 -1
  314. package/build-types/form-token-field/token-input.d.ts +1 -1
  315. package/build-types/form-token-field/token-input.d.ts.map +1 -1
  316. package/build-types/form-token-field/token.d.ts +1 -1
  317. package/build-types/form-token-field/token.d.ts.map +1 -1
  318. package/build-types/gradient-picker/index.d.ts.map +1 -1
  319. package/build-types/gradient-picker/stories/index.story.d.ts.map +1 -1
  320. package/build-types/grid/component.d.ts.map +1 -1
  321. package/build-types/grid/hook.d.ts +106 -106
  322. package/build-types/grid/stories/index.story.d.ts.map +1 -1
  323. package/build-types/grid/utils.d.ts.map +1 -1
  324. package/build-types/guide/index.d.ts +1 -1
  325. package/build-types/guide/index.d.ts.map +1 -1
  326. package/build-types/guide/page-control.d.ts +1 -1
  327. package/build-types/guide/page-control.d.ts.map +1 -1
  328. package/build-types/guide/stories/index.story.d.ts.map +1 -1
  329. package/build-types/h-stack/component.d.ts +3 -3
  330. package/build-types/h-stack/component.d.ts.map +1 -1
  331. package/build-types/h-stack/hook.d.ts +107 -107
  332. package/build-types/h-stack/stories/e2e/index.story.d.ts.map +1 -1
  333. package/build-types/h-stack/stories/index.story.d.ts.map +1 -1
  334. package/build-types/heading/component.d.ts +4 -4
  335. package/build-types/heading/component.d.ts.map +1 -1
  336. package/build-types/heading/hook.d.ts +107 -107
  337. package/build-types/heading/stories/index.story.d.ts.map +1 -1
  338. package/build-types/higher-order/navigate-regions/index.d.ts.map +1 -1
  339. package/build-types/higher-order/with-constrained-tabbing/index.d.ts.map +1 -1
  340. package/build-types/higher-order/with-fallback-styles/index.d.ts +1 -1
  341. package/build-types/higher-order/with-fallback-styles/index.d.ts.map +1 -1
  342. package/build-types/higher-order/with-filters/index.d.ts +2 -2
  343. package/build-types/higher-order/with-focus-outside/index.d.ts.map +1 -1
  344. package/build-types/higher-order/with-focus-return/index.d.ts.map +1 -1
  345. package/build-types/higher-order/with-notices/index.d.ts +3 -3
  346. package/build-types/higher-order/with-notices/index.d.ts.map +1 -1
  347. package/build-types/higher-order/with-spoken-messages/index.d.ts.map +1 -1
  348. package/build-types/icon/index.d.ts.map +1 -1
  349. package/build-types/icon/stories/index.story.d.ts.map +1 -1
  350. package/build-types/input-control/backdrop.d.ts.map +1 -1
  351. package/build-types/input-control/index.d.ts.map +1 -1
  352. package/build-types/input-control/input-base.d.ts.map +1 -1
  353. package/build-types/input-control/input-field.d.ts +1 -1
  354. package/build-types/input-control/input-field.d.ts.map +1 -1
  355. package/build-types/input-control/input-prefix-wrapper.d.ts.map +1 -1
  356. package/build-types/input-control/input-suffix-wrapper.d.ts.map +1 -1
  357. package/build-types/input-control/reducer/reducer.d.ts +9 -9
  358. package/build-types/input-control/reducer/reducer.d.ts.map +1 -1
  359. package/build-types/input-control/stories/index.story.d.ts.map +1 -1
  360. package/build-types/input-control/styles/input-control-styles.d.ts +3 -3
  361. package/build-types/input-control/styles/input-control-styles.d.ts.map +1 -1
  362. package/build-types/isolated-event-container/index.d.ts.map +1 -1
  363. package/build-types/item-group/item/component.d.ts.map +1 -1
  364. package/build-types/item-group/item/hook.d.ts +104 -104
  365. package/build-types/item-group/item-group/component.d.ts.map +1 -1
  366. package/build-types/item-group/item-group/hook.d.ts +105 -105
  367. package/build-types/item-group/stories/index.story.d.ts.map +1 -1
  368. package/build-types/item-group/styles.d.ts +1 -1
  369. package/build-types/item-group/styles.d.ts.map +1 -1
  370. package/build-types/keyboard-shortcuts/index.d.ts +1 -1
  371. package/build-types/keyboard-shortcuts/index.d.ts.map +1 -1
  372. package/build-types/keyboard-shortcuts/stories/index.story.d.ts.map +1 -1
  373. package/build-types/lock-unlock.d.ts +1 -2
  374. package/build-types/lock-unlock.d.ts.map +1 -1
  375. package/build-types/menu/group-label.d.ts +1 -1
  376. package/build-types/menu/group.d.ts +1 -1
  377. package/build-types/menu/index.d.ts +5 -5
  378. package/build-types/menu/index.d.ts.map +1 -1
  379. package/build-types/menu/item-help-text.d.ts +1 -1
  380. package/build-types/menu/item-label.d.ts +1 -1
  381. package/build-types/menu/separator.d.ts +1 -1
  382. package/build-types/menu/stories/index.story.d.ts.map +1 -1
  383. package/build-types/menu/styles.d.ts +7 -7
  384. package/build-types/menu-group/index.d.ts.map +1 -1
  385. package/build-types/menu-group/stories/index.story.d.ts.map +1 -1
  386. package/build-types/menu-item/index.d.ts +2 -2
  387. package/build-types/menu-item/index.d.ts.map +1 -1
  388. package/build-types/menu-item/stories/index.story.d.ts +8 -8
  389. package/build-types/menu-item/stories/index.story.d.ts.map +1 -1
  390. package/build-types/menu-items-choice/index.d.ts +1 -1
  391. package/build-types/menu-items-choice/index.d.ts.map +1 -1
  392. package/build-types/menu-items-choice/stories/index.story.d.ts.map +1 -1
  393. package/build-types/mobile/image/constants.d.ts +4 -4
  394. package/build-types/mobile/image/constants.d.ts.map +1 -1
  395. package/build-types/modal/index.d.ts.map +1 -1
  396. package/build-types/modal/stories/index.story.d.ts.map +1 -1
  397. package/build-types/modal/use-modal-exit-animation.d.ts +0 -3
  398. package/build-types/modal/use-modal-exit-animation.d.ts.map +1 -1
  399. package/build-types/navigable-container/container.d.ts +2 -2
  400. package/build-types/navigable-container/container.d.ts.map +1 -1
  401. package/build-types/navigable-container/menu.d.ts +1 -1
  402. package/build-types/navigable-container/menu.d.ts.map +1 -1
  403. package/build-types/navigable-container/stories/navigable-menu.story.d.ts.map +1 -1
  404. package/build-types/navigable-container/stories/tabbable-container.story.d.ts.map +1 -1
  405. package/build-types/navigable-container/tabbable.d.ts +2 -2
  406. package/build-types/navigable-container/tabbable.d.ts.map +1 -1
  407. package/build-types/navigation/back-button/index.d.ts.map +1 -1
  408. package/build-types/navigation/group/index.d.ts +1 -1
  409. package/build-types/navigation/group/index.d.ts.map +1 -1
  410. package/build-types/navigation/index.d.ts +1 -1
  411. package/build-types/navigation/index.d.ts.map +1 -1
  412. package/build-types/navigation/item/index.d.ts.map +1 -1
  413. package/build-types/navigation/item/use-navigation-tree-item.d.ts.map +1 -1
  414. package/build-types/navigation/menu/index.d.ts.map +1 -1
  415. package/build-types/navigation/menu/menu-title-search.d.ts.map +1 -1
  416. package/build-types/navigation/menu/menu-title.d.ts +1 -1
  417. package/build-types/navigation/menu/menu-title.d.ts.map +1 -1
  418. package/build-types/navigation/menu/search-no-results-found.d.ts +1 -1
  419. package/build-types/navigation/menu/search-no-results-found.d.ts.map +1 -1
  420. package/build-types/navigation/menu/use-navigation-tree-menu.d.ts.map +1 -1
  421. package/build-types/navigation/stories/index.story.d.ts.map +1 -1
  422. package/build-types/navigation/styles/navigation-styles.d.ts +6 -6
  423. package/build-types/navigation/utils.d.ts.map +1 -1
  424. package/build-types/navigator/index.d.ts +12 -12
  425. package/build-types/navigator/legacy.d.ts +18 -18
  426. package/build-types/navigator/navigator-back-button/component.d.ts +6 -6
  427. package/build-types/navigator/navigator-back-button/hook.d.ts +136 -136
  428. package/build-types/navigator/navigator-button/component.d.ts +6 -6
  429. package/build-types/navigator/navigator-button/hook.d.ts +136 -136
  430. package/build-types/navigator/navigator-screen/use-screen-animate-presence.d.ts +1 -1
  431. package/build-types/navigator/navigator-screen/use-screen-animate-presence.d.ts.map +1 -1
  432. package/build-types/navigator/navigator-to-parent-button/component.d.ts +6 -6
  433. package/build-types/navigator/stories/index.story.d.ts.map +1 -1
  434. package/build-types/navigator/styles.d.ts.map +1 -1
  435. package/build-types/notice/index.d.ts +1 -1
  436. package/build-types/notice/index.d.ts.map +1 -1
  437. package/build-types/notice/list.d.ts +1 -1
  438. package/build-types/notice/list.d.ts.map +1 -1
  439. package/build-types/notice/stories/index.story.d.ts.map +1 -1
  440. package/build-types/number-control/index.d.ts +7 -7
  441. package/build-types/number-control/index.d.ts.map +1 -1
  442. package/build-types/number-control/stories/index.story.d.ts +7 -7
  443. package/build-types/number-control/stories/index.story.d.ts.map +1 -1
  444. package/build-types/palette-edit/index.d.ts +1 -1
  445. package/build-types/palette-edit/index.d.ts.map +1 -1
  446. package/build-types/palette-edit/stories/index.story.d.ts.map +1 -1
  447. package/build-types/palette-edit/styles.d.ts +759 -759
  448. package/build-types/panel/body.d.ts.map +1 -1
  449. package/build-types/panel/header.d.ts.map +1 -1
  450. package/build-types/panel/index.d.ts.map +1 -1
  451. package/build-types/panel/row.d.ts.map +1 -1
  452. package/build-types/panel/stories/index.story.d.ts.map +1 -1
  453. package/build-types/placeholder/index.d.ts.map +1 -1
  454. package/build-types/placeholder/stories/index.story.d.ts.map +1 -1
  455. package/build-types/popover/index.d.ts +1 -1
  456. package/build-types/popover/index.d.ts.map +1 -1
  457. package/build-types/popover/overlay-middlewares.d.ts +2 -2
  458. package/build-types/popover/stories/e2e/index.story.d.ts +1 -1
  459. package/build-types/popover/stories/e2e/index.story.d.ts.map +1 -1
  460. package/build-types/popover/stories/index.story.d.ts.map +1 -1
  461. package/build-types/popover/test/utils/index.d.ts.map +1 -1
  462. package/build-types/popover/utils.d.ts +3 -3
  463. package/build-types/popover/utils.d.ts.map +1 -1
  464. package/build-types/progress-bar/index.d.ts +1 -1
  465. package/build-types/progress-bar/index.d.ts.map +1 -1
  466. package/build-types/progress-bar/stories/index.story.d.ts +1 -1
  467. package/build-types/progress-bar/stories/index.story.d.ts.map +1 -1
  468. package/build-types/query-controls/author-select.d.ts +1 -1
  469. package/build-types/query-controls/author-select.d.ts.map +1 -1
  470. package/build-types/query-controls/index.d.ts.map +1 -1
  471. package/build-types/query-controls/stories/index.story.d.ts.map +1 -1
  472. package/build-types/radio-control/index.d.ts.map +1 -1
  473. package/build-types/radio-control/stories/index.story.d.ts.map +1 -1
  474. package/build-types/radio-group/index.d.ts.map +1 -1
  475. package/build-types/radio-group/radio.d.ts +1 -1
  476. package/build-types/radio-group/radio.d.ts.map +1 -1
  477. package/build-types/radio-group/stories/index.story.d.ts.map +1 -1
  478. package/build-types/range-control/index.d.ts +8 -8
  479. package/build-types/range-control/index.d.ts.map +1 -1
  480. package/build-types/range-control/input-range.d.ts +1 -1
  481. package/build-types/range-control/input-range.d.ts.map +1 -1
  482. package/build-types/range-control/stories/index.story.d.ts.map +1 -1
  483. package/build-types/range-control/styles/range-control-styles.d.ts +9 -9
  484. package/build-types/range-control/styles/range-control-styles.d.ts.map +1 -1
  485. package/build-types/range-control/utils.d.ts +1 -1
  486. package/build-types/range-control/utils.d.ts.map +1 -1
  487. package/build-types/resizable-box/index.d.ts.map +1 -1
  488. package/build-types/resizable-box/resize-tooltip/index.d.ts.map +1 -1
  489. package/build-types/resizable-box/resize-tooltip/label.d.ts.map +1 -1
  490. package/build-types/resizable-box/resize-tooltip/styles/resize-tooltip.styles.d.ts +1 -1
  491. package/build-types/resizable-box/resize-tooltip/utils.d.ts +3 -3
  492. package/build-types/resizable-box/resize-tooltip/utils.d.ts.map +1 -1
  493. package/build-types/resizable-box/stories/index.story.d.ts +2 -2
  494. package/build-types/resizable-box/stories/index.story.d.ts.map +1 -1
  495. package/build-types/responsive-wrapper/index.d.ts +1 -1
  496. package/build-types/responsive-wrapper/index.d.ts.map +1 -1
  497. package/build-types/responsive-wrapper/stories/index.story.d.ts.map +1 -1
  498. package/build-types/sandbox/index.d.ts.map +1 -1
  499. package/build-types/sandbox/stories/index.story.d.ts.map +1 -1
  500. package/build-types/scroll-lock/index.d.ts.map +1 -1
  501. package/build-types/scroll-lock/stories/index.story.d.ts.map +1 -1
  502. package/build-types/scrollable/component.d.ts.map +1 -1
  503. package/build-types/scrollable/hook.d.ts +106 -106
  504. package/build-types/scrollable/stories/index.story.d.ts.map +1 -1
  505. package/build-types/search-control/index.d.ts +9 -9
  506. package/build-types/search-control/index.d.ts.map +1 -1
  507. package/build-types/search-control/stories/index.story.d.ts +9 -9
  508. package/build-types/search-control/stories/index.story.d.ts.map +1 -1
  509. package/build-types/select-control/chevron-down.d.ts.map +1 -1
  510. package/build-types/select-control/index.d.ts +1 -1
  511. package/build-types/select-control/index.d.ts.map +1 -1
  512. package/build-types/select-control/stories/index.story.d.ts.map +1 -1
  513. package/build-types/select-control/styles/select-control-styles.d.ts +2 -2
  514. package/build-types/shortcut/index.d.ts.map +1 -1
  515. package/build-types/shortcut/stories/index.story.d.ts.map +1 -1
  516. package/build-types/slot-fill/bubbles-virtually/slot.d.ts +1 -1
  517. package/build-types/slot-fill/bubbles-virtually/slot.d.ts.map +1 -1
  518. package/build-types/slot-fill/context.d.ts.map +1 -1
  519. package/build-types/slot-fill/index.d.ts +2 -2
  520. package/build-types/slot-fill/index.d.ts.map +1 -1
  521. package/build-types/slot-fill/provider.d.ts.map +1 -1
  522. package/build-types/slot-fill/slot.d.ts.map +1 -1
  523. package/build-types/slot-fill/stories/index.story.d.ts.map +1 -1
  524. package/build-types/snackbar/index.d.ts +3 -3
  525. package/build-types/snackbar/index.d.ts.map +1 -1
  526. package/build-types/snackbar/list.d.ts +1 -1
  527. package/build-types/snackbar/list.d.ts.map +1 -1
  528. package/build-types/snackbar/stories/index.story.d.ts.map +1 -1
  529. package/build-types/snackbar/stories/list.story.d.ts.map +1 -1
  530. package/build-types/spacer/component.d.ts.map +1 -1
  531. package/build-types/spacer/hook.d.ts +106 -106
  532. package/build-types/spacer/stories/index.story.d.ts.map +1 -1
  533. package/build-types/spinner/index.d.ts.map +1 -1
  534. package/build-types/spinner/stories/index.story.d.ts.map +1 -1
  535. package/build-types/style-provider/index.d.ts +0 -3
  536. package/build-types/style-provider/index.d.ts.map +1 -1
  537. package/build-types/style-provider/test/index.d.ts +2 -0
  538. package/build-types/style-provider/test/index.d.ts.map +1 -0
  539. package/build-types/surface/component.d.ts.map +1 -1
  540. package/build-types/surface/hook.d.ts +106 -106
  541. package/build-types/surface/stories/index.story.d.ts.map +1 -1
  542. package/build-types/surface/styles.d.ts +1 -1
  543. package/build-types/surface/styles.d.ts.map +1 -1
  544. package/build-types/tab-panel/index.d.ts.map +1 -1
  545. package/build-types/tab-panel/stories/index.story.d.ts.map +1 -1
  546. package/build-types/tabs/index.d.ts +1 -1
  547. package/build-types/tabs/stories/index.story.d.ts.map +1 -1
  548. package/build-types/tabs/styles.d.ts +3 -3
  549. package/build-types/tabs/tablist.d.ts +1 -1
  550. package/build-types/text/component.d.ts.map +1 -1
  551. package/build-types/text/hook.d.ts +106 -106
  552. package/build-types/text/stories/index.story.d.ts +3 -3
  553. package/build-types/text/stories/index.story.d.ts.map +1 -1
  554. package/build-types/text/utils.d.ts +1 -1
  555. package/build-types/text/utils.d.ts.map +1 -1
  556. package/build-types/text-control/index.d.ts +3 -3
  557. package/build-types/text-control/index.d.ts.map +1 -1
  558. package/build-types/text-control/stories/index.story.d.ts.map +1 -1
  559. package/build-types/text-highlight/index.d.ts +4 -19
  560. package/build-types/text-highlight/index.d.ts.map +1 -1
  561. package/build-types/text-highlight/stories/index.story.d.ts.map +1 -1
  562. package/build-types/textarea-control/index.d.ts +3 -3
  563. package/build-types/textarea-control/index.d.ts.map +1 -1
  564. package/build-types/textarea-control/stories/index.story.d.ts.map +1 -1
  565. package/build-types/theme/color-algorithms.d.ts +1 -1
  566. package/build-types/theme/color-algorithms.d.ts.map +1 -1
  567. package/build-types/theme/index.d.ts.map +1 -1
  568. package/build-types/theme/stories/index.story.d.ts +1 -1
  569. package/build-types/theme/stories/index.story.d.ts.map +1 -1
  570. package/build-types/theme/styles.d.ts.map +1 -1
  571. package/build-types/tip/index.d.ts.map +1 -1
  572. package/build-types/tip/stories/index.story.d.ts.map +1 -1
  573. package/build-types/toggle-control/index.d.ts +2 -2
  574. package/build-types/toggle-control/index.d.ts.map +1 -1
  575. package/build-types/toggle-control/stories/index.story.d.ts +4 -4
  576. package/build-types/toggle-control/stories/index.story.d.ts.map +1 -1
  577. package/build-types/toggle-group-control/context.d.ts.map +1 -1
  578. package/build-types/toggle-group-control/stories/index.story.d.ts.map +1 -1
  579. package/build-types/toggle-group-control/toggle-group-control/as-button-group.d.ts +1 -1
  580. package/build-types/toggle-group-control/toggle-group-control/as-radio-group.d.ts +1 -1
  581. package/build-types/toggle-group-control/toggle-group-control/component.d.ts +2 -2
  582. package/build-types/toggle-group-control/toggle-group-control/component.d.ts.map +1 -1
  583. package/build-types/toggle-group-control/toggle-group-control/styles.d.ts +3 -3
  584. package/build-types/toggle-group-control/toggle-group-control/styles.d.ts.map +1 -1
  585. package/build-types/toggle-group-control/toggle-group-control-option/component.d.ts +2 -2
  586. package/build-types/toggle-group-control/toggle-group-control-option/component.d.ts.map +1 -1
  587. package/build-types/toggle-group-control/toggle-group-control-option-base/component.d.ts +1 -1
  588. package/build-types/toggle-group-control/toggle-group-control-option-base/component.d.ts.map +1 -1
  589. package/build-types/toggle-group-control/toggle-group-control-option-base/styles.d.ts +1 -1
  590. package/build-types/toggle-group-control/toggle-group-control-option-base/styles.d.ts.map +1 -1
  591. package/build-types/toggle-group-control/toggle-group-control-option-icon/component.d.ts +1 -1
  592. package/build-types/toggle-group-control/toggle-group-control-option-icon/component.d.ts.map +1 -1
  593. package/build-types/toolbar/index.d.ts +6 -6
  594. package/build-types/toolbar/index.d.ts.map +1 -1
  595. package/build-types/toolbar/stories/index.story.d.ts.map +1 -1
  596. package/build-types/toolbar/toolbar/index.d.ts.map +1 -1
  597. package/build-types/toolbar/toolbar/toolbar-container.d.ts.map +1 -1
  598. package/build-types/toolbar/toolbar-button/index.d.ts.map +1 -1
  599. package/build-types/toolbar/toolbar-button/toolbar-button-container.d.ts.map +1 -1
  600. package/build-types/toolbar/toolbar-context/index.d.ts.map +1 -1
  601. package/build-types/toolbar/toolbar-dropdown-menu/index.d.ts.map +1 -1
  602. package/build-types/toolbar/toolbar-group/index.d.ts.map +1 -1
  603. package/build-types/toolbar/toolbar-group/toolbar-group-collapsed.d.ts.map +1 -1
  604. package/build-types/toolbar/toolbar-group/toolbar-group-container.d.ts +1 -1
  605. package/build-types/toolbar/toolbar-group/toolbar-group-container.d.ts.map +1 -1
  606. package/build-types/toolbar/toolbar-item/index.d.ts.map +1 -1
  607. package/build-types/tools-panel/stories/index.story.d.ts.map +1 -1
  608. package/build-types/tools-panel/styles.d.ts.map +1 -1
  609. package/build-types/tools-panel/tools-panel/component.d.ts.map +1 -1
  610. package/build-types/tools-panel/tools-panel/hook.d.ts +128 -128
  611. package/build-types/tools-panel/tools-panel/hook.d.ts.map +1 -1
  612. package/build-types/tools-panel/tools-panel-header/component.d.ts.map +1 -1
  613. package/build-types/tools-panel/tools-panel-header/hook.d.ts +116 -116
  614. package/build-types/tools-panel/tools-panel-item/component.d.ts.map +1 -1
  615. package/build-types/tools-panel/tools-panel-item/hook.d.ts +108 -108
  616. package/build-types/tooltip/index.d.ts.map +1 -1
  617. package/build-types/tooltip/stories/index.story.d.ts.map +1 -1
  618. package/build-types/tree-grid/cell.d.ts.map +1 -1
  619. package/build-types/tree-grid/index.d.ts.map +1 -1
  620. package/build-types/tree-grid/item.d.ts.map +1 -1
  621. package/build-types/tree-grid/roving-tab-index-item.d.ts.map +1 -1
  622. package/build-types/tree-grid/roving-tab-index.d.ts +1 -1
  623. package/build-types/tree-grid/roving-tab-index.d.ts.map +1 -1
  624. package/build-types/tree-grid/row.d.ts.map +1 -1
  625. package/build-types/tree-grid/stories/index.story.d.ts.map +1 -1
  626. package/build-types/tree-select/index.d.ts.map +1 -1
  627. package/build-types/tree-select/stories/index.story.d.ts.map +1 -1
  628. package/build-types/truncate/component.d.ts.map +1 -1
  629. package/build-types/truncate/hook.d.ts +106 -106
  630. package/build-types/truncate/stories/index.story.d.ts.map +1 -1
  631. package/build-types/truncate/utils.d.ts +5 -5
  632. package/build-types/truncate/utils.d.ts.map +1 -1
  633. package/build-types/unit-control/index.d.ts +2 -2
  634. package/build-types/unit-control/index.d.ts.map +1 -1
  635. package/build-types/unit-control/stories/index.story.d.ts.map +1 -1
  636. package/build-types/unit-control/styles/unit-control-styles.d.ts +7 -7
  637. package/build-types/unit-control/unit-select-control.d.ts +1 -1
  638. package/build-types/unit-control/unit-select-control.d.ts.map +1 -1
  639. package/build-types/unit-control/utils.d.ts.map +1 -1
  640. package/build-types/utils/breakpoint-values.d.ts.map +1 -1
  641. package/build-types/utils/breakpoint.d.ts +8 -1
  642. package/build-types/utils/breakpoint.d.ts.map +1 -1
  643. package/build-types/utils/colors-values.d.ts +1 -1
  644. package/build-types/utils/colors-values.d.ts.map +1 -1
  645. package/build-types/utils/colors.d.ts +3 -3
  646. package/build-types/utils/colors.d.ts.map +1 -1
  647. package/build-types/utils/deprecated-36px-size.d.ts +1 -1
  648. package/build-types/utils/deprecated-36px-size.d.ts.map +1 -1
  649. package/build-types/utils/dropdown-motion.d.ts +3 -3
  650. package/build-types/utils/dropdown-motion.d.ts.map +1 -1
  651. package/build-types/utils/font-values.d.ts.map +1 -1
  652. package/build-types/utils/font.d.ts +5 -2
  653. package/build-types/utils/font.d.ts.map +1 -1
  654. package/build-types/utils/get-node-text.d.ts.map +1 -1
  655. package/build-types/utils/hooks/index.d.ts +4 -4
  656. package/build-types/utils/hooks/index.d.ts.map +1 -1
  657. package/build-types/utils/hooks/use-animated-offset-rect.d.ts +1 -1
  658. package/build-types/utils/hooks/use-animated-offset-rect.d.ts.map +1 -1
  659. package/build-types/utils/hooks/use-controlled-state.d.ts +2 -8
  660. package/build-types/utils/hooks/use-controlled-state.d.ts.map +1 -1
  661. package/build-types/utils/hooks/use-controlled-value.d.ts +1 -1
  662. package/build-types/utils/hooks/use-controlled-value.d.ts.map +1 -1
  663. package/build-types/utils/hooks/use-update-effect.d.ts +1 -1
  664. package/build-types/utils/hooks/use-update-effect.d.ts.map +1 -1
  665. package/build-types/utils/index.d.ts +2 -2
  666. package/build-types/utils/index.d.ts.map +1 -1
  667. package/build-types/utils/math.d.ts +5 -5
  668. package/build-types/utils/math.d.ts.map +1 -1
  669. package/build-types/utils/rtl.d.ts +11 -16
  670. package/build-types/utils/rtl.d.ts.map +1 -1
  671. package/build-types/utils/strings.d.ts.map +1 -1
  672. package/build-types/utils/style-mixins.d.ts +9 -9
  673. package/build-types/utils/style-mixins.d.ts.map +1 -1
  674. package/build-types/utils/use-responsive-value.d.ts.map +1 -1
  675. package/build-types/utils/values.d.ts +19 -5
  676. package/build-types/utils/values.d.ts.map +1 -1
  677. package/build-types/utils/with-ignore-ime-events.d.ts.map +1 -1
  678. package/build-types/v-stack/component.d.ts +3 -3
  679. package/build-types/v-stack/component.d.ts.map +1 -1
  680. package/build-types/v-stack/hook.d.ts +107 -107
  681. package/build-types/v-stack/stories/e2e/index.story.d.ts.map +1 -1
  682. package/build-types/v-stack/stories/index.story.d.ts +4 -4
  683. package/build-types/v-stack/stories/index.story.d.ts.map +1 -1
  684. package/build-types/validated-form-controls/components/checkbox-control.d.ts +2 -2
  685. package/build-types/validated-form-controls/components/combobox-control.d.ts +2 -2
  686. package/build-types/validated-form-controls/components/number-control.d.ts +7 -7
  687. package/build-types/validated-form-controls/components/radio-control.d.ts +2 -2
  688. package/build-types/validated-form-controls/components/radio-control.d.ts.map +1 -1
  689. package/build-types/validated-form-controls/components/range-control.d.ts +8 -8
  690. package/build-types/validated-form-controls/components/range-control.d.ts.map +1 -1
  691. package/build-types/validated-form-controls/components/select-control.d.ts +1 -1
  692. package/build-types/validated-form-controls/components/stories/checkbox-control.story.d.ts.map +1 -1
  693. package/build-types/validated-form-controls/components/stories/combobox-control.story.d.ts.map +1 -1
  694. package/build-types/validated-form-controls/components/stories/custom-select-control.story.d.ts.map +1 -1
  695. package/build-types/validated-form-controls/components/stories/form-token-field.story.d.ts.map +1 -1
  696. package/build-types/validated-form-controls/components/stories/input-control.story.d.ts.map +1 -1
  697. package/build-types/validated-form-controls/components/stories/number-control.story.d.ts.map +1 -1
  698. package/build-types/validated-form-controls/components/stories/overview.story.d.ts.map +1 -1
  699. package/build-types/validated-form-controls/components/stories/radio-control.story.d.ts.map +1 -1
  700. package/build-types/validated-form-controls/components/stories/range-control.story.d.ts.map +1 -1
  701. package/build-types/validated-form-controls/components/stories/select-control.story.d.ts.map +1 -1
  702. package/build-types/validated-form-controls/components/stories/text-control.story.d.ts.map +1 -1
  703. package/build-types/validated-form-controls/components/stories/textarea-control.story.d.ts.map +1 -1
  704. package/build-types/validated-form-controls/components/stories/toggle-control.story.d.ts.map +1 -1
  705. package/build-types/validated-form-controls/components/stories/toggle-group-control.story.d.ts.map +1 -1
  706. package/build-types/validated-form-controls/components/text-control.d.ts +3 -3
  707. package/build-types/validated-form-controls/components/textarea-control.d.ts +3 -3
  708. package/build-types/validated-form-controls/components/toggle-control.d.ts +2 -2
  709. package/build-types/validated-form-controls/components/toggle-group-control.d.ts +3 -3
  710. package/build-types/validated-form-controls/control-with-error.d.ts +1 -1
  711. package/build-types/validated-form-controls/validity-indicator.d.ts +1 -1
  712. package/build-types/validated-form-controls/validity-indicator.d.ts.map +1 -1
  713. package/build-types/view/component.d.ts +251 -251
  714. package/build-types/view/component.d.ts.map +1 -1
  715. package/build-types/view/stories/index.story.d.ts.map +1 -1
  716. package/build-types/visually-hidden/component.d.ts.map +1 -1
  717. package/build-types/visually-hidden/stories/index.story.d.ts.map +1 -1
  718. package/build-types/z-stack/component.d.ts.map +1 -1
  719. package/build-types/z-stack/stories/index.story.d.ts.map +1 -1
  720. package/package.json +24 -23
  721. package/src/alignment-matrix-control/stories/index.story.tsx +1 -1
  722. package/src/angle-picker-control/stories/index.story.tsx +1 -1
  723. package/src/autocomplete/autocompleter-ui.tsx +0 -1
  724. package/src/base-control/stories/index.story.tsx +1 -1
  725. package/src/border-box-control/stories/index.story.tsx +1 -1
  726. package/src/border-control/stories/index.story.tsx +1 -1
  727. package/src/button/stories/index.story.tsx +1 -1
  728. package/src/button/style.scss +2 -0
  729. package/src/checkbox-control/stories/index.story.tsx +1 -1
  730. package/src/color-indicator/stories/index.story.tsx +1 -1
  731. package/src/color-palette/index.tsx +25 -9
  732. package/src/color-palette/stories/index.story.tsx +21 -3
  733. package/src/color-palette/test/index.tsx +152 -1
  734. package/src/color-palette/test/utils.ts +18 -0
  735. package/src/color-palette/types.ts +19 -2
  736. package/src/color-palette/utils.ts +14 -2
  737. package/src/color-picker/hex-input.tsx +1 -1
  738. package/src/color-picker/stories/index.story.tsx +1 -1
  739. package/src/color-picker/test/index.tsx +24 -2
  740. package/src/combobox-control/stories/index.story.tsx +1 -1
  741. package/src/composite/legacy/test/index.tsx +13 -13
  742. package/src/composite/stories/index.story.tsx +1 -1
  743. package/src/confirm-dialog/stories/index.story.tsx +1 -1
  744. package/src/custom-gradient-picker/index.tsx +0 -1
  745. package/src/custom-select-control/stories/index.story.tsx +1 -1
  746. package/src/disabled/stories/index.story.tsx +1 -1
  747. package/src/drop-zone/stories/index.story.tsx +1 -1
  748. package/src/dropdown/stories/index.story.tsx +1 -1
  749. package/src/duotone-picker/stories/duotone-picker.story.tsx +1 -1
  750. package/src/duotone-picker/stories/duotone-swatch.story.tsx +1 -1
  751. package/src/external-link/style.scss +4 -0
  752. package/src/focal-point-picker/README.md +12 -8
  753. package/src/focal-point-picker/index.tsx +16 -11
  754. package/src/focal-point-picker/stories/index.story.tsx +1 -1
  755. package/src/font-size-picker/stories/index.story.tsx +1 -1
  756. package/src/form-file-upload/stories/index.story.tsx +1 -1
  757. package/src/form-toggle/stories/index.story.tsx +1 -1
  758. package/src/form-token-field/stories/index.story.tsx +1 -1
  759. package/src/gradient-picker/stories/index.story.tsx +1 -1
  760. package/src/guide/stories/index.story.tsx +1 -1
  761. package/src/higher-order/with-notices/test/index.tsx +12 -10
  762. package/src/icon/stories/index.story.tsx +1 -1
  763. package/src/input-control/stories/index.story.tsx +1 -1
  764. package/src/item-group/stories/index.story.tsx +1 -1
  765. package/src/keyboard-shortcuts/stories/index.story.tsx +1 -1
  766. package/src/menu/stories/index.story.tsx +1 -1
  767. package/src/menu/test/index.tsx +4 -3
  768. package/src/menu-group/stories/index.story.tsx +1 -1
  769. package/src/menu-item/stories/index.story.tsx +1 -1
  770. package/src/menu-items-choice/stories/index.story.tsx +1 -1
  771. package/src/modal/index.tsx +2 -7
  772. package/src/modal/stories/index.story.tsx +1 -1
  773. package/src/modal/style.scss +68 -24
  774. package/src/modal/use-modal-exit-animation.ts +10 -7
  775. package/src/navigator/stories/index.story.tsx +1 -1
  776. package/src/notice/stories/index.story.tsx +1 -1
  777. package/src/number-control/stories/index.story.tsx +1 -1
  778. package/src/palette-edit/index.tsx +0 -1
  779. package/src/palette-edit/stories/index.story.tsx +1 -1
  780. package/src/panel/stories/index.story.tsx +1 -1
  781. package/src/placeholder/stories/index.story.tsx +1 -1
  782. package/src/popover/stories/index.story.tsx +1 -1
  783. package/src/popover/style.scss +0 -4
  784. package/src/progress-bar/stories/index.story.tsx +1 -1
  785. package/src/query-controls/stories/index.story.tsx +1 -1
  786. package/src/radio-control/stories/index.story.tsx +1 -1
  787. package/src/range-control/stories/index.story.tsx +1 -1
  788. package/src/resizable-box/stories/index.story.tsx +1 -1
  789. package/src/sandbox/stories/index.story.tsx +1 -1
  790. package/src/scroll-lock/stories/index.story.tsx +1 -1
  791. package/src/search-control/stories/index.story.tsx +1 -1
  792. package/src/select-control/stories/index.story.tsx +1 -1
  793. package/src/shortcut/stories/index.story.tsx +1 -1
  794. package/src/slot-fill/fill.tsx +2 -2
  795. package/src/slot-fill/stories/index.story.tsx +1 -1
  796. package/src/snackbar/stories/index.story.tsx +1 -1
  797. package/src/spinner/stories/index.story.tsx +1 -1
  798. package/src/style-provider/index.tsx +10 -7
  799. package/src/style-provider/test/index.tsx +38 -0
  800. package/src/tab-panel/style.scss +2 -2
  801. package/src/tabs/stories/index.story.tsx +1 -1
  802. package/src/text/styles.ts +1 -1
  803. package/src/text/test/index.tsx +1 -1
  804. package/src/text-control/stories/index.story.tsx +1 -1
  805. package/src/text-highlight/stories/index.story.tsx +1 -1
  806. package/src/textarea-control/stories/index.story.tsx +1 -1
  807. package/src/toggle-control/stories/index.story.tsx +1 -1
  808. package/src/toggle-group-control/stories/index.story.tsx +1 -1
  809. package/src/toolbar/stories/index.story.tsx +1 -1
  810. package/src/tools-panel/stories/index.story.tsx +1 -1
  811. package/src/tooltip/stories/index.story.tsx +1 -1
  812. package/src/tree-grid/stories/index.story.tsx +1 -1
  813. package/src/tree-select/stories/index.story.tsx +1 -1
  814. package/src/truncate/stories/index.story.tsx +1 -1
  815. package/src/unit-control/stories/index.story.tsx +1 -1
  816. package/src/utils/config-values.js +3 -0
  817. package/src/utils/dropdown-motion.ts +6 -2
@@ -95,7 +95,7 @@ describe( 'ColorPicker', () => {
95
95
  await user.clear( hexInput );
96
96
  await user.type( hexInput, '1ab' );
97
97
 
98
- expect( onChangeComplete ).toHaveBeenCalledTimes( 3 );
98
+ expect( onChangeComplete ).toHaveBeenCalledTimes( 4 );
99
99
  expect( onChangeComplete ).toHaveBeenLastCalledWith(
100
100
  legacyColorMatcher
101
101
  );
@@ -126,9 +126,31 @@ describe( 'ColorPicker', () => {
126
126
  await user.clear( hexInput );
127
127
  await user.type( hexInput, '1ab' );
128
128
 
129
- expect( onChange ).toHaveBeenCalledTimes( 3 );
129
+ expect( onChange ).toHaveBeenCalledTimes( 4 );
130
130
  expect( onChange ).toHaveBeenLastCalledWith( '#11aabb' );
131
131
  } );
132
+
133
+ it( 'should reset color to black when the hex input is completely cleared', async () => {
134
+ const user = userEvent.setup();
135
+ const onChange = jest.fn();
136
+ const color = '#11aabb';
137
+
138
+ render(
139
+ <ColorPicker
140
+ onChange={ onChange }
141
+ color={ color }
142
+ enableAlpha={ false }
143
+ />
144
+ );
145
+
146
+ const formatSelector = screen.getByRole( 'combobox' );
147
+ await user.selectOptions( formatSelector, 'hex' );
148
+
149
+ const hexInput = screen.getByRole( 'textbox' );
150
+ await user.clear( hexInput );
151
+
152
+ expect( onChange ).toHaveBeenLastCalledWith( '#000000' );
153
+ } );
132
154
  } );
133
155
 
134
156
  describe.each( [
@@ -50,7 +50,7 @@ const meta: Meta< typeof ComboboxControl > = {
50
50
  controls: { expanded: true },
51
51
  docs: { canvas: { sourceState: 'shown' } },
52
52
  componentStatus: {
53
- status: 'stable',
53
+ status: 'recommended',
54
54
  whereUsed: 'global',
55
55
  notes: 'Will be superseded by `SearchableSelectControl` in `@wordpress/ui`, but continue using for now.',
56
56
  },
@@ -341,7 +341,7 @@ describe.each( [
341
341
  ] )( '%s', ( _when, rtl ) => {
342
342
  const { previous, next, first, last } = getKeys( rtl );
343
343
 
344
- async function useOneDimensionalTest( initialState?: InitialState ) {
344
+ async function renderOneDimensionalTest( initialState?: InitialState ) {
345
345
  const Test = () => (
346
346
  <OneDimensionalTest
347
347
  state={ useCompositeState( { rtl, ...initialState } ) }
@@ -351,7 +351,7 @@ describe.each( [
351
351
  return getOneDimensionalItems();
352
352
  }
353
353
 
354
- async function useTwoDimensionalTest( initialState?: InitialState ) {
354
+ async function renderTwoDimensionalTest( initialState?: InitialState ) {
355
355
  const Test = () => (
356
356
  <TwoDimensionalTest
357
357
  state={ useCompositeState( { rtl, ...initialState } ) }
@@ -361,7 +361,7 @@ describe.each( [
361
361
  return getTwoDimensionalItems();
362
362
  }
363
363
 
364
- async function useShiftTest( shift: boolean ) {
364
+ async function renderShiftTest( shift: boolean ) {
365
365
  const Test = () => (
366
366
  <ShiftTest state={ useCompositeState( { rtl, shift } ) } />
367
367
  );
@@ -371,7 +371,7 @@ describe.each( [
371
371
 
372
372
  describe( 'In one dimension', () => {
373
373
  test( 'All directions work with no orientation', async () => {
374
- const { item1, item2, item3 } = await useOneDimensionalTest();
374
+ const { item1, item2, item3 } = await renderOneDimensionalTest();
375
375
 
376
376
  await press.Tab();
377
377
  expect( item1 ).toHaveFocus();
@@ -406,7 +406,7 @@ describe.each( [
406
406
  } );
407
407
 
408
408
  test( 'Only left/right work with horizontal orientation', async () => {
409
- const { item1, item2, item3 } = await useOneDimensionalTest( {
409
+ const { item1, item2, item3 } = await renderOneDimensionalTest( {
410
410
  orientation: 'horizontal',
411
411
  } );
412
412
 
@@ -435,7 +435,7 @@ describe.each( [
435
435
  } );
436
436
 
437
437
  test( 'Only up/down work with vertical orientation', async () => {
438
- const { item1, item2, item3 } = await useOneDimensionalTest( {
438
+ const { item1, item2, item3 } = await renderOneDimensionalTest( {
439
439
  orientation: 'vertical',
440
440
  } );
441
441
 
@@ -464,7 +464,7 @@ describe.each( [
464
464
  } );
465
465
 
466
466
  test( 'Focus wraps with loop enabled', async () => {
467
- const { item1, item2, item3 } = await useOneDimensionalTest( {
467
+ const { item1, item2, item3 } = await renderOneDimensionalTest( {
468
468
  loop: true,
469
469
  } );
470
470
 
@@ -488,7 +488,7 @@ describe.each( [
488
488
  describe( 'In two dimensions', () => {
489
489
  test( 'All directions work as standard', async () => {
490
490
  const { itemA1, itemA2, itemA3, itemB1, itemB2, itemC1, itemC3 } =
491
- await useTwoDimensionalTest();
491
+ await renderTwoDimensionalTest();
492
492
 
493
493
  await press.Tab();
494
494
  expect( itemA1 ).toHaveFocus();
@@ -524,7 +524,7 @@ describe.each( [
524
524
 
525
525
  test( 'Focus wraps around rows/columns with loop enabled', async () => {
526
526
  const { itemA1, itemA2, itemA3, itemB1, itemC1, itemC3 } =
527
- await useTwoDimensionalTest( { loop: true } );
527
+ await renderTwoDimensionalTest( { loop: true } );
528
528
 
529
529
  await press.Tab();
530
530
  expect( itemA1 ).toHaveFocus();
@@ -548,7 +548,7 @@ describe.each( [
548
548
 
549
549
  test( 'Focus moves between rows/columns with wrap enabled', async () => {
550
550
  const { itemA1, itemA2, itemA3, itemB1, itemC1, itemC3 } =
551
- await useTwoDimensionalTest( { wrap: true } );
551
+ await renderTwoDimensionalTest( { wrap: true } );
552
552
 
553
553
  await press.Tab();
554
554
  expect( itemA1 ).toHaveFocus();
@@ -577,7 +577,7 @@ describe.each( [
577
577
  } );
578
578
 
579
579
  test( 'Focus wraps around start/end with loop and wrap enabled', async () => {
580
- const { itemA1, itemC3 } = await useTwoDimensionalTest( {
580
+ const { itemA1, itemC3 } = await renderTwoDimensionalTest( {
581
581
  loop: true,
582
582
  wrap: true,
583
583
  } );
@@ -596,7 +596,7 @@ describe.each( [
596
596
 
597
597
  test( 'Focus shifts if vertical neighbour unavailable when shift enabled', async () => {
598
598
  const { itemA1, itemB1, itemB2, itemC1 } =
599
- await useShiftTest( true );
599
+ await renderShiftTest( true );
600
600
 
601
601
  await press.Tab();
602
602
  expect( itemA1 ).toHaveFocus();
@@ -617,7 +617,7 @@ describe.each( [
617
617
  } );
618
618
 
619
619
  test( 'Focus does not shift if vertical neighbour unavailable when shift not enabled', async () => {
620
- const { itemA1, itemB1, itemB2 } = await useShiftTest( false );
620
+ const { itemA1, itemB1, itemB2 } = await renderShiftTest( false );
621
621
 
622
622
  await press.Tab();
623
623
  expect( itemA1 ).toHaveFocus();
@@ -49,7 +49,7 @@ const meta: Meta< typeof Composite > = {
49
49
  canvas: { sourceState: 'shown' },
50
50
  },
51
51
  componentStatus: {
52
- status: 'stable',
52
+ status: 'recommended',
53
53
  whereUsed: 'global',
54
54
  },
55
55
  },
@@ -34,7 +34,7 @@ const meta: Meta< typeof ConfirmDialog > = {
34
34
  expanded: true,
35
35
  },
36
36
  componentStatus: {
37
- status: 'stable',
37
+ status: 'recommended',
38
38
  whereUsed: 'global',
39
39
  },
40
40
  docs: { canvas: { sourceState: 'shown' } },
@@ -76,7 +76,6 @@ const GradientTypePicker = ( {
76
76
  );
77
77
 
78
78
  if ( type === 'linear-gradient' && gradientAST.orientation ) {
79
- // eslint-disable-next-line react-compiler/react-compiler -- false positive, see https://github.com/facebook/react/issues/29196
80
79
  lastLinearOrientationAngle.current = Number(
81
80
  gradientAST.orientation.value
82
81
  );
@@ -32,7 +32,7 @@ const meta: Meta< typeof CustomSelectControl > = {
32
32
  source: { excludeDecorators: true },
33
33
  },
34
34
  componentStatus: {
35
- status: 'stable',
35
+ status: 'recommended',
36
36
  whereUsed: 'global',
37
37
  notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`, but continue using for now.',
38
38
  },
@@ -32,7 +32,7 @@ const meta: Meta< typeof Disabled > = {
32
32
  },
33
33
  docs: { canvas: { sourceState: 'shown' } },
34
34
  componentStatus: {
35
- status: 'stable',
35
+ status: 'recommended',
36
36
  whereUsed: 'global',
37
37
  },
38
38
  },
@@ -37,7 +37,7 @@ const meta: Meta< typeof DropZone > = {
37
37
  controls: { expanded: true },
38
38
  docs: { canvas: { sourceState: 'shown' } },
39
39
  componentStatus: {
40
- status: 'stable',
40
+ status: 'recommended',
41
41
  whereUsed: 'global',
42
42
  },
43
43
  },
@@ -43,7 +43,7 @@ const meta: Meta< typeof Dropdown > = {
43
43
  expanded: true,
44
44
  },
45
45
  componentStatus: {
46
- status: 'stable',
46
+ status: 'recommended',
47
47
  whereUsed: 'global',
48
48
  },
49
49
  },
@@ -25,7 +25,7 @@ const meta: Meta< typeof DuotonePicker > = {
25
25
  controls: { expanded: true },
26
26
  docs: { canvas: { sourceState: 'shown' } },
27
27
  componentStatus: {
28
- status: 'stable',
28
+ status: 'recommended',
29
29
  whereUsed: 'editor',
30
30
  },
31
31
  },
@@ -15,7 +15,7 @@ const meta: Meta< typeof DuotoneSwatch > = {
15
15
  controls: { expanded: true },
16
16
  docs: { canvas: { sourceState: 'shown' } },
17
17
  componentStatus: {
18
- status: 'stable',
18
+ status: 'recommended',
19
19
  whereUsed: 'editor',
20
20
  },
21
21
  },
@@ -24,6 +24,9 @@
24
24
  outline:
25
25
  var(--wpds-border-width-focus) solid
26
26
  var(--wpds-color-stroke-focus-brand);
27
+ // Override style from wp-admin common.css.
28
+ box-shadow: none;
29
+ border-radius: 0;
27
30
  }
28
31
  }
29
32
 
@@ -34,6 +37,7 @@
34
37
  }
35
38
 
36
39
  .components-external-link__icon {
40
+ line-height: 1;
37
41
  display: inline-block;
38
42
  margin-inline-start: var(--wpds-dimension-padding-xs);
39
43
  font-weight: var(--wpds-typography-font-weight-regular);
@@ -1,28 +1,32 @@
1
1
  # FocalPointPicker
2
2
 
3
- Focal Point Picker is a component which creates a UI for identifying the most important visual point of an image. This component addresses a specific problem: with large background images it is common to see undesirable crops, especially when viewing on smaller viewports such as mobile phones. This component allows the selection of the point with the most important visual information and returns it as a pair of numbers between 0 and 1. This value can be easily converted into the CSS `background-position` attribute, and will ensure that the focal point is never cropped out, regardless of viewport.
3
+ Focal Point Picker is a component which creates a UI for identifying the most important visual point of an image.
4
4
 
5
- - Example focal point picker value: `{ x: 0.5, y: 0.1 }`
6
- - Corresponding CSS: `background-position: 50% 10%;`
5
+ It addresses two common issues when displaying images in cropped containers. First, large background images can be cropped in undesirable ways, especially on smaller viewports such as mobile devices. Second, the CSS aspect-ratio property can inadvertently crop out the area of highest visual interest. This component allows the selection of the point with the most important visual information and returns it as a pair of numbers between 0 and 1. The output value can be applied to either CSS `background-position` (for elements with `background-image`) or `object-position` (for `<img>` / `<video>` elements rendered with `object-fit: cover`).
6
+
7
+ - Example focal point picker value: `{ x: 0.5, y: 0.1 }`;
8
+ - Corresponding CSS: `object-position: 50% 10%`;
7
9
 
8
10
  ## Usage
9
11
 
10
12
  ```jsx
11
- import { useState } from 'react';
12
13
  import { FocalPointPicker } from '@wordpress/components';
14
+ import { useState } from '@wordpress/element';
13
15
 
14
16
  const Example = () => {
15
17
  const [ focalPoint, setFocalPoint ] = useState( {
16
18
  x: 0.5,
17
- y: 0.5,
19
+ y: 0.1,
18
20
  } );
19
21
 
20
22
  const url = '/path/to/image';
21
23
 
22
24
  /* Example function to render the CSS styles based on Focal Point Picker value */
23
25
  const style = {
24
- backgroundImage: `url(${ url })`,
25
- backgroundPosition: `${ focalPoint.x * 100 }% ${ focalPoint.y * 100 }%`,
26
+ width: '100%',
27
+ aspectRatio: '16 / 9',
28
+ objectFit: 'cover',
29
+ objectPosition: `${ focalPoint.x * 100 }% ${ focalPoint.y * 100 }%`,
26
30
  };
27
31
 
28
32
  return (
@@ -34,7 +38,7 @@ const Example = () => {
34
38
  onDrag={ setFocalPoint }
35
39
  onChange={ setFocalPoint }
36
40
  />
37
- <div style={ style } />
41
+ <img src={ url } alt="" style={ style } />
38
42
  </>
39
43
  );
40
44
  };
@@ -44,14 +44,17 @@ const GRID_OVERLAY_TIMEOUT = 600;
44
44
  /**
45
45
  * Focal Point Picker is a component which creates a UI for identifying the most important visual point of an image.
46
46
  *
47
- * This component addresses a specific problem: with large background images it is common to see undesirable crops,
48
- * especially when viewing on smaller viewports such as mobile phones. This component allows the selection of
49
- * the point with the most important visual information and returns it as a pair of numbers between 0 and 1.
50
- * This value can be easily converted into the CSS `background-position` attribute, and will ensure that the
51
- * focal point is never cropped out, regardless of viewport.
47
+ * It addresses two common issues when displaying images in cropped containers. First, large
48
+ * background images can be cropped in undesirable ways, especially on smaller viewports such as
49
+ * mobile devices. Second, the CSS aspect-ratio property can inadvertently crop out the area of
50
+ * highest visual interest. This component allows the selection of the point with the most
51
+ * important visual information and returns it as a pair of numbers between 0 and 1.
52
+ * The output value can be applied to either CSS `background-position` (for elements with
53
+ * `background-image`) or `object-position` (for `<img>` / `<video>` elements rendered with
54
+ * `object-fit: cover`).
52
55
  *
53
- * - Example focal point picker value: `{ x: 0.5, y: 0.1 }`
54
- * - Corresponding CSS: `background-position: 50% 10%;`
56
+ * - Example focal point picker value: `{ x: 0.5, y: 0.1 }`;
57
+ * - Corresponding CSS: `object-position: 50% 10%`;
55
58
  *
56
59
  * ```jsx
57
60
  * import { FocalPointPicker } from '@wordpress/components';
@@ -60,15 +63,17 @@ const GRID_OVERLAY_TIMEOUT = 600;
60
63
  * const Example = () => {
61
64
  * const [ focalPoint, setFocalPoint ] = useState( {
62
65
  * x: 0.5,
63
- * y: 0.5,
66
+ * y: 0.1,
64
67
  * } );
65
68
  *
66
69
  * const url = '/path/to/image';
67
70
  *
68
71
  * // Example function to render the CSS styles based on Focal Point Picker value
69
72
  * const style = {
70
- * backgroundImage: `url(${ url })`,
71
- * backgroundPosition: `${ focalPoint.x * 100 }% ${ focalPoint.y * 100 }%`,
73
+ * width: '100%',
74
+ * aspectRatio: '16 / 9',
75
+ * objectFit: 'cover',
76
+ * objectPosition: `${ focalPoint.x * 100 }% ${ focalPoint.y * 100 }%`,
72
77
  * };
73
78
  *
74
79
  * return (
@@ -80,7 +85,7 @@ const GRID_OVERLAY_TIMEOUT = 600;
80
85
  * onDrag={ setFocalPoint }
81
86
  * onChange={ setFocalPoint }
82
87
  * />
83
- * <div style={ style } />
88
+ * <img src={ url } alt="" style={ style } />
84
89
  * </>
85
90
  * );
86
91
  * };
@@ -30,7 +30,7 @@ const meta: Meta< typeof FocalPointPicker > = {
30
30
  controls: { expanded: true },
31
31
  docs: { canvas: { sourceState: 'shown' } },
32
32
  componentStatus: {
33
- status: 'stable',
33
+ status: 'recommended',
34
34
  whereUsed: 'editor',
35
35
  },
36
36
  },
@@ -31,7 +31,7 @@ const meta: Meta< typeof FontSizePicker > = {
31
31
  controls: { expanded: true },
32
32
  docs: { canvas: { sourceState: 'shown' } },
33
33
  componentStatus: {
34
- status: 'stable',
34
+ status: 'recommended',
35
35
  whereUsed: 'editor',
36
36
  },
37
37
  },
@@ -27,7 +27,7 @@ const meta: Meta< typeof FormFileUpload > = {
27
27
  controls: { expanded: true },
28
28
  docs: { canvas: { sourceState: 'shown' } },
29
29
  componentStatus: {
30
- status: 'stable',
30
+ status: 'recommended',
31
31
  whereUsed: 'global',
32
32
  },
33
33
  },
@@ -28,7 +28,7 @@ const meta: Meta< typeof FormToggle > = {
28
28
  },
29
29
  docs: { canvas: { sourceState: 'shown' } },
30
30
  componentStatus: {
31
- status: 'stable',
31
+ status: 'recommended',
32
32
  whereUsed: 'global',
33
33
  notes: 'For standard toggles with labels, use `ToggleControl` instead.',
34
34
  },
@@ -33,7 +33,7 @@ const meta: Meta< typeof FormTokenField > = {
33
33
  },
34
34
  docs: { canvas: { sourceState: 'shown' } },
35
35
  componentStatus: {
36
- status: 'stable',
36
+ status: 'recommended',
37
37
  whereUsed: 'global',
38
38
  notes: 'Will be superseded by `SearchableChipSelect` in `@wordpress/ui`, but continue using for now.',
39
39
  },
@@ -23,7 +23,7 @@ const meta: Meta< typeof GradientPicker > = {
23
23
  controls: { expanded: true },
24
24
  docs: { canvas: { sourceState: 'shown' } },
25
25
  componentStatus: {
26
- status: 'stable',
26
+ status: 'recommended',
27
27
  whereUsed: 'global',
28
28
  },
29
29
  },
@@ -26,7 +26,7 @@ const meta: Meta< typeof Guide > = {
26
26
  },
27
27
  parameters: {
28
28
  componentStatus: {
29
- status: 'stable',
29
+ status: 'recommended',
30
30
  whereUsed: 'editor',
31
31
  },
32
32
  },
@@ -14,10 +14,10 @@ import {
14
14
  * WordPress dependencies
15
15
  */
16
16
  import {
17
+ createRef,
17
18
  forwardRef,
18
19
  useEffect,
19
20
  useImperativeHandle,
20
- useRef,
21
21
  } from '@wordpress/element';
22
22
 
23
23
  /**
@@ -91,15 +91,17 @@ describe( 'withNotices return type', () => {
91
91
  } );
92
92
 
93
93
  describe( 'withNotices operations', () => {
94
- let handle: React.RefObject< any >;
95
- const Handle = ( props: any ) => {
96
- handle = useRef( null );
97
- return <TestNoticeOperations { ...props } ref={ handle } />;
98
- };
94
+ function setup( props: any = {} ) {
95
+ const handle = createRef< any >();
96
+ const utils = render(
97
+ <TestNoticeOperations { ...props } ref={ handle } />
98
+ );
99
+ return { ...utils, handle };
100
+ }
99
101
 
100
102
  it( 'should create notices with createNotice', () => {
101
103
  const message = 'Aló!';
102
- const { container } = render( <Handle /> );
104
+ const { container, handle } = setup();
103
105
  const { getByText } = within( container );
104
106
  act( () => {
105
107
  handle.current.createNotice( { content: message } );
@@ -109,7 +111,7 @@ describe( 'withNotices operations', () => {
109
111
 
110
112
  it( 'should create notices of error status with createErrorNotice', () => {
111
113
  const message = 'can’t touch this';
112
- const { container } = render( <Handle /> );
114
+ const { container, handle } = setup();
113
115
  const { getByText } = within( container );
114
116
  act( () => {
115
117
  handle.current.createErrorNotice( message );
@@ -120,7 +122,7 @@ describe( 'withNotices operations', () => {
120
122
 
121
123
  it( 'should remove a notice with removeNotice', async () => {
122
124
  const notice = { id: 'so real', content: 'so why can’t I touch it?' };
123
- const { container } = render( <Handle /> );
125
+ const { container, handle } = setup();
124
126
  const { getByText } = within( container );
125
127
  act( () => {
126
128
  handle.current.createNotice( notice );
@@ -137,7 +139,7 @@ describe( 'withNotices operations', () => {
137
139
  it( 'should remove all notices with removeAllNotices', async () => {
138
140
  const messages = [ 'Aló!', 'hu dis?', 'Otis' ];
139
141
  const notices = noticesFrom( messages );
140
- const { container } = render( <Handle notifications={ notices } /> );
142
+ const { container, handle } = setup( { notifications: notices } );
141
143
  const { getByText } = within( container );
142
144
  expect(
143
145
  await waitForElementToBeRemoved( () => {
@@ -23,7 +23,7 @@ const meta: Meta< typeof Icon > = {
23
23
  controls: { expanded: true },
24
24
  docs: { canvas: { sourceState: 'shown' } },
25
25
  componentStatus: {
26
- status: 'stable',
26
+ status: 'recommended',
27
27
  whereUsed: 'global',
28
28
  notes: 'Prefer this component over the `Icon` component from `@wordpress/icons`.',
29
29
  },
@@ -41,7 +41,7 @@ const meta: Meta< typeof InputControl > = {
41
41
  controls: { expanded: true },
42
42
  docs: { canvas: { sourceState: 'shown' } },
43
43
  componentStatus: {
44
- status: 'stable',
44
+ status: 'recommended',
45
45
  whereUsed: 'global',
46
46
  notes: 'Will be superseded by `InputControl` in `@wordpress/ui`, but continue using for now.',
47
47
  },
@@ -24,7 +24,7 @@ const meta: Meta< typeof ItemGroup > = {
24
24
  controls: { expanded: true },
25
25
  docs: { canvas: { sourceState: 'shown' } },
26
26
  componentStatus: {
27
- status: 'stable',
27
+ status: 'recommended',
28
28
  whereUsed: 'global',
29
29
  },
30
30
  },
@@ -17,7 +17,7 @@ const meta: Meta< typeof KeyboardShortcuts > = {
17
17
  controls: { expanded: true },
18
18
  docs: { canvas: { sourceState: 'shown' } },
19
19
  componentStatus: {
20
- status: 'stable',
20
+ status: 'recommended',
21
21
  whereUsed: 'global',
22
22
  },
23
23
  },
@@ -56,7 +56,7 @@ const meta: Meta< typeof Menu > = {
56
56
  source: { excludeDecorators: true },
57
57
  },
58
58
  componentStatus: {
59
- status: 'stable',
59
+ status: 'recommended',
60
60
  whereUsed: 'global',
61
61
  notes: 'When building for the Gutenberg repo, use this component instead of `DropdownMenu`. Otherwise, continue using `DropdownMenu` for now.',
62
62
  },
@@ -161,7 +161,7 @@ describe( 'Menu', () => {
161
161
  <Menu>
162
162
  <Menu.TriggerButton>Open dropdown</Menu.TriggerButton>
163
163
  <Menu.Popover>
164
- <Menu.Item disabled>First item</Menu.Item>
164
+ <Menu.Item>First item</Menu.Item>
165
165
  <Menu.Item>Second item</Menu.Item>
166
166
  <Menu.Item>Third item</Menu.Item>
167
167
  </Menu.Popover>
@@ -180,10 +180,11 @@ describe( 'Menu', () => {
180
180
  // Menu closed
181
181
  expect( screen.queryByRole( 'menuitem' ) ).not.toBeInTheDocument();
182
182
 
183
- await press.Space();
183
+ // Keyboard-triggered clicks have `detail: 0`, which Ariakit uses to
184
+ // choose the initial item focus path instead of the pointer path.
185
+ await press.Space( toggleButton, { detail: 0 } );
184
186
 
185
187
  // Menu open, focus is on the first focusable item
186
- // (disabled items are still focusable and accessible
187
188
  await waitForFocusedMenuItem( 'First item' );
188
189
  } );
189
190
 
@@ -27,7 +27,7 @@ const meta: Meta< typeof MenuGroup > = {
27
27
  controls: { expanded: true },
28
28
  docs: { canvas: { sourceState: 'shown' } },
29
29
  componentStatus: {
30
- status: 'stable',
30
+ status: 'recommended',
31
31
  whereUsed: 'global',
32
32
  notes: 'Subcomponent of `DropdownMenu`.',
33
33
  },
@@ -38,7 +38,7 @@ const meta: Meta< typeof MenuItem > = {
38
38
  },
39
39
  docs: { canvas: { sourceState: 'shown' } },
40
40
  componentStatus: {
41
- status: 'stable',
41
+ status: 'recommended',
42
42
  whereUsed: 'global',
43
43
  notes: 'Subcomponent of `DropdownMenu`.',
44
44
  },
@@ -30,7 +30,7 @@ const meta: Meta< typeof MenuItemsChoice > = {
30
30
  },
31
31
  docs: { canvas: { sourceState: 'shown' } },
32
32
  componentStatus: {
33
- status: 'stable',
33
+ status: 'recommended',
34
34
  whereUsed: 'global',
35
35
  notes: 'Subcomponent of `DropdownMenu`.',
36
36
  },
@@ -121,7 +121,6 @@ function UnforwardedModal(
121
121
  const onRequestCloseRef =
122
122
  useRef< ModalProps[ 'onRequestClose' ] >( undefined );
123
123
  useEffect( () => {
124
- // eslint-disable-next-line react-compiler/react-compiler -- false positive, see https://github.com/facebook/react/issues/29196
125
124
  onRequestCloseRef.current = onRequestClose;
126
125
  }, [ onRequestClose ] );
127
126
 
@@ -169,8 +168,7 @@ function UnforwardedModal(
169
168
  };
170
169
  }, [ bodyOpenClassName ] );
171
170
 
172
- const { closeModal, frameRef, frameStyle, overlayClassname } =
173
- useModalExitAnimation();
171
+ const { closeModal, frameRef, overlayClassname } = useModalExitAnimation();
174
172
 
175
173
  // Calls the isContentScrollable callback when the Modal children container resizes.
176
174
  useLayoutEffect( () => {
@@ -260,10 +258,7 @@ function UnforwardedModal(
260
258
  sizeClass,
261
259
  className
262
260
  ) }
263
- style={ {
264
- ...frameStyle,
265
- ...style,
266
- } }
261
+ style={ style }
267
262
  ref={ useMergeRefs( [
268
263
  frameRef,
269
264
  constrainedTabbingRef,