@base-ui/react 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -1,10 +1,144 @@
 # Versions
 
+## v1.5.0
+
+_May 19, 2026_
+
+### General changes
+
+- Use local document for virtual arrow (#4662) by @lyzno1
+- Fix macOS Safari and Firefox minimizing fullscreen when closing popups with <kbd>Esc</kbd> (#4695) by @arturbien
+- Drop unnecessary memoization (#4693) by @flaviendelangle
+- Do not use `Math.random()` in `useStableCallback()` (#4732) by @michaldudak
+- Fix return focus when reference disconnects (#4655) by @atomiks
+- Improve mount performance with interaction splitting (#4661) by @atomiks
+- Don't steal initial focus if focus already moved inside a popup (#4775) by @stefee
+
+### Alert Dialog
+
+- Fix handle defaults (#4834) by @atomiks
+
+### Autocomplete
+
+- Fix native `FormData` for popup inputs (#4725) by @lunaxislu
+
+### Checkbox
+
+- Submit the associated form when pressing <kbd>Enter</kbd> (#4713) by @michaldudak
+
+### Combobox
+
+- Expose clear visibility state (#4664) by @atomiks
+- Fix popup input form submit (#4687) by @atomiks
+- Preserve `closeQuery` when closing multiple input-inside-popup combobox (#4715) by @mj12albert
+- Fix RTL component behavior (#4840) by @atomiks
+- Ignore hidden-input changes while readonly or disabled (#4810) by @lunaxislu
+
+### Dialog
+
+- Consider the controlled `open` prop for open state detection (#4712) by @michaldudak
+
+### Drawer
+
+- Forward `style` prop in `<Drawer.Viewport>` (#4841) by @atomiks
+
+### Field
+
+- Avoid `flushSync` during validation (#4685) by @atomiks
+
+### Form
+
+- Avoid `flushSync` during validation (#4685) by @atomiks
+
+### Menu
+
+- Fix submenu pointer-events scope for `keepMounted` portals (#4723) by @twillhorn
+- Support `<Menu.GroupLabel>` in `<Menu.RadioGroup>` (#4826) by @nami8824
+- Consider the controlled `open` prop for open state detection (#4712) by @michaldudak
+
+### Navigation Menu
+
+- Fix RTL component behavior (#4840) by @atomiks
+- Fix `keepMounted` content sizing (#4817) by @atomiks
+
+### Number Field
+
+- Allow Persian digits in keyboard input (#4719) by @lunaxislu
+- Sync pasted input during step interactions (#4824) by @lunaxislu
+
+### OTP Field
+
+- **Breaking change:** Rename `sanitizeValue()` to `normalizeValue()` and allow composing with validation (#4717) by @atomiks
+- Avoid `flushSync` during validation (#4685) by @atomiks
+- Support <kbd>Ctrl</kbd> and <kbd>Cmd</kbd> shortcuts (#4606) by @atomiks
+- Fire `onValueComplete()` for full paste (#4690) by @atomiks
+- Fix vertical arrow slot navigation (#4844) by @atomiks
+- Ignore hidden input changes while readonly or disabled (#4806) by @lunaxislu
+- Prevent locked hidden autofill validation (#4827) by @lunaxislu
+- Fix RTL arrow navigation (#4847) by @atomiks
+
+### Popover
+
+- Fix RTL component behavior (#4840) by @atomiks
+- Preserve active trigger on close press (#4741) by @mj12albert
+- Consider the controlled `open` prop for open state detection (#4712) by @michaldudak
+
+### Preview Card
+
+- Consider the controlled `open` prop for open state detection (#4712) by @michaldudak
+- Integrate inline positioning (#2074) by @atomiks
+
+### Scroll Area
+
+- Fix RTL component behavior (#4840) by @atomiks
+
+### Select
+
+- Clear stale item text ref (#4683) by @atomiks
+- Add `data-popup-side` to trigger (#4671) by @mj12albert
+- Allow mouse selection without highlight (#4699) by @atomiks
+- Ignore hidden-input changes while readonly or disabled (#4810) by @lunaxislu
+- Fix nested Select requiring extra outside clicks to dismiss parent (#4820) by @mattrothenberg
+
+### Tabs
+
+- Fire `onValueChange()` for automatic tab selection (#4704) by @michaldudak
+
+### Toast
+
+- Re-use `getElementTransform()` and remove local implementation (#4749) by @sai6855
+- Fix stuck drag state on release (#4742) by @aeterno-caspian
+- Remove memoized selector (#4751) by @atomiks
+
+### Tooltip
+
+- Consider the controlled `open` prop for open state detection (#4712) by @michaldudak
+- Fix flickering when nesting tooltip inside another tooltip's trigger (#4501) by @michaldudak
+
+All contributors of this release in alphabetical order: @aeterno-caspian, @arturbien, @atomiks, @flaviendelangle, @Janpot, @lunaxislu, @lyzno1, @mattrothenberg, @michaldudak, @mj12albert, @nami8824, @sai6855, @stefee, @twillhorn
+
+## v1.4.1
+
+_Apr 20, 2026_
+
+### General changes
+
+- Clear highlight on pointer leave when item is clipped by scroll container (#4604) by @atomiks
+- Fix `display: contents` tabbability (#4642) by @atomiks
+- Fix multi-argument event handler forwarding in `mergeProps` (#4598) by @atomiks
+- Mark `date-fns` peer dependencies as optional (#4639) by @LukasTy
+
+### Navigation Menu
+
+- Fix stale popup size on rapid trigger hover (#4646) by @atomiks
+
+All contributors of this release in alphabetical order: @atomiks, @LukasTy
+
 ## v1.4.0
 
 _Apr 13, 2026_
 
-### General Changes
+### General changes
 
 - Improve `render` prop warning accuracy (#4324, #4363) by @atomiks
 - Fix `preventBaseUIHandler` runtime wrapping (#4330) by @atomiks
@@ -129,13 +263,13 @@ _Apr 13, 2026_
 
 - Fix incorrect keyboard nav on cross axis (#4488) by @mj12albert
 
-All contributors of this release in alphabetical order : @arturbien, @atomiks, @CiscoFran10, @devxoul, @flaviendelangle, @kyrregjerstad, @LukasTy, @lunaxislu, @mattrothenberg, @mdm317, @michaldudak, @mj12albert, @Profesor08, @ryanrhee, @sai6855, @tsbehlman
+All contributors of this release in alphabetical order: @arturbien, @atomiks, @CiscoFran10, @devxoul, @flaviendelangle, @kyrregjerstad, @LukasTy, @lunaxislu, @mattrothenberg, @mdm317, @michaldudak, @mj12albert, @Profesor08, @ryanrhee, @sai6855, @tsbehlman
 
 ## v1.3.0
 
 _Mar 12, 2026_
 
-### General Changes
+### General changes
 
 - Warn when a component function is rendered directly (#4077) by @atomiks
 - Reset `openMethod` after close transition (#4128) by @atomiks
@@ -276,7 +410,7 @@ _Mar 12, 2026_
 
 - Add `closeOnClick` prop (#4140) by @atomiks
 
-All contributors of this release in alphabetical order : @aarongarciah, @atomiks, @cgatian, @chuganzy, @CiscoFran10, @dmitri-gb, @flaviendelangle, @jijiseong, @michaldudak, @mj12albert, @obeattie, @vcode-sh
+All contributors of this release in alphabetical order: @aarongarciah, @atomiks, @cgatian, @chuganzy, @CiscoFran10, @dmitri-gb, @flaviendelangle, @jijiseong, @michaldudak, @mj12albert, @obeattie, @vcode-sh
 
 ## v1.2.0
 
@@ -449,7 +583,7 @@ _Feb 12, 2026_
 - Fix broken scale transition with detached triggers (#3810) by @michaldudak
 - Fix disabled prop on Triggers (#4049) by @michaldudak
 
-All contributors of this release in alphabetical order : @antonfrolovsky, @arturbien, @atomiks, @CiscoFran10, @CrawlerCode, @flaviendelangle, @guisehn, @jijiseong, @LukasTy, @markocupic024, @mattrothenberg, @mdm317, @michaelhazan, @michaldudak, @mj12albert, @obeattie, @OliverSpeir, @oliviertassinari, @sai6855, @sarthakmalik0810, @solastley, @ZeeshanTamboli
+All contributors of this release in alphabetical order: @antonfrolovsky, @arturbien, @atomiks, @CiscoFran10, @CrawlerCode, @flaviendelangle, @guisehn, @jijiseong, @LukasTy, @markocupic024, @mattrothenberg, @mdm317, @michaelhazan, @michaldudak, @mj12albert, @obeattie, @OliverSpeir, @oliviertassinari, @sai6855, @sarthakmalik0810, @solastley, @ZeeshanTamboli
 
 ## v1.1.0
 
@@ -2082,7 +2216,7 @@ _Mar 20, 2025_
 - Mention Progress.Value in API reference (#1429) @aarongarciah
 - Update release instructions (#1417) @michaldudak
 
-### Core
+### Internal
 
 - [code-infra] Polish VS Code DX (#1238) @oliviertassinari
 - [code-infra] Fix build:types not copying on some setups (#1482) @Janpot

package/README.md

@@ -1,4 +1,4 @@
-<!-- markdownlint-disable MD041 -->
+<!-- lint disable mui-first-block-heading -->
 
 <a href="https://base-ui.com" rel="noopener" target="_blank"><img width="150" height="133" src="https://base-ui.com/static/logo.svg" alt="Base UI logo"></a>
 

package/accordion/header/AccordionHeader.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { BaseUIComponentProps } from "../../utils/types.js";
+import { BaseUIComponentProps } from "../../internals/types.js";
 import type { AccordionItemState } from "../item/AccordionItem.js";
 /**
  * A heading that labels the corresponding panel.

package/accordion/header/AccordionHeader.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.AccordionHeader = void 0;
 var React = _interopRequireWildcard(require("react"));
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 var _AccordionItemContext = require("../item/AccordionItemContext");
 var _stateAttributesMapping = require("../item/stateAttributesMapping");
 /**

package/accordion/item/AccordionItem.d.ts

@@ -1,9 +1,9 @@
 import * as React from 'react';
-import { BaseUIComponentProps } from "../../utils/types.js";
+import { BaseUIComponentProps } from "../../internals/types.js";
 import { type UseCollapsibleRootParameters } from "../../collapsible/root/useCollapsibleRoot.js";
 import type { AccordionRootState } from "../root/AccordionRoot.js";
-import { type BaseUIChangeEventDetails } from "../../utils/createBaseUIEventDetails.js";
-import { REASONS } from "../../utils/reasons.js";
+import { type BaseUIChangeEventDetails } from "../../internals/createBaseUIEventDetails.js";
+import { REASONS } from "../../internals/reasons.js";
 /**
  * Groups an accordion header with the corresponding panel.
  * Renders a `<div>` element.
@@ -12,6 +12,10 @@ import { REASONS } from "../../utils/reasons.js";
  */
 export declare const AccordionItem: React.ForwardRefExoticComponent<Omit<AccordionItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export interface AccordionItemState extends AccordionRootState {
+  /**
+   * Whether the accordion item's panel is currently hidden.
+   */
+  hidden: boolean;
   /**
    * The item index.
    */

package/accordion/item/AccordionItem.js

@@ -9,14 +9,14 @@ exports.AccordionItem = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
 var _useMergedRefs = require("@base-ui/utils/useMergedRefs");
-var _useBaseUiId = require("../../utils/useBaseUiId");
+var _useBaseUiId = require("../../internals/useBaseUiId");
 var _useCollapsibleRoot = require("../../collapsible/root/useCollapsibleRoot");
 var _CollapsibleRootContext = require("../../collapsible/root/CollapsibleRootContext");
-var _useCompositeListItem = require("../../composite/list/useCompositeListItem");
+var _useCompositeListItem = require("../../internals/composite/list/useCompositeListItem");
 var _AccordionRootContext = require("../root/AccordionRootContext");
 var _AccordionItemContext = require("./AccordionItemContext");
 var _stateAttributesMapping = require("./stateAttributesMapping");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Groups an accordion header with the corresponding panel.
@@ -74,9 +74,8 @@ const AccordionItem = exports.AccordionItem = /*#__PURE__*/React.forwardRef(func
   const collapsibleState = React.useMemo(() => ({
     open: collapsible.open,
     disabled: collapsible.disabled,
-    hidden: !collapsible.mounted,
     transitionStatus: collapsible.transitionStatus
-  }), [collapsible.open, collapsible.disabled, collapsible.mounted, collapsible.transitionStatus]);
+  }), [collapsible.open, collapsible.disabled, collapsible.transitionStatus]);
   const collapsibleContext = React.useMemo(() => ({
     ...collapsible,
     onOpenChange,
@@ -84,11 +83,13 @@ const AccordionItem = exports.AccordionItem = /*#__PURE__*/React.forwardRef(func
   }), [collapsible, collapsibleState, onOpenChange]);
   const state = React.useMemo(() => ({
     ...rootState,
+    hidden: !isOpen && !collapsible.mounted,
     index,
     disabled,
     open: isOpen
-  }), [disabled, index, isOpen, rootState]);
-  const [triggerId, setTriggerId] = React.useState((0, _useBaseUiId.useBaseUiId)());
+  }), [collapsible.mounted, disabled, index, isOpen, rootState]);
+  const defaultTriggerId = (0, _useBaseUiId.useBaseUiId)();
+  const [triggerId, setTriggerId] = React.useState(defaultTriggerId);
   const accordionItemContext = React.useMemo(() => ({
     open: isOpen,
     state,

package/accordion/item/stateAttributesMapping.d.ts

@@ -1,3 +1,3 @@
-import type { StateAttributesMapping } from "../../utils/getStateAttributesProps.js";
+import type { StateAttributesMapping } from "../../internals/getStateAttributesProps.js";
 import type { AccordionItemState } from "./AccordionItem.js";
 export declare const accordionStateAttributesMapping: StateAttributesMapping<AccordionItemState>;

package/accordion/item/stateAttributesMapping.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.accordionStateAttributesMapping = void 0;
 var _collapsibleOpenStateMapping = require("../../utils/collapsibleOpenStateMapping");
-var _stateAttributesMapping = require("../../utils/stateAttributesMapping");
+var _stateAttributesMapping = require("../../internals/stateAttributesMapping");
 var _AccordionItemDataAttributes = require("./AccordionItemDataAttributes");
 const accordionStateAttributesMapping = exports.accordionStateAttributesMapping = {
   ..._collapsibleOpenStateMapping.collapsibleOpenStateMapping,

package/accordion/panel/AccordionPanel.d.ts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import { BaseUIComponentProps } from "../../utils/types.js";
+import { BaseUIComponentProps } from "../../internals/types.js";
 import type { AccordionRoot } from "../root/AccordionRoot.js";
 import type { AccordionItemState } from "../item/AccordionItem.js";
-import type { TransitionStatus } from "../../utils/useTransitionStatus.js";
+import type { TransitionStatus } from "../../internals/useTransitionStatus.js";
 /**
  * A collapsible panel with the accordion item contents.
  * Renders a `<div>` element.

package/accordion/panel/AccordionPanel.js

@@ -9,14 +9,14 @@ exports.AccordionPanel = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _warn = require("@base-ui/utils/warn");
+var _resolveStyle = require("../../utils/resolveStyle");
 var _CollapsibleRootContext = require("../../collapsible/root/CollapsibleRootContext");
 var _useCollapsiblePanel = require("../../collapsible/panel/useCollapsiblePanel");
 var _AccordionRootContext = require("../root/AccordionRootContext");
 var _AccordionItemContext = require("../item/AccordionItemContext");
 var _stateAttributesMapping = require("../item/stateAttributesMapping");
 var _AccordionPanelCssVars = require("./AccordionPanelCssVars");
-var _useOpenChangeComplete = require("../../utils/useOpenChangeComplete");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 /**
  * A collapsible panel with the accordion item contents.
  * Renders a `<div>` element.
@@ -38,24 +38,12 @@ const AccordionPanel = exports.AccordionPanel = /*#__PURE__*/React.forwardRef(fu
     keepMounted: contextKeepMounted
   } = (0, _AccordionRootContext.useAccordionRootContext)();
   const {
-    abortControllerRef,
-    animationTypeRef,
-    height,
     mounted,
     onOpenChange,
     open,
     panelId,
-    panelRef,
-    runOnceAnimationsFinish,
-    setDimensions,
-    setHiddenUntilFound,
-    setKeepMounted,
     setMounted,
     setOpen,
-    setVisible,
-    transitionDimensionRef,
-    visible,
-    width,
     setPanelIdState,
     transitionStatus
   } = (0, _CollapsibleRootContext.useCollapsibleRootContext)();
@@ -65,7 +53,7 @@ const AccordionPanel = exports.AccordionPanel = /*#__PURE__*/React.forwardRef(fu
     // eslint-disable-next-line react-hooks/rules-of-hooks
     (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
       if (keepMountedProp === false && hiddenUntilFound) {
-        (0, _warn.warn)('The `keepMounted={false}` prop on a Accordion.Panel will be ignored when using `contextHiddenUntilFound` on the Panel or the Root since it requires the panel to remain mounted when closed.');
+        (0, _warn.warn)('The `keepMounted={false}` prop on an `Accordion.Panel` is ignored when `hiddenUntilFound` is enabled on the panel or root, since the panel must remain mounted while closed.');
       }
     }, [hiddenUntilFound, keepMountedProp]);
   }
@@ -78,59 +66,41 @@ const AccordionPanel = exports.AccordionPanel = /*#__PURE__*/React.forwardRef(fu
     }
     return undefined;
   }, [idProp, setPanelIdState]);
-  (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
-    setHiddenUntilFound(hiddenUntilFound);
-  }, [setHiddenUntilFound, hiddenUntilFound]);
-  (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
-    setKeepMounted(keepMounted);
-  }, [setKeepMounted, keepMounted]);
-  (0, _useOpenChangeComplete.useOpenChangeComplete)({
-    open: open && transitionStatus === 'idle',
-    ref: panelRef,
-    onComplete() {
-      if (!open) {
-        return;
-      }
-      setDimensions({
-        width: undefined,
-        height: undefined
-      });
-    }
-  });
   const {
-    props
+    height,
+    props,
+    ref,
+    shouldPreventOpenAnimation,
+    shouldRender,
+    transitionStatus: panelTransitionStatus,
+    width
   } = (0, _useCollapsiblePanel.useCollapsiblePanel)({
-    abortControllerRef,
-    animationTypeRef,
     externalRef: forwardedRef,
-    height,
     hiddenUntilFound,
     id: idProp ?? panelId,
     keepMounted,
     mounted,
     onOpenChange,
     open,
-    panelRef,
-    runOnceAnimationsFinish,
-    setDimensions,
     setMounted,
     setOpen,
-    setVisible,
-    transitionDimensionRef,
-    visible,
-    width
+    transitionStatus
   });
   const {
     state,
     triggerId
   } = (0, _AccordionItemContext.useAccordionItemContext)();
-  const panelState = React.useMemo(() => ({
+  const panelState = {
     ...state,
-    transitionStatus
-  }), [state, transitionStatus]);
-  const element = (0, _useRenderElement.useRenderElement)('div', componentProps, {
+    transitionStatus: panelTransitionStatus
+  };
+  const resolvedStyle = (0, _resolveStyle.resolveStyle)(style, panelState);
+  const element = (0, _useRenderElement.useRenderElement)('div', {
+    ...componentProps,
+    style: undefined
+  }, {
     state: panelState,
-    ref: [forwardedRef, panelRef],
+    ref,
     props: [props, {
       'aria-labelledby': triggerId,
       role: 'region',
@@ -138,10 +108,18 @@ const AccordionPanel = exports.AccordionPanel = /*#__PURE__*/React.forwardRef(fu
         [_AccordionPanelCssVars.AccordionPanelCssVars.accordionPanelHeight]: height === undefined ? 'auto' : `${height}px`,
         [_AccordionPanelCssVars.AccordionPanelCssVars.accordionPanelWidth]: width === undefined ? 'auto' : `${width}px`
       }
-    }, elementProps],
+    }, elementProps, resolvedStyle ? {
+      style: resolvedStyle
+    } : undefined,
+    // Resolve the public `style` prop so temporary `animationName: 'none'`
+    // can still win after user's inline styles have been merged.
+    shouldPreventOpenAnimation ? {
+      style: {
+        animationName: 'none'
+      }
+    } : undefined],
     stateAttributesMapping: _stateAttributesMapping.accordionStateAttributesMapping
   });
-  const shouldRender = keepMounted || hiddenUntilFound || mounted;
   if (!shouldRender) {
     return null;
   }

package/accordion/panel/AccordionPanelDataAttributes.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.AccordionPanelDataAttributes = void 0;
-var _stateAttributesMapping = require("../../utils/stateAttributesMapping");
+var _stateAttributesMapping = require("../../internals/stateAttributesMapping");
 let AccordionPanelDataAttributes = exports.AccordionPanelDataAttributes = function (AccordionPanelDataAttributes) {
   /**
    * Indicates the index of the accordion item.

package/accordion/root/AccordionRoot.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import { BaseUIComponentProps, Orientation } from "../../utils/types.js";
-import { type BaseUIChangeEventDetails } from "../../utils/createBaseUIEventDetails.js";
-import { REASONS } from "../../utils/reasons.js";
+import { BaseUIComponentProps, Orientation } from "../../internals/types.js";
+import { type BaseUIChangeEventDetails } from "../../internals/createBaseUIEventDetails.js";
+import { REASONS } from "../../internals/reasons.js";
 /**
  * Groups all parts of the accordion.
  * Renders a `<div>` element.

package/accordion/root/AccordionRoot.js

@@ -11,12 +11,12 @@ var _useControlled = require("@base-ui/utils/useControlled");
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _warn = require("@base-ui/utils/warn");
-var _CompositeList = require("../../composite/list/CompositeList");
-var _DirectionContext = require("../../direction-provider/DirectionContext");
+var _CompositeList = require("../../internals/composite/list/CompositeList");
+var _DirectionContext = require("../../internals/direction-context/DirectionContext");
 var _AccordionRootContext = require("./AccordionRootContext");
-var _useRenderElement = require("../../utils/useRenderElement");
-var _createBaseUIEventDetails = require("../../utils/createBaseUIEventDetails");
-var _reasons = require("../../utils/reasons");
+var _useRenderElement = require("../../internals/useRenderElement");
+var _createBaseUIEventDetails = require("../../internals/createBaseUIEventDetails");
+var _reasons = require("../../internals/reasons");
 var _jsxRuntime = require("react/jsx-runtime");
 const rootStateAttributesMapping = {
   value: () => null
@@ -36,7 +36,7 @@ const AccordionRoot = exports.AccordionRoot = /*#__PURE__*/React.forwardRef(func
     hiddenUntilFound: hiddenUntilFoundProp,
     keepMounted: keepMountedProp,
     loopFocus = true,
-    onValueChange: onValueChangeProp,
+    onValueChange,
     multiple = false,
     orientation = 'vertical',
     value: valueProp,
@@ -49,7 +49,7 @@ const AccordionRoot = exports.AccordionRoot = /*#__PURE__*/React.forwardRef(func
     // eslint-disable-next-line react-hooks/rules-of-hooks
     (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
       if (hiddenUntilFoundProp && keepMountedProp === false) {
-        (0, _warn.warn)('The `keepMounted={false}` prop on a Accordion.Root will be ignored when using `hiddenUntilFound` since it requires Panels to remain mounted when closed.');
+        (0, _warn.warn)('The `keepMounted={false}` prop on `Accordion.Root` is ignored when `hiddenUntilFound` is enabled, since panels must remain mounted while closed.');
       }
     }, [hiddenUntilFoundProp, keepMountedProp]);
   }
@@ -62,7 +62,6 @@ const AccordionRoot = exports.AccordionRoot = /*#__PURE__*/React.forwardRef(func
     }
     return undefined;
   }, [valueProp, defaultValueProp]);
-  const onValueChange = (0, _useStableCallback.useStableCallback)(onValueChangeProp);
   const accordionItemRefs = React.useRef([]);
   const [value, setValue] = (0, _useControlled.useControlled)({
     controlled: valueProp,
@@ -74,7 +73,7 @@ const AccordionRoot = exports.AccordionRoot = /*#__PURE__*/React.forwardRef(func
     const details = (0, _createBaseUIEventDetails.createChangeEventDetails)(_reasons.REASONS.none);
     if (!multiple) {
       const nextValue = value[0] === newValue ? [] : [newValue];
-      onValueChange(nextValue, details);
+      onValueChange?.(nextValue, details);
       if (details.isCanceled) {
         return;
       }
@@ -82,14 +81,14 @@ const AccordionRoot = exports.AccordionRoot = /*#__PURE__*/React.forwardRef(func
     } else if (nextOpen) {
       const nextOpenValues = value.slice();
       nextOpenValues.push(newValue);
-      onValueChange(nextOpenValues, details);
+      onValueChange?.(nextOpenValues, details);
       if (details.isCanceled) {
         return;
       }
       setValue(nextOpenValues);
     } else {
       const nextOpenValues = value.filter(v => v !== newValue);
-      onValueChange(nextOpenValues, details);
+      onValueChange?.(nextOpenValues, details);
       if (details.isCanceled) {
         return;
       }

package/accordion/root/AccordionRootContext.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { Orientation } from "../../utils/types.js";
+import type { Orientation } from "../../internals/types.js";
 import type { TextDirection } from "../../direction-provider/index.js";
 import type { AccordionRoot } from "./AccordionRoot.js";
 export interface AccordionRootContext<Value = any> {

package/accordion/trigger/AccordionTrigger.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { BaseUIComponentProps, NativeButtonProps } from "../../utils/types.js";
+import { BaseUIComponentProps, NativeButtonProps } from "../../internals/types.js";
 import type { AccordionItemState } from "../item/AccordionItem.js";
 /**
  * A button that opens and closes the corresponding panel.

package/accordion/trigger/AccordionTrigger.js

@@ -10,13 +10,12 @@ var React = _interopRequireWildcard(require("react"));
 var _isElementDisabled = require("@base-ui/utils/isElementDisabled");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _collapsibleOpenStateMapping = require("../../utils/collapsibleOpenStateMapping");
-var _useButton = require("../../use-button");
+var _useButton = require("../../internals/use-button");
 var _CollapsibleRootContext = require("../../collapsible/root/CollapsibleRootContext");
-var _composite = require("../../composite/composite");
+var _composite = require("../../internals/composite/composite");
 var _AccordionRootContext = require("../root/AccordionRootContext");
 var _AccordionItemContext = require("../item/AccordionItemContext");
-var _useRenderElement = require("../../utils/useRenderElement");
-const SUPPORTED_KEYS = new Set([_composite.ARROW_DOWN, _composite.ARROW_UP, _composite.ARROW_RIGHT, _composite.ARROW_LEFT, _composite.HOME, _composite.END]);
+var _useRenderElement = require("../../internals/useRenderElement");
 function getActiveTriggers(accordionItemRefs) {
   const {
     current: accordionItemElements
@@ -88,14 +87,14 @@ const AccordionTrigger = exports.AccordionTrigger = /*#__PURE__*/React.forwardRe
       setTriggerId(undefined);
     };
   }, [idProp, setTriggerId]);
-  const props = React.useMemo(() => ({
+  const props = {
     'aria-controls': open ? panelId : undefined,
     'aria-expanded': open,
     id,
     tabIndex: 0,
     onClick: handleTrigger,
     onKeyDown(event) {
-      if (!SUPPORTED_KEYS.has(event.key)) {
+      if (!_composite.COMPOSITE_KEYS.has(event.key)) {
         return;
       }
       (0, _composite.stopEvent)(event);
@@ -160,7 +159,7 @@ const AccordionTrigger = exports.AccordionTrigger = /*#__PURE__*/React.forwardRe
         triggers[nextIndex].focus();
       }
     }
-  }), [accordionItemRefs, handleTrigger, id, isHorizontal, isRtl, loopFocus, open, panelId]);
+  };
   const element = (0, _useRenderElement.useRenderElement)('button', componentProps, {
     state,
     ref: [forwardedRef, buttonRef],

package/alert-dialog/handle.d.ts

@@ -1,2 +1,15 @@
 import { DialogHandle } from "../dialog/store/DialogHandle.js";
-export declare function createAlertDialogHandle<Payload>(): DialogHandle<Payload>;
+import { DialogStore } from "../dialog/store/DialogStore.js";
+export declare const alertDialogState: {
+  readonly modal: true;
+  readonly disablePointerDismissal: true;
+  readonly role: "alertdialog";
+};
+/**
+ * A handle to control an Alert Dialog imperatively and to associate detached triggers with it.
+ */
+export declare class AlertDialogHandle<Payload> extends DialogHandle<Payload> {
+  private readonly __alertDialogBrand;
+  constructor(store?: DialogStore<Payload>);
+}
+export declare function createAlertDialogHandle<Payload>(): AlertDialogHandle<Payload>;