[release] 1.0.0-beta.3 (#2616)

michaldudak · web-flow · commit 6d2e113cfb81 · 2025-09-03T17:27:35.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,158 @@
 # Versions
 
+## 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_
diff --git a/docs/src/app/(public)/(content)/react/components/autocomplete/demos/hero/css-modules/index.tsx b/docs/src/app/(public)/(content)/react/components/autocomplete/demos/hero/css-modules/index.tsx
@@ -16,12 +16,7 @@ export default function ExampleAutocomplete() {
             <Autocomplete.Empty className={styles.Empty}>No tags found.</Autocomplete.Empty>
             <Autocomplete.List>
               {(tag: Tag) => (
-                <Autocomplete.Item
-                  render={<a href="https://base-ui.com" aria-label={tag.value} />}
-                  key={tag.id}
-                  className={styles.Item}
-                  value={tag}
-                >
+                <Autocomplete.Item key={tag.id} className={styles.Item} value={tag}>
                   {tag.value}
                 </Autocomplete.Item>
               )}
diff --git a/docs/src/app/(public)/(content)/react/overview/releases/page.mdx b/docs/src/app/(public)/(content)/react/overview/releases/page.mdx
@@ -3,6 +3,148 @@
 <Subtitle>Changelogs for each Base UI release.</Subtitle>
 <Meta name="description" content="Changelogs for each Base UI release." />
 
+## 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.
+  ([#2382](https://github.com/mui/base-ui/pull/2382))
+
+### 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](https://github.com/mui/base-ui/pull/2536))
+
+### Autocomplete
+
+- New Autocomplete component ([#2105](https://github.com/mui/base-ui/pull/2105))
+
+### Checkbox
+
+- Fix missing validity attributes when wrapped in `Field` ([#2572](https://github.com/mui/base-ui/pull/2572))
+
+### Combobox
+
+- New Combobox component ([#2105](https://github.com/mui/base-ui/pull/2105))
+
+### Context Menu
+
+- Fix default offsets when `align="center"` or `side` differs ([#2601](https://github.com/mui/base-ui/pull/2601))
+
+### 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](https://github.com/mui/base-ui/pull/2536))
+- Restore focus to popup when focused element is removed ([#2479](https://github.com/mui/base-ui/pull/2479))
+
+### Field
+
+- Prevent defaultValue reset on focus for uncontrolled inputs ([#2543](https://github.com/mui/base-ui/pull/2543))
+- Allow `onValueChange` to fire when `defaultValue`/`value` are not set ([#2600](https://github.com/mui/base-ui/pull/2600))
+
+### Input
+
+- Allow `onValueChange` to fire when `defaultValue`/`value` are not set ([#2600](https://github.com/mui/base-ui/pull/2600))
+
+### 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](https://github.com/mui/base-ui/pull/2493))
+- **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](https://github.com/mui/base-ui/pull/2536))
+- Fix menu not opening when inside context menu trigger ([#2506](https://github.com/mui/base-ui/pull/2506))
+- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function ([#2511](https://github.com/mui/base-ui/pull/2511))
+- Fix submenu events ([#2483](https://github.com/mui/base-ui/pull/2483))
+- Fix `limitShift` offset based on arrow size ([#2571](https://github.com/mui/base-ui/pull/2571))
+
+### Navigation Menu
+
+- **Breaking change:** Semantic element structure and `active` page prop.
+  `NavigationMenu.List` renders `<ul>` and `NavigationMenu.Item` renders `<li>` by default.
+  ([#2526](https://github.com/mui/base-ui/pull/2526))
+- Unshare `AbortController` instance ([#2441](https://github.com/mui/base-ui/pull/2441))
+- Close on link click by default ([#2535](https://github.com/mui/base-ui/pull/2535))
+
+### Number Field
+
+- Fix duplicate `onValueChange` calls ([#2591](https://github.com/mui/base-ui/pull/2591))
+
+### 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](https://github.com/mui/base-ui/pull/2536))
+- Fix outside click after right clicking in popup ([#2508](https://github.com/mui/base-ui/pull/2508))
+- Fix unexpected close when nested inside two popovers ([#2481](https://github.com/mui/base-ui/pull/2481))
+- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function ([#2511](https://github.com/mui/base-ui/pull/2511))
+- Restore focus to popup when focused element is removed ([#2479](https://github.com/mui/base-ui/pull/2479))
+- Fix `limitShift` offset based on arrow size ([#2571](https://github.com/mui/base-ui/pull/2571))
+
+### Preview Card
+
+- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function ([#2511](https://github.com/mui/base-ui/pull/2511))
+- Fix `limitShift` offset based on arrow size ([#2571](https://github.com/mui/base-ui/pull/2571))
+
+### Radio Group
+
+- Return null in form data when no option selected ([#2473](https://github.com/mui/base-ui/pull/2473))
+
+### Scroll Area
+
+- Prevent pointer events from sibling portals triggering hover ([#2542](https://github.com/mui/base-ui/pull/2542))
+
+### Select
+
+- Fix stale `items` prop ([#2397](https://github.com/mui/base-ui/pull/2397))
+- Fix unexpected close when nested inside two popovers ([#2481](https://github.com/mui/base-ui/pull/2481))
+- Fix `onValueChange` type inference ([#2372](https://github.com/mui/base-ui/pull/2372))
+- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function ([#2511](https://github.com/mui/base-ui/pull/2511))
+- Reset state when selected item is removed ([#2577](https://github.com/mui/base-ui/pull/2577))
+- Fix `data-highlighted` and DOM focus item desync ([#2569](https://github.com/mui/base-ui/pull/2569))
+- Fix item click with `defaultOpen` prop ([#2570](https://github.com/mui/base-ui/pull/2570))
+- Fix scroll arrows not propagating scroll fully to start/end of list ([#2523](https://github.com/mui/base-ui/pull/2523))
+- Fix `limitShift` offset based on arrow size ([#2571](https://github.com/mui/base-ui/pull/2571))
+
+### 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](https://github.com/mui/base-ui/pull/2578))
+- Reduce bundle size ([#2551](https://github.com/mui/base-ui/pull/2551))
+- Fix thumb `:focus-visible` with mixed keyboard and pointer modality ([#2584](https://github.com/mui/base-ui/pull/2584))
+- Add `index` prop to `Slider.Thumb` ([#2593](https://github.com/mui/base-ui/pull/2593))
+
+### Tabs
+
+- Fix tab size rounding ([#2488](https://github.com/mui/base-ui/pull/2488))
+- Fix highlight sync when focus is inside list ([#2487](https://github.com/mui/base-ui/pull/2487))
+
+### Tooltip
+
+- Fix `transform-origin` variable calculation when Positioner `sideOffset` is a function ([#2511](https://github.com/mui/base-ui/pull/2511))
+- Fix `limitShift` offset based on arrow size ([#2571](https://github.com/mui/base-ui/pull/2571))
+
+### useRender
+
+- Add support for data-\* attributes ([#2524](https://github.com/mui/base-ui/pull/2524))
+- Add `defaultTagName` parameter ([#2527](https://github.com/mui/base-ui/pull/2527))
+
 ## v1.0.0-beta.2
 
 **Jul 30, 2025**
diff --git a/docs/src/nav.ts b/docs/src/nav.ts
@@ -51,7 +51,6 @@ export const nav: NavGroup[] = [
         label: 'llms.txt',
         external: true,
         href: '/llms.txt',
-        isNew: true,
       },
     ],
   },
@@ -159,7 +158,6 @@ export const nav: NavGroup[] = [
       {
         label: 'Select',
         href: '/react/components/select',
-        isNew: true,
       },
       {
         label: 'Separator',
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@base-ui-components/monorepo",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.3",
   "private": true,
   "scripts": {
     "preinstall": "npx only-allow pnpm",
diff --git a/packages/react/package.json b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@base-ui-components/react",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.3",
   "author": "MUI Team",
   "description": "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.",
   "keywords": [
diff --git a/packages/utils/package.json b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@base-ui-components/utils",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A collection of React utility functions for Base UI.",
   "repository": {
     "type": "git",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@base-ui-components/monorepo",`
`3`		`- "version": "1.0.0-beta.2",`
	`3`	`+ "version": "1.0.0-beta.3",`
`4`	`4`	`"private": true,`
`5`	`5`	`"scripts": {`
`6`	`6`	`"preinstall": "npx only-allow pnpm",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@base-ui-components/react",`
`3`		`- "version": "1.0.0-beta.2",`
	`3`	`+ "version": "1.0.0-beta.3",`
`4`	`4`	`"author": "MUI Team",`
`5`	`5`	`"description": "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.",`
`6`	`6`	`"keywords": [`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@base-ui-components/utils",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "0.1.1",`
`4`	`4`	`"description": "A collection of React utility functions for Base UI.",`
`5`	`5`	`"repository": {`
`6`	`6`	`"type": "git",`