@base-ui/react

Every stable release, newest first. Notes are quoted as the maintainers published them.

1. 1.9.0

   9 October 2026
   Export CssVariables and DataAttributes types

   General changes

   • Export CssVariables and DataAttributes types

   • Fix stale focused field state

   • Fix animation waits retaining detached elements

   • Keep item registration in sync when items change under Strict Mode

   • Avoid re-rendering inactive triggers on open and close

   Accordion

   • Fix <Accordion.Trigger>'s data-value and data-index attributes

   • Apply the native disabled attribute to <Accordion.Trigger> when using native buttons

   • Expand hiddenUntilFound panels synchronously on beforematch

   Alert Dialog

   • Don't associate a programmatically opened popup with a trigger that did not open it

   Autocomplete

   • Fix autoHighlight for asynchronous results

   • Pass the originating event to onItemHighlighted. Pointer events may be MouseEvent or PointerEvent; typing reports the reason none

   • Decouple automatic unmounting from actionsRef. Call eventDetails.preventUnmountOnClose() in onOpenChange to opt out of automatic unmounting

   Checkbox

   • Prefer aria-label over associated labels

   Collapsible

   • Apply the native disabled attribute to <Collapsible.Trigger> when using native buttons

   • Finish closing when the render function removes the panel

   • Restore animations when a removed panel reopens

   • Expand hiddenUntilFound panels synchronously on beforematch

   Combobox

   • Fix stale chip focus after returning to the input

   • Fix autoHighlight for asynchronous results

   • Decouple automatic unmounting from actionsRef. Call eventDetails.preventUnmountOnClose() in onOpenChange to opt out of automatic unmounting

   • Fix label focus in Shadow DOM

   • Pass the originating event to onItemHighlighted. Pointer events may be MouseEvent or PointerEvent; typing reports the reason none

   • Reset typeahead state when closing without moving focus

2. 1.8.0

   4 September 2026
   Fix label association when a control unregisters

   General changes

   • Fix label association when a control unregisters

   • Reduce animation completion work

   • Fix prop and ref merging for lazy render elements

   • Fix roving focus when items are added or removed

   • Fix hover and focus interaction issues

   • Improve trigger mount performance

   • Fix disabled anchor tracking on scroll

   • Fix transform origin for start/end alignment

   • Remove duplicate options key from arrow middleware

   • Register passive touch listeners

   Alert Dialog

   • Ignore outside clicks from presses that began before open

   Autocomplete

   • Render groups with the rowgroup role in grid mode

   • Allow opening and browsing the popup while readOnly

   • Move aria-orientation to the role owners

   • Hide group labels and scrollbars from the accessibility tree

   Avatar

   • Add keepMounted prop to <Avatar.Image>

   Checkbox

   • Fix stale and duplicated control IDs

   • Fix controlled blur validation and stale filled state

   Checkbox Group

   • Fix stale and duplicated control IDs

   Combobox

   • Fix applying data-readonly to <Combobox.Trigger>

   • Add createItems collection API

   • Fix cancellation when preserving the filter after selection

   • Render groups with the rowgroup role in grid mode

3. 1.7.0

   4 August 2026
   Restore visible focus after keyboard close in Safari and Firefox

   General changes

   • Restore visible focus after keyboard close in Safari and Firefox

   • Type render callback props based on the rendered element

   • Reduce popup bundle size

   • Reduce store bundle size

   • Keep unpositioned popups at the viewport origin

   • Correct layout and passive effect timing

   • Remove redundant lifecycle synchronization

   • Prevent stale cleanup from clearing registered part IDs

   • Complete popup unmounting after a canceled exit transition

   • Fix rendered trigger ID ownership

   • Prevent unwanted flip with capped scrollable content

   • Fix collisionPadding off-by-one on the biased side

   • Reduce shared popup bundle size

   • Mount popup subtrees synchronously when opening in React 17

   • Fix auto-resize origin for left-anchored popups

   • Avoid redundant re-renders during lazy flipping

   • Strip implementation-only types from published .d.ts files

   • Fix usePreviousValue equality comparison

   Accordion

   • Remove the implicit dir attribute from <Accordion.Root>

   Alert Dialog

   • Prevent <AlertDialog.Root> from reopening after remounting with a reused handle

   Autocomplete

   • Respect locale when filtering

   • Add input-press to change event details

   • Add cancel-open to change event details

   • Reset list scroll position on filter

   • Remove dead code and deduplicate handlers

   • Fix listbox separator semantics