@base-ui/react
Version:
Base UI is a library of headless ('unstyled') React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.
1,283 lines (864 loc) • 74 kB
Markdown
# Versions
## v1.1.0
_Jan 15, 2026_
### General changes
- Fix `onOpenChangeComplete(true)` timing (#3558) by @atomiks
- Fix touch `openMethod` when tapping outside element bounds on Safari (#3541) by @atomiks
- Fix visually hidden input styles across form components (#3606) by @atomiks
- Fix click and drags outside a nested popup component from closing its parents (#3571) by @atomiks
- Fix forwarded ref types (#3638) by @atomiks
- Fix detached trigger remounting (#3724) by @atomiks
- Include `ref` in `BaseUIComponentProps` (#2813) by @atomiks
- Remove duplicated `disabled` prop (#3650) by @seongminn
- Allow `actionsRef` to be `null` (#3682) by @mj12albert
### Accordion
- Fix keyboard navigation with non-interactive trigger elements (#3684) by @ZeeshanTamboli
### Autocomplete
- Add `data-popup-side` and `data-list-empty` state attributes to `<Autocomplete.Trigger>` (#3491) by @atomiks
- Add `loopFocus` prop (#3592) by @atomiks
- Fix hidden input `id` and `required` props (#3640) by @atomiks
### Button
- Remove discriminated props union (#3643) by @atomiks
### Checkbox
- Fix hidden input `id` and `required` props (#3640) by @atomiks
### Combobox
- Add `data-popup-side` and `data-list-empty` state attributes to `<Combobox.Trigger>` (#3491) by @atomiks
- Add `loopFocus` prop (#3592) by @atomiks
- Add `toolbar` role to `<Combobox.Chips>` to prevent NVDA from entering browse mode (#3647) by @atomiks
- Add `placeholder` prop to `<Combobox.Value>` (#3604) by @atomiks
- Fix controlled `value` prop when `items` change (#3607) by @atomiks
- Fix `multiple` values label resolution in `<Combobox.Value>` (#3314) by @atomiks
- Forward root `id` to visible form element (#3722) by @atomiks
- Do not trigger Field `onBlur` handlers when opening popup (#3609) by @atomiks
### Context Menu
- Avoid creating sibling elements next to trigger (#3645) by @atomiks
### CSP Provider
- Add `CSPProvider` (#3553) by @atomiks
### Dialog
- Fix `Maximum update depth exceeded` error with Suspense (#3700) by @michaldudak
- Fix `<Dialog.Title>` forwardedRef type (#3736) by @ZeeshanTamboli
### Field
- Add `actionsRef` prop (#3395) by @mj12albert
- Add `nativeLabel` prop to `<Field.Label>` (#3723) by @atomiks
- Add missing type export (#3702) by @DiegoAndai
### Form
- Add `actionsRef` prop (#3395) by @mj12albert
### Menu
- Fix focus guard handling (#3654) by @atomiks
- Avoid disabling modality on click after hover-open (#3455) by @atomiks
### Menubar
- Fix submenu outside-press dismiss on touch (#3556) by @atomiks
### Number Field
- Fix Field `data-focused` state (#3563) by @atomiks
- Fix hidden input focus on submit (#3581) by @atomiks
### Popover
- Fix popup auto resize glitches (#3591) by @atomiks
- Fix focus guard handling (#3654) by @atomiks
- Prevent disabling focus management when clicking trigger before hover delay completes (#3572) by @atomiks
- Refactor popup auto resize logic. It is no longer necessary to specify `--positioner-width`/`--positioner-height` CSS variables on `<Popover.Positioner>` when using detached triggers unless the `Viewport` part has been added to the JSX. (#3652) by @atomiks
### Preview Card
- Support detached triggers (#3566) by @michaldudak and @atomiks
### Radio Group
- Fix `value` type (#3582) by @atomiks
- Fix hidden input `id` and `required` props (#3640) by @atomiks
### Scroll Area
- Perf improvements (#3536) by @atomiks
### Select
- Add `placeholder` prop to `<Select.Value>` (#3604) by @atomiks
- Fix support for transform animations when `alignItemWithTrigger` is active (#3532) by @atomiks
- Fix support for `max-height` popup style when `alignItemWithTrigger` is active (#3573) by @atomiks
- Fix `data-filled` state in `multiple` mode (#3608) by @atomiks
- Fix highlight being removed on popup mouseout when `highlightItemOnHover` is disabled (#3492) by @atomiks
- Fix support for individual transform animations when `alignItemWithTrigger` is active (#3637) by @atomiks
- Fix `multiple` values label resolution in `<Select.Value>` (#3314) by @atomiks
- Forward root `id` to visible form element (#3722) by @atomiks
- Do not trigger Field `onBlur` handlers when opening popup (#3609) by @atomiks
### Slider
- Fix `onValueCommitted` not called for range sliders (#3600) by @mj12albert
### Switch
- Add `value` prop (#3676) by @Grafikart
- Fix hidden input `id` and `required` props (#3640) by @atomiks
### Toast
- Fix timers not being rescheduled when updated (#3564) by @atomiks
### Tooltip
- Fix popup auto resize glitches (#3591) by @atomiks
- Fix `trackCursorAxis` handling (#3679) by @atomiks
- Refactor popup auto resize logic. It is no longer necessary to specify `--positioner-width`/`--positioner-height` CSS variables on `<Tooltip.Positioner>` when using detached triggers unless the `Viewport` part has been added to the JSX. (#3652) by @atomiks
### mergeProps
- Make `mergeProps` public (#3642) by @michaldudak and @LukasTy
### useRender
- Export missing types (#3565) by @michaldudak
All contributors of this release in alphabetical order: @albertdugba, @atomiks, @brijeshb42, @chuganzy, @colmtuite, @dav-is, @DiegoAndai, @Grafikart, @Janpot, @LukasTy, @michaldudak, @mj12albert, @oliviertassinari, @seongminn, @updbqn, @ZeeshanTamboli
## v1.0.0
_Dec 11, 2025_
### General changes
- **Breaking change:** Rename packages to use the `@base-ui` org.<br />
The package name has changed from `@base-ui-components/react` to `@base-ui/react`.
(#3462) by @mnajdova
### Combobox
- Respect `itemToStringValue` for `onFormSubmit` (#3441) by @atomiks
- Add `null` as an option for the value prop (#3488) by @mnajdova
### Menu
- Fix submenu opens with 0 delay (#3459) by @atomiks
- Fix focus not returning to trigger on <kbd>Esc</kbd> while pointer rests on popup (#3482) by @atomiks
- Fix always `null` open method (#3486) by @atomiks
- Allow side axis fallback for submenus by default (#3470) by @atomiks
### Navigation Menu
- Fix mount transitions on `Positioner` in Firefox (#3424) by @atomiks
### Number Field
- Fix multiple scrub area support (#3471) by @atomiks
### Popover
- Fix mount transitions on `Positioner` in Firefox (#3424) by @atomiks
- Fix skipped viewport transitions (#3453) by @atomiks
### Select
- Respect `itemToStringValue` for `onFormSubmit` (#3441) by @atomiks
- Add `null` as an option for the value prop (#3488) by @mnajdova
### Tabs
- Fix indicator positioning in transformed containers (#3439) by @atomiks
- Do not initially select a disabled tab (#3475) by @michaldudak
### Toast
- Fix `flushSync` dev error when toast is added (#3443) by @atomiks
- Fix `<Toast.Close>;` emitting `aria-hidden` warning on click (#3469) by @atomiks
### Toggle Group
- More permissive towards falsy toggle values (#3477) by @mj12albert
### Tooltip
- Fix mount transitions on `Positioner` in Firefox (#3424) by @atomiks
- Fix ignored "modal" setting in Popovers experiment (#3474) by @michaldudak
- Fix shared tooltip closing with trigger gaps (#3452) by @atomiks
- Fix skipped viewport transitions (#3453) by @atomiks
All contributors of this release in alphabetical order: @atomiks, @LukasTy, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @pondorasti, @romgrk, @ZeeshanTamboli
## v1.0.0-rc.2
_Dec 11, 2025_
This release contains the same code as v1.0.0.
Please refer to that version to see the changes.
## v1.0.0-rc.1
_Dec 11, 2025_
This release contains the same code as v1.0.0.
Please refer to that version to see the changes.
## v1.0.0-rc.0
_Dec 4, 2025_
### General changes
- Fix missing `'use client'` directives (#3408) by @atomiks
### Autocomplete
- Fix `keepHighlight` focus sync (#3399) by @atomiks
### Checkbox
- **Breaking change:** Match native unchecked state in form submission.<br />
The Checkbox will not submit the `"off"` value with a form when unchecked anymore, unless the new `uncheckedValue` prop is set.
(#3406) by @atomiks
### Collapsible
- Remove `render={null}` (#3407) by @mj12albert
### Combobox
- **Breaking change:** Removed the `keepHighlight` prop (#3377) by @atomiks
### Dialog
- Close when pressing focusable element outside (#3380) by @atomiks
- Fix closing after pointer lock exit in Firefox (#3379) by @atomiks
### Menu
- Add `highlightItemOnHover` prop (#3377) by @atomiks
- Do not import client components from MenuStore (#3409) by @michaldudak
### Number Field
- Ensure hidden input participates in form validation (#3374) by @atomiks
- Improve symbol replacement logic (#3376) by @atomiks
- Fix fractional step snapping (#3375) by @atomiks
- Fix parsing numbers with Swiss locale (#3361) by @michaldudak
- Fix pointer lock release when soft clicking in Firefox (#3378) by @atomiks
### Popover
- Close when pressing focusable element outside (#3380) by @atomiks
- Fix modal backdrop on touch (#3383) by @atomiks
- Fix popover glitching when flipped (#3364) by @michaldudak
### Select
- Add `highlightItemOnHover` prop (#3377) by @atomiks
### Switch
- **Breaking change:** Match native off state in form submission.<br />
The Switch will not submit the `"off"` value with a form when unchecked anymore, unless the new `uncheckedValue` prop is set.
(#3406) by @atomiks
### Tabs
- **Breaking change:** Fix Panel `keepMounted` behavior.<br />
The `value` prop is now required on `<Tabs.Tab>` and `<Tabs.Panel>` parts.
(#3372) by @atomiks
### Toast
- Recalculate content height when layout size is fixed (#3359) by @atomiks
- Fix multiple swipe directions on same axis (#3392) by @mj12albert
### Tooltip
- Improve contained triggers performance (#3385) by @michaldudak
All contributors of this release in alphabetical order: @atomiks, @michaldudak, @mj12albert, @oliviertassinari, @pondorasti, @romgrk
## v1.0.0-beta.7
_Nov 27, 2025_
### General changes
- Fix error about `props.ref` access in React <=18 (#3257) by @atomiks
- Prefer non-adaptive anchoring position in `<Positioner>` components and fix `autoFocus` scroll jumps (#3250) by @atomiks
- Make popups' `data-anchor-hidden` state attribute check for anchor presence in layout (#3267) by @atomiks
- Prevent popups from sticking after hover when pressing `<a>` tags inside them (#3318) by @atomiks
- Improve performance when detached triggers are used (#3277)
- Fix iOS VoiceOver voice control accessibility in non-modal popups (#3340)
### Alert Dialog
- Fix trigger registration loop (#3249) by @atomiks
- Fix focus restoration when focused element is hidden with CSS (#3313)
### Checkbox Group
- Fix `aria-describedby` on checkbox group (#3269) by @mj12albert
### Combobox
- Revert overload types to ensure typed wrappers work correctly (#3254) by @atomiks
- Fix ignored `filteredItems` instances (#3272) by @atomiks
- Fix loop when passing `undefined` to `items` prop (#3348)
### Context Menu
- Block mouseup at initial cursor point (#3274) by @atomiks
### Dialog
- Fix trigger registration loop (#3249) by @atomiks
- Fix focus restoration when focused element is hidden with CSS (#3313)
### Form
- Fix cast `ref` type (#3324) by @mj12albert
### Menu
- Fix trigger registration loop (#3249) by @atomiks
- Do not pass `key` to the rendered element (#3255) by @michaldudak
- Fix nested dialog from closing on <kbd>Shift+Tab</kbd> (#3346)
### Navigation Menu
- Fix Safari 18 issue where `<Positioner>` width may be set to 0 on hover (#3309) by @EmilNordling
- Ensure submenu triggers participate in composite list (#3344) by @atomiks
### Number Field
- Fix literal space handling with symbols (#3334) by @atomiks
### Popover
- Fix trigger registration loop (#3249) by @atomiks
- Do not pass `key` to the rendered element (#3255) by @michaldudak
- Fix focus restoration when focused element is hidden with CSS (#3313)
### Select
- Revert overload types to ensure typed wrappers work correctly (#3254) by @atomiks
### Slider
- Fix extra `onValueCommitted` calls (#3312) by @mj12albert
- Fix cast `ref` type (#3324) by @mj12albert
### Tooltip
- Fix trigger registration loop (#3249) by @atomiks
All contributors of this release in alphabetical order: @atomiks, @brijeshb42, @Copilot, @EmilNordling, @michaldudak, @mj12albert, @oliviertassinari, @ZeeshanTamboli
## v1.0.0-beta.6
_Nov 17, 2025_
This is a hotfix release with the following changes:
- Fix for rendering of Alert Dialog, Dialog, Menu, Popover, and Tooltip in React Server Components (#3241) by @michaldudak
- Fix of the types of the refs in the Checkbox, Switch and Radio components (#3246) by @mnajdova
- Fix of the value type error with mergeProps (#3247) by @atomiks
## v1.0.0-beta.5
_Nov 17, 2025_
### General changes
- **Breaking change:** Replace `trackAnchor` with `disableAnchorTracking`.<br />
If you were using `trackAnchor={false}`, be sure to update your usage to `disableAnchorTracking` instead.
(#3188) by @mnajdova
- **Breaking change:** Rename `loop` to `loopFocus` (#3186) by @mnajdova
- Fix type portability (#2912) by @atomiks
- Accept a function for the `style` prop (#3038) by @mnajdova
- Create portal elements inside React (#2889) by @atomiks
- Avoid applying `hidden` attribute to indicator elements when they specify `keepMounted` and are invisible (#3228) by @atomiks
- Fix crash in Next.js 16 when accessing `render.props.ref` (#3231) by @atomiks
### Accordion
- **Breaking change:** Change `multiple` prop to be false by default and add a demo (#3141) by @mnajdova
- Fix flaky exit transition (#3101) by @atomiks
### Alert Dialog
- Fix `initialFocus` as function being called on close (#2949) by @atomiks
- Support detached triggers (#2974) by @michaldudak
- Place `overflow: hidden` on `<body>` for overlay scrollbars by default. Avoids sticky elements shifting if `<body>` has an `overflow` style specified. (#3083) by @atomiks
- Add `<AlertDialog.Viewport>` part (#2808) by @atomiks
### Autocomplete
- **Breaking change:** Refactor `alwaysSubmitOnEnter` to `submitOnItemClick` prop.<br />
If you were using `alwaysSubmitOnEnter`, be sure to update your usage to `submitOnItemClick` instead.
(#3018) by @atomiks
- Prevent blocking filtering while composing text on Android (#2944) by @atomiks
- Add empty state to `List.State` (#2934) by @atomiks
- Fix `initialFocus` as function being called on close (#2949) by @atomiks
- Add `role="combobox"` to `<Autocomplete.Trigger>` if `<Autocomplete.Input>` is inside Popup (#2973) by @atomiks
- Fix stale `onItemHighlighted` data when filtering with `autoHighlight` (#2829) by @atomiks
- Add empty and side styling attributes on `<Autocomplete.Input>` (#2926) by @atomiks
- Fix `<Autocomplete.Value>` component return type for React 17 (#3050) by @atomiks
- Support `autoHighlight: "always"`, and add `keepHighlight`, `highlightItemOnHover` props (#2976) by @atomiks
- Keep focus on input when pressing list element (#3092) by @atomiks
- Allow <kbd>Esc</kbd> to bubble if `<Autocomplete.Empty>` is not used (#2935) by @atomiks
- Add `dialog` role to popup when input is inside (#3213) by @atomiks
### Button
- New `<Button>` component (#2363) by @atomiks
### Checkbox
- **Breaking change:** Render root as `<span>` instead of `<button>`
(#3205) by @mj12albert
### Collapsible
- Fix `starting-style` state (#2985) by @atomiks
### Combobox
- Take into account `isItemEqualToValue` when selecting an option in multiple mode (#2893) by @epr3
- Move `CompositeList` to `List` component to make `Input` work with composites (#2883) by @chuganzy
- Fix `onValueChange` type inference when `value` is unspecified (#2897) by @atomiks
- Fix `required` form submission with multiple values (#2925) by @atomiks
- Fix <kbd>Home</kbd>/<kbd>End</kbd> Input scroll in Chrome/Safari (#2928) by @atomiks
- Prevent blocking filtering while composing text on Android (#2944) by @atomiks
- Add empty state to `List.State` (#2934) by @atomiks
- Fix `initialFocus` as function being called on close (#2949) by @atomiks
- Add `role="combobox"` to `<Combobox.Trigger>` if `<Combobox.Input>` is inside Popup (#2973) by @atomiks
- Fix `Field` control ref when input is inside popup (#2971) by @atomiks
- Fix stale `onItemHighlighted` data when filtering with `autoHighlight` (#2829) by @atomiks
- Add empty and side styling attributes on `<Combobox.Input>` (#2926) by @atomiks
- Fix `<Combobox.Value>` component return type for React 17 (#3050) by @atomiks
- Fix input value derivation on `value` and `items` prop updates (#3067) by @atomiks
- Support `autoHighlight: "always"`, and add `keepHighlight`, `highlightItemOnHover` props (#2976) by @atomiks
- Keep focus on input when pressing list element (#3092) by @atomiks
- Fix support of dialog + combobox pattern (#3049) by @atomiks
- Support drag-to-select (#3167) by @atomiks
- Allow <kbd>Esc</kbd> to bubble if `<Combobox.Empty>` is not used (#2935) by @atomiks
- Fix stuck filtering with differing stringifiers (#3201) by @atomiks
- Add `dialog` role to popup when input is inside (#3213) by @atomiks
### Context Menu
- Add `open` state to `<ContextMenu.Trigger>` (#3195) by @atomiks
- Fix ignored `anchor` prop on `<ContextMenu.Positioner>` (#3202) by @atomiks
### Dialog
- **Breaking change:** Replace `dismissible` with `disablePointerDismissal`.<br />
If you were using `dismissible={false}`, replace it with `disablePointerDismissal`.
(#3190) by @mnajdova
- Fix `initialFocus` as function being called on close (#2949) by @atomiks
- Support detached triggers (#2974) by @michaldudak
- Place `overflow: hidden` on `<body>` for overlay scrollbars by default. Avoids sticky elements shifting if `<body>` has an `overflow` style specified. (#3083) by @atomiks
- Add `<Dialog.Viewport>` part and scrollable demos on docs (#2808) by @atomiks
### Field
- **Breaking change:** Add `onSubmit` validation mode and make it the default over `onBlur`.<br />
Fields that use non-`required` attribute validation no longer validate the control on blur. Instead, validation first occurs `onSubmit`, and afterwards revalidation occurs `onChange`.
(#3013) by @mj12albert
- Add `dirty` and `touched` props (#2950) by @mj12albert
- New `<Field.Item>` part (#2810) by @mj12albert
- Fix `validationMode="onChange"` not clearing custom error state (#3048) by @mj12albert
- Fix external `onChange` validation mode errors (#3137) by @atomiks
### Form
- **Breaking change:** The `onClearErrors` prop has been removed.<br />
Errors from the `errors` prop are always cleared when the value changes.
(#3136) by @mj12albert
- Add `onSubmit` validation mode.<br />
Additionally, `validationMode` can be set on `<Form>`.
(#3013) by @mj12albert
- Add `onFormSubmit` callback (#3131) by @mj12albert
### Menu
- **Breaking change:** Support detached triggers.<br />
`openOnHover`, `delay`, and `closeDelay` props have been moved from `<Menu.Root>` to `<Menu.Trigger>`.<br />
Additionally, menus now must have at least one `<Menu.Trigger>` element.
(#3170) by @michaldudak
- Ignore disabled item on initial focusing (#2604) by @mnajdova
- Fix stealing focus from dialogs on close (#2920) by @atomiks
- Place `overflow: hidden` on `<body>` for overlay scrollbars by default. Avoids sticky elements shifting if `<body>` has an `overflow` style specified. (#3083) by @atomiks
### Navigation Menu
- Fix nested popup dismiss actions (#2978) by @atomiks
- Fix error on React 17 (#3204) by @atomiks
### Number Field
- Granular change reasons (#3132) by @atomiks
### Popover
- **Breaking change:** Support detached triggers and multiple triggers per popover.<br />
`openOnHover`, `delay`, and `closeDelay` props have been moved from `<Popover.Root>` to `<Popover.Trigger>`.
(#2336) by @michaldudak
- Fix `initialFocus` as function being called on close (#2949) by @atomiks
- Fix swiping or scrolling on nested popup dismissing popover on touch (#3011) by @atomiks
- Place `overflow: hidden` on `<body>` for overlay scrollbars by default. Avoids sticky elements shifting if `<body>` has an `overflow` style specified. (#3083) by @atomiks
### Preview Card
- **Breaking change:** Move delay props to trigger.<br />
If you were using `delay` or `closeDelay` props, be sure to move them to from `<PreviewCard.Root>` to the `<PreviewCard.Trigger>` component.
(#3182) by @atomiks
### Radio Group
- **Breaking change:** Render root as `<span>` instead of `<button>`
(#3205) by @mj12albert
### Scroll Area
- **Breaking change:** Improve CSS vars performance.<br />
The CSS variables are now on the `<ScrollArea.Viewport>` part, not `<ScrollArea.Root>`, and inheritance is disabled for all child elements (or pseudo-elements). Children must manually opt in using `--scroll-area-[variable-name]: inherit`.
(#3156) by @atomiks
### Select
- **Breaking change:** Make the trigger native button by default.<br />
The trigger now renders a `<button>` element, be sure to adjust your code if necessary.
(#3177) by @mnajdova
- Add `open` state type on `Select.Icon` interface (#2919) by @komkanit
- Fix `onValueChange` type inference when `value` is unspecified (#2897) by @atomiks
- Fix `required` form submission with multiple values (#2925) by @atomiks
- Avoid re-rendering on popup height expansion (#2972) by @atomiks
- Place `overflow: hidden` on `<body>` for overlay scrollbars by default. Avoids sticky elements shifting if `<body>` has an `overflow` style specified. (#3083) by @atomiks
- Add `data-placeholder` attribute (#2737) by @seongminn
### Slider
- **Breaking change:** Add `thumbCollisionBehavior` prop.<br />
In range sliders, moving a thumb with a pointer will now push other thumbs it collides with to avoid blocking drag movements by default (the default value is `push`).<br />
The value `swap` was also added, which allows thumbs to be dragged past each other when they collide.<br />
Lastly, the value `none` is the same as the previous behavior, where thumbs can't be dragged past one another.<br />
Keyboard interactions always use `none` behavior.
(#2856) by @atomiks
- Granular change reasons (#3132) by @atomiks
### Switch
- **Breaking change:** Render root as `<span>` instead of `<button>`
(#3205) by @mj12albert
### Tabs
- **Breaking change:** Fix selected/active state naming consistency.<br />
- Renamed `[data-selected]` to `[data-active]` in `<Tabs.Tab>`
- Removed `[data-highlighted]` (`:focus-visible` was already the recommendation in styles)
- `selectedTabPosition`/`selectedTabSize` are now `activeTabPosition`/`activeTabSize` in `Tabs.Indicator.State`
(#3024) by @atomiks
- **Breaking change:** Change `activateOnFocus` to false.<br />
If you need your Tabs to activate on focus, be sure to add `activateOnFocus` prop.
(#3176) by @mnajdova
- Fix Next.js 16 error from `Math.random` id generation (#3051) by @atomiks
- Fix indicator sizing and offsets (#3214) by @atomiks
### Toast
- Allow `React.ReactNode` for `title`/`description` properties (#2929) by @atomiks
- Add ability to anchor to an element (#3096) by @atomiks
### Toolbar
- **Breaking change:** The `cols` prop has been removed.<br />
This prop was not supposed to be exposed.
(#3133) by @mj12albert
### Tooltip
- **Breaking change:** Support detached triggers.<br />
`delay` and `closeDelay` props have been moved from `<Tooltip.Root>` to `<Tooltip.Trigger>`.
(#3071) by @michaldudak
- **Breaking change:** Change `hoverable` to `disableHoverablePopup`.<br />
In case you need to disable the hoverable popup behavior, be sure to add the `disableHoverablePopup` prop.
(#3178) by @mnajdova
- Fix `data-instant` ending transition of same tooltip (#2962) by @atomiks
All contributors of this release in alphabetical order: @atomiks, @brianle1301, @brijeshb42, @chuganzy, @dav-is, @epr3, @fredericoo, @Janpot, @komkanit, @LukasTy, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @romgrk, @seongminn, @sukvvon, @ZeeshanTamboli
## v1.0.0-beta.4
_Oct 1, 2025_
### General changes
- **Breaking change:** Generic event details.
The main exported type is now `BaseUIChangeEventDetails` (with a paired `BaseUIGenericEventDetails`), not `BaseUIEventDetails`.
(#2796) by @atomiks
- Update `disabled` prop of buttons when ref changes (#2756) by @chuganzy
- Refine event details (#2698) by @atomiks
### Accordion
- **Breaking change:** Use `useId` instead of composite index as fallback value.
Accordion items must have an explicit `value` set in order to be initially open. Inferring the value by their DOM index is no longer supported.
(#2664) by @mj12albert
- **Breaking change:** Rename `openMultiple` prop to `multiple`
(#2764) by @LukasTy
### Autocomplete
- **Breaking change:** Rename `cols` to `grid` prop.
Specify `grid={true}` instead of `cols={number}` - the columns are automatically inferred from `Autocomplete.Row`
(#2683) by @atomiks
- Fix duplicate `onOpenChange` calls and pass correct DOM `event`.
(#2682) by @atomiks
- Fix controlled input value updates (#2707) by @atomiks
- Fix input focus on close when clicking trigger (#2723) by @atomiks
- Add `alwaysSubmitOnEnter` prop and allow form submission on <kbd>Enter</kbd> if no item is highlighted by default (#2700) by @atomiks
- Use `ReadonlyArray` type for `items` (#2819) by @atomiks
### Collapsible
- Fix CollapsiblePanel type to use its own state (#2697) by @chuganzy
- Respect user's CSS `display` property on panel (#2772) by @mj12albert
### Combobox
- **Breaking change**: `onItemHighlighted` now has a `reason` property instead of `type` to be consistent with the `eventDetails` API. (#2796) by @atomiks
- **Breaking change:** Rename `cols` to `grid` prop.
Specify `grid={true}` instead of `cols={number}` - the columns are automatically inferred from `Combobox.Row`
(#2683) by @atomiks
- Fix duplicate `onOpenChange` calls and pass correct DOM `event`.
(#2682) by @atomiks
- Fix initial closed typeahead (#2665) by @atomiks
- Support `autoHighlight` prop (#2668) by @atomiks
- Set default input value based on `value` prop (#2680) by @atomiks
- Fix controlled input value updates (#2707) by @atomiks
- Fix input focus on close when clicking trigger. Fixes a jump to the bottom of the page in Safari (#2723) by @atomiks
- Fix unexpected close with multiple selection and input inside popup (#2771) by @atomiks
- Allow form submission on <kbd>Enter</kbd> if no item is highlighted by default (#2700) by @atomiks
- Avoid refiltering with ending transition in multiple selection mode (#2681) by @atomiks
- Support object values with `isItemEqualToValue` prop (#2704) by @atomiks
- Use `ReadonlyArray` type for `items` (#2819) by @atomiks
- Fix misleading `item-press` reason in `onInputValueChange` (#2830) by @atomiks
- Clear single-select value on input clear (#2860) by @atomiks
- Fix `focusout` of input not closing popup under certain conditions (#2864)
### Context Menu
- Ensure submenus close when parents close (#2768) by @atomiks
- Fix `onClick` firing twice on first click of item (#2849) by @atomiks
### Menu
- Ensure submenus close when parents close (#2768) by @atomiks
- Allow non-nested portals across differing popup trees (#2818) by @atomiks
### Menubar
- Fix Menubar not disabling child Menus (#2736) by @aarongarciah
- Ensure submenus close when parents close (#2768) by @atomiks
- Fix `CompositeList` not updating item order on reordering (#2675) by @chuganzy
### Navigation Menu
- Make link close on click configurable (#2740) by @atomiks
- Fix focus returning to trigger without animations (#2779) by @atomiks
- Fix `CompositeList` not updating item order on reordering (#2675) by @chuganzy
### Number Field
- Fix stuck virtual cursor after mouse tap (#2720) by @atomiks
- Improve parsing logic (#2725) by @atomiks
- Align value changes with `Slider`. An `onValueCommitted` callback has been added. (#2726) by @atomiks
### Popover
- Allow non-nested portals across differing popup trees (#2818) by @atomiks
### Scroll Area
- Add overflow presence state attributes and CSS variables (#2478) by @atomiks
- Fix RTL horizontal scrollbar on Safari (#2776) by @atomiks
- Fix thumb size flicker (#2778) by @atomiks
### Select
- **Breaking change:** Add `Select.List` component. It is now possible for `Select.ScrollArrow` to show when in fallback (`alignItemWithTrigger` deactivated). As a result, if you want the scroll arrows to be hidden in this mode like before, change the styles to default to `display: none` on `.ScrollArrow`, and `display: block` when `[data-side="none"]`. (#2596) by @atomiks
- Block opening the popup when provided `readOnly` (#2717) by @seongminn
- Add `open` state for `Select.Icon` and fix `ref` type (#2714) by @seongminn
- Support object values with `isItemEqualToValue` prop (#2704) by @atomiks
- Use `ReadonlyArray` type for `items` (#2819) by @atomiks
### Slider
- **Breaking change:** `onValueChange` has `activeThumbIndex` as part of the `eventDetails` object as a second parameter, not third. (#2796) by @atomiks
- **Breaking change:** Remove redundant hidden inputs.
The `inputRef` prop is moved from `Root` to `Thumb`.
(#2631) by @mj12albert
- Fix pointer tracking bugs (#2688) by @mj12albert
- Fix input attributes (#2728) by @mj12albert
- Add `thumbAlignment` prop (#2540) by @mj12albert
### Switch
- Fix duplicate `name` attribute (#2763) by @mj12albert
### Toast
- **Breaking change:** Support variable height stacking.
Toasts that have varying heights no longer force a `data-expanded` expanded state on the viewport. CSS should be amended to ensure larger toasts don't overflow a small toast stacked at the front. See this [diff](https://github.com/mui/base-ui/pull/2742/files#diff-e378460dafb74fe0c90ef960ad0ef1c38d68d74b63815520bb437f9041361917) for new styles, along with general improvements to stacking styles.
(#2742) by @atomiks
- Reduce stickiness of expanded state (#2770) by @atomiks
- Ensure toast is frozen at its current visual transform while swiping (#2769) by @atomiks
### Toggle Group
- **Breaking change:** Rename `toggleMultiple` prop to `multiple`.
(#2764) by @LukasTy
### Toolbar
- Fix `CompositeList` not updating item order on reordering (#2675) by @chuganzy
### useRender
- Add div as a `defaultTagName` (#2692) by @mnajdova
All contributors of this release in alphabetical order: @aarongarciah, @atomiks, @brijeshb42, @chuganzy, @Copilot, @Janpot, @LukasTy, @martenbjork, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @seongminn, @sukvvon, @vladmoroz
## v1.0.0-beta.3
_Sep 3, 2025_
### General changes
- **Breaking change:** Base UI event details.
Custom event callbacks provide BaseUIEventDetails object as their second parameter.
This object contains the source event, reason and methods to customize the behavior (where applicable).
For example, `onOpenChange(open, event, reason)` becomes `onOpenChange(open, eventDetails)`, where `eventDetails` contains `event` and `reason` properties.
```diff
-onOpenChange: (open, event, reason) => {
+onOpenChange: (open, eventDetails) => {
- if (reason === 'escape-key') {
+ if (eventDetails.reason === 'escape-key') {
// ...
}
}
```
(#2382) by @atomiks
### Alert Dialog
- **Breaking change:** Support `initialFocus` and `finalFocus` functions.
The `initialFocus` and `finalFocus` props can be functions that return DOM elements to focus.
This is a new feature for `finalFocus` and a breaking change for `initialFocus` as the element must be returned directly (not as a ref).
(#2536) by @atomiks
### Autocomplete
- New Autocomplete component (#2105) by @atomiks
### Checkbox
- Fix missing validity attributes when wrapped in `Field` (#2572) by @Copilot
### Combobox
- New Combobox component (#2105) by @atomiks
### Context Menu
- Fix default offsets when `align="center"` or `side` differs (#2601) by @atomiks
### Dialog
- **Breaking change:** Support `initialFocus` and `finalFocus` functions.
The `initialFocus` and `finalFocus` props can be functions that return DOM elements to focus.
This is a new feature for `finalFocus` and a breaking change for `initialFocus` as the element must be returned directly (not as a ref).
(#2536) by @atomiks
- Restore focus to popup when focused element is removed (#2479) by @atomiks
### Field
- Prevent defaultValue reset on focus for uncontrolled inputs (#2543) by @ingokpp
- Allow `onValueChange` to fire when `defaultValue`/`value` are not set (#2600) by @atomiks
### Input
- Allow `onValueChange` to fire when `defaultValue`/`value` are not set (#2600) by @atomiks
### Menu
- **Breaking change:** Fix `closeParentOnEsc` default value.
The default value of `closeParentOnEsc` in Menu.SubmenuRoot is now false.
When the <kbd>Esc</kbd> key is pressed in a Submenu, the Submenu closes, and the focus correctly moves to the SubmenuTrigger.
(#2493) by @seongminn
- **Breaking change:** Support `initialFocus` and `finalFocus` functions.
The `initialFocus` and `finalFocus` props can be functions that return DOM elements to focus.
This is a new feature for `finalFocus` and a breaking change for `initialFocus` as the element must be returned directly (not as a ref).
(#2536) by @atomiks
- Fix menu not opening when inside context menu trigger (#2506) by @baptisteArno
- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function (#2511) by @atomiks
- Fix submenu events (#2483) by @atomiks
- Fix `limitShift` offset based on arrow size (#2571) by @atomiks
### Navigation Menu
- **Breaking change:** Semantic element structure and `active` page prop.
`NavigationMenu.List` renders `<ul>` and `NavigationMenu.Item` renders `<li>` by default.
(#2526) by @atomiks
- Unshare `AbortController` instance (#2441) by @tomokinat
- Close on link click by default (#2535) by @atomiks
### Number Field
- Fix duplicate `onValueChange` calls (#2591) by @atomiks
### Popover
- **Breaking change:** Support `initialFocus` and `finalFocus` functions.
The `initialFocus` and `finalFocus` props can be functions that return DOM elements to focus.
This is a new feature for `finalFocus` and a breaking change for `initialFocus` as the element must be returned directly (not as a ref).
(#2536) by @atomiks
- Fix outside click after right clicking in popup (#2508) by @baptisteArno
- Fix unexpected close when nested inside two popovers (#2481) by @atomiks
- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function (#2511) by @atomiks
- Restore focus to popup when focused element is removed (#2479) by @atomiks
- Fix `limitShift` offset based on arrow size (#2571) by @atomiks
### Preview Card
- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function (#2511) by @atomiks
- Fix `limitShift` offset based on arrow size (#2571) by @atomiks
### Radio Group
- Return null in form data when no option selected (#2473) by @ingokpp
### Scroll Area
- Prevent pointer events from sibling portals triggering hover (#2542) by @KenanYusuf
### Select
- Fix stale `items` prop (#2397) by @atomiks
- Fix unexpected close when nested inside two popovers (#2481) by @atomiks
- Fix `onValueChange` type inference (#2372) by @atomiks
- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function (#2511) by @atomiks
- Reset state when selected item is removed (#2577) by @atomiks
- Fix `data-highlighted` and DOM focus item desync (#2569) by @atomiks
- Fix item click with `defaultOpen` prop (#2570) by @atomiks
- Fix scroll arrows not propagating scroll fully to start/end of list (#2523) by @atomiks
- Fix `limitShift` offset based on arrow size (#2571) by @atomiks
### Slider
- **Breaking change:** Instead of the thumb div, the `input type="range"` element receives focus. Focus styles that were targeting the thumb, should be updated.
For example `.Thumb:focus-visible` should be replaced with `.Thumb:has(:focus-visible)`.
The `tabIndex` prop is moved from Root to Thumb where it gets forwarded to the input.
The thumb's `render` prop no longer contains the third `inputProps` argument; the input element is instead merged with children.
(#2578) by @mj12albert
- Reduce bundle size (#2551) by @oliviertassinari
- Fix thumb `:focus-visible` with mixed keyboard and pointer modality (#2584) by @mj12albert
- Add `index` prop to `Slider.Thumb` (#2593) by @mj12albert
### Tabs
- Fix tab size rounding (#2488) by @atomiks
- Fix highlight sync when focus is inside list (#2487) by @atomiks
### Tooltip
- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function (#2511) by @atomiks
- Fix `limitShift` offset based on arrow size (#2571) by @atomiks
### useRender
- Add support for data-\* attributes (#2524) by @Raghuboi
- Add `defaultTagName` parameter (#2527) by @atomiks
All contributors of this release in alphabetical order: @atomiks, @baptisteArno, @brijeshb42, @Copilot, @ingokpp, @Janpot, @KenanYusuf, @LukasTy, @michaldudak, @mirka, @mj12albert, @mnajdova, @oliviertassinari, @Powerplex, @Raghuboi, @seongminn, @tomokinat
## v1.0.0-beta.2
_Jul 30, 2025_
### General changes
- Fix navigator checks and ensure safe platform retrieval (#2273) by @mo36924
- Prevent `Space` key default on keydown (#2295) by @atomiks
- Check for `performance` existence on server (#2316) by @atomiks
### Accordion
- Destructure `render` prop (#2280) by @atomiks
- Fix keyboard interactions with elements in the panel (#2321) by @mj12albert
- Fix open transitions in Safari/Firefox (#2327) by @atomiks
### Alert Dialog
- Support `ShadowRoot` containers (#2236) by @atomiks
- Add `forceRender` prop to `Backdrop` part (#2037) by @atomiks
- Improve outside press behavior with touch input (#2334) by @atomiks
### Checkbox
- Fix focusing form controls with `inputRef` (#2252) by @mj12albert
### Collapsible
- Destructure render prop (#2323) by @atomiks
- Fix open transitions in Safari/Firefox (#2327) by @atomiks
### Dialog
- Support `ShadowRoot` containers (#2236) by @atomiks
- Add `forceRender` prop to `Backdrop` part (#2037) by @atomiks
- Improve outside press behavior with touch input (#2334) by @atomiks
- Use `click` event for outside press dismissal (#2275) by @atomiks
### Field
- Deregister fields from `Form` when unmounting (#2231) by @mj12albert
### Form
- Deregister fields from `Form` when unmounting (#2231) by @mj12albert
### Menu
- Support `ShadowRoot` containers (#2236) by @atomiks
- Avoid double `useRenderElement` passes (#2256) by @atomiks
- Improve outside press behavior with touch input (#2334) by @atomiks
- Close submenus when focus is lost by shift-tabbing (#2290) by @michaldudak
### Menubar
- Fix triggers role (#2317) by @atomiks
### Meter
- Fix ARIA attributes and update docs (#2267) by @mj12albert
### Navigation Menu
- **Breaking change:** Support inlined nesting.
Ensure the popup's `width` is set to `var(--popup-width)` unconditionally (without the media query) on the `.Popup` class.
(#2269) by @atomiks
- Avoid double `useRenderElement` passes (#2256) by @atomiks
- Add `useButton` integration to `Trigger` (#2296) by @atomiks
- Fix popup size transitions on iOS (#2387) by @atomiks
### Number Field
- Remove `invalid` prop (#2315) by @atomiks
- Fix button disabled state only including root disabled state (#2268) by @mj12albert
### Popover
- Support `ShadowRoot` containers (#2236) by @atomiks
- Remove ancestor nodes from inside elements for outside press detection (#2339) by @atomiks
- Improve outside press behavior with touch input (#2334) by @atomiks
- Use `click` event for outside press dismissal (#2275) by @atomiks
### Preview Card
- Support `ShadowRoot` containers (#2236) by @atomiks
### Progress
- Fix ARIA attributes and update docs (#2267) by @mj12albert
### Radio Group
- Add aria-required attribute (#2227) by @cgatian
- Extend state with `FieldRoot.State` (#2251) by @mj12albert
- Fix focusing form controls with `inputRef` (#2252) by @mj12albert
- Avoid double `useRenderElement` passes (#2256) by @atomiks
### Scroll Area
- Disable `user-select` on scrollbar and non-main button interactions (#2338) by @atomiks
### Select
- Support `ShadowRoot` containers (#2236) by @atomiks
- Add `value` and `readOnly` to `Select.Trigger` state (#2237) by @atomiks
- Add `multiple` prop (#2173) by @atomiks
- Allow typeahead while open for `multiple` mode (#2274) by @atomiks
- Ensure positionerElement is available in document mouseup (#2276) by @atomiks
- Fix `alignItemWithTrigger` fallback scroll jump (#2241) by @atomiks
- Support conditional `multiple` prop in types (#2369) by @atomiks
- Fix multiple ARIA behavior on touch (#2333) by @atomiks
- Improve outside press behavior with touch input (#2334) by @atomiks
### Slider
- Fix focusing form controls with `inputRef` (#2252) by @mj12albert
### Toast
- Fix `promise` method timeout option handling (#2294) by @atomiks
- Make `Toast.Viewport` an announce container (#2246) by @atomiks
### Toggle
- Avoid double `useRenderElement` passes (#2256) by @atomiks
### Toggle Group
- Avoid double `useRenderElement` passes (#2256) by @atomiks
### Toolbar
- Avoid double `useRenderElement` passes (#2256) by @atomiks
### Tooltip
- Support `ShadowRoot` containers (#2236) by @atomiks
- Memoize leftover object in tooltip (#2250) by @sai6855
- Fix error when combining `defaultOpen` and `disabled` (#2374) by @atomiks
All contributors of this release in alphabetical order: @aelfannir, @atomiks, @brijeshb42, @cgatian, @Janpot, @michaldudak, @mj12albert, @mo36924, @romgrk, @sai6855
## v1.0.0-beta.1
_Jul 1, 2025_
### General changes
- Make error messages consistent (#2049) by @michaldudak
- Do not overwrite event handler when `undefined` is passed explicitly (#2151) by @michaldudak
### Accordion
- Allow content to resize naturally (#2043) by @atomiks
- Fix transition status mapping (#2169) by @atomiks
- Fix `aria-controls` reference (#2170) by @atomiks
- Fix test warning about mixed animation types (#2180) by @atomiks
### Checkbox
- **Breaking change:** Support implicit `Field.Label`.
If `Field.Label` encloses Switch/Checkbox/Radio, the `htmlFor`/`id` attributes are no longer explicitly set to associate them.
(#2036) by @mj12albert
- Refactor to `useRenderElement` (#2053) by @mj12albert
- Always set `id` on the `<input>` element (#2115) by @mj12albert
### Checkbox Group
- Fix `onCheckedChange` not running when parent checkbox is present (#2155) by @mj12albert
### Collapsible
- Allow content to resize naturally (#2043) by @atomiks
- Fix `aria-controls` reference (#2170) by @atomiks
- Fix test warning about mixed animation types (#2180) by @atomiks
### Context Menu
- **Breaking change:** Add `SubmenuRoot` part.
Nested menus should be defined with `Menu.SubmenuRoot` instead of `Menu.Root` to to avoid ambiguity.
(#2042) by @atomiks
- Fix CheckboxItemIndicator export (#2009) by @aarongarciah
### Dialog
- Fix popup prop merging (#2119) by @atomiks
### Field
- **Breaking change:** Support implicit `Field.Label`.
If `Field.Label` encloses Switch/Checkbox/Radio, the `htmlFor`/`id` attributes are no longer explicitly set to associate them.
(#2036) by @mj12albert
- Enable custom validation based on other form values (#1941) by @mj12albert
- Fix `onValueChange` `value` type (#2112) by @atomiks
- Fix `Field.Label` focusing trigger (#2118) by @atomiks
- Fix slider field label (#2154) by @mj12albert
### Fieldset
- Refactor to `useRenderElement` (#2053) by @mj12albert
### Form
- Enable custom validation based on other form values (#1941) by @mj12albert
### Input
- Fix `onValueChange` `value` type (#2112) by @atomiks
### Menu
- **Breaking change:** Add `SubmenuRoot` part.
Nested menus should be defined with `Menu.SubmenuRoot` instead of `Menu.Root` to to avoid ambiguity.
(#2042) by @atomiks
- Unset `role` from Trigger (#2047) by @atomiks
- Emit `close` event on `cancel-open` (#2067) by @atomiks
- Fix close toggle when rendering non-native button (#2071) by @atomiks
- Add `highlighted` to item `State` (#2079) by @atomiks
- Remove highlighted effect (#2162) by @atomiks
- Cut out internal backdrop to allow interacting with triggers (#2141) by @michaldudak
- Fix active index sync on hover (#2163) by @atomiks
- Fix focus returning to root when submenus have exit transitions (#2163) by @atomiks
### Menubar
- Fix `closeOnClick: false` not working in nested menus (#2094) by @michaldudak
### Navigation Menu
- Handle layout resize while open (#2070) by @atomiks
- Fix positioner height when opening menu using the keyboard arrows (#2060) by @juliomerisio
### Number Field
- Ensure `onValueChange` is called with already-formatted parsed value (#1905) by @atomiks
- Fix revalidation on change (#2174) by @atomiks
### Popover
- Fix close toggle when rendering non-native button (#2071) by @atomiks
- Cut out internal backdrop to allow interacting with triggers (#2141) by @michaldudak
### Radio Group
- **Breaking change:** Support implicit `Field.Label`.
If `Field.Label` encloses Radio, the `htmlFor`/`id` attributes are no longer explicitly set to associate them.
(#2036) by @mj12albert
- Refactor to `useRenderElement` (#2053) by @mj12albert
### Scroll Area
- Ignore `data-scrolling` during programmatic scroll (#1908) by @atomiks
### Select
- **Breaking change:** Print raw value in `Select.Value`.
`<Select.Value>` now prints the raw value by default unless an `items` prop is specified on `Select.Root`.
See https://base-ui.com/react/components/select#formatting-the-value for more information.
(#2087) by @atomiks
- Performance: avoid re-renders (#1961) by @romgrk
- Fix close toggle when rendering non-native button (#2071) by @atomiks
- Fix `Field.Label` focusing trigger (#2118) by @atomiks
- Fix programmatic value changes and autofill handling (#2084) by @atomiks
- Add `highlighted` to item `State` (#2079) by @atomiks
- Cut out internal backdrop to allow interacting with triggers (#2141) by @michaldudak
- Pass `value` as state (#2153) by @atomiks
- Extend `FieldRoot.State` type (#2192) by @atomiks
### Slider
- Use pointer capture when dragging (#2059) by @mj12albert
- Fix slider field label (#2154) by @mj12albert
### Switch
- **Breaking change:** Support implicit `Field.Label`.
If `Field.Label` encloses Switch, the `htmlFor`/`id` attributes are no longer explicitly set to associate them.
(#2036) by @mj12albert
### Tabs
- Fix indicator positioning when TabsList overflows (#2093) by @mj12albert
- Fix focus going out of sync when selected value is changed externally (#2107) by @atomiks
- Remove highlighted state (#2164) by @atomiks
### Toolbar
- Set `disabled` attr on toolbar button when `focusableWhenDisabled={false}` (#2176) by @mj12albert
### useRender
- Make useRender RSC-friendly (#2134) by @michaldudak
All contributors of this release in alphabetical order: @aarongarciah, @atomiks, @bernardobelchior, @brijeshb42, @Janpot, @juliomerisio, @lesha1201, @michaldudak, @mj12albert, @oliviertassinari, @romgrk
## v1.0.0-beta.0
_May 29, 2025_
### General changes
- Remove proptypes (#1760) by @michaldudak
- Unify component export patterns (#1478) by @michaldudak
- Default `tabIndex` to `0` on `<button>` parts (#1939) by @atomiks
### Accordion
- Stop event propagation to allow composite components to be used within popups (#1871) by @atomiks
### Alert Dialog
- **Breaking change:** Refine `OpenChangeReason`. `hover` is now `trigger-hover`; `click` is now `trigger-press`; `focus` is now `trigger-focus`.
(#1782) by @atomiks
- Use basic scroll lock on iOS
(#1890) by @atomiks
### Checkbox
- Set `aria-required`, use `useButton` (#1777) by @mj12albert
### Checkbox Group
- **Breaking change:** Enable submitting checkbox group value as one field.
For parent checkboxes, use `value` instead of `name` on each `Checkbox.Root` part to link as the values.
(#1948) by @mj12albert
- Fix `validate` fn incorrectly running twice (#1959) by @mj12albert
### Context Menu
- New `ContextMenu` component (#1665) by @atomiks
### Dialog
- **Breaking change:** Refine `OpenChangeReason`. `hover` is now `trigger-hover`; `click` is now `trigger-press`; `focus` is now `trigger-focus`.
(#1782) by @atomiks
- Use basic scroll lock on iOS
(#1890) by @atomiks
### Field
- **Breaking change:** Consolidate `Field.Error` `forceShow` into `match` prop.
Use `match={true}` (or implicit boolean) instead of `forceShow`.
(#1919) by @atomiks
- Improve `Label` logic that prevents text selection on double click (#1784) by @atomiks
- Fix validation inconsistency (#1779) by @atomiks
- Fix integration of Base UI components (#1755) by @atomiks
- Set `valueMissing` to false if only error and not dirtied (#1810) by @atomiks
- `validate` with latest value on blur (#1850) by @atomiks
- Revalidate only `required` on change (#1840) by @atomiks
- Run validate function after native validations (#1926) by @mj12albert
- Fix `validate` fn incorrectly running twice (#1959) by @mj12albert
- Integrate range sliders with Form and Field (#1929) by @mj12albert
### Form
- Fix integration of Base UI components (#1755) by @atomiks
- Select inputs on focus (#1858) by @atomiks
- Exclude number formatting from form value (#1957) by @mj12albert
- Integrate range sliders with Form and Field (#1929) by @mj12albert
### Input
- Fix `Input.Props` type (#1915) by @mj12albert
- Extend `Field.Control.State` (#1954) by @atomiks
### Menu
- **Breaking change:** Refine `OpenChangeReason`. `hover` is now `trigger-hover`; `click` is now `trigger-press`; `focus` is now `trigger-focus`.
(#1782) by @atomiks
- Fix function dependency handling (#1787) by @atomiks
- Add missing `'use client'` to `RadioGroup` part (#1851) by @atomiks
- Ensure `null` items are removed from composite lists (#1847) by @atomiks
- Avoid `:focus-visible` style appearing (#1846) by @atomiks
- Better handle dynamic and non-string items (#1861) by @atomiks
- Add `collisionAvoidance` prop (#1849) by @atomiks
- Add `finalFocus` and `closeDelay` props (#1918) by @atomiks
- Use basic scroll lock o