@base-ui/react 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,325 @@
 # Versions
 
+## v1.3.0
+
+_Mar 12, 2026_
+
+### General Changes
+
+- Warn when a component function is rendered directly (#4077) by @atomiks
+- Reset `openMethod` after close transition (#4128) by @atomiks
+- Fire <kbd>Space</kbd> activation on `keydown` in composite widgets (#4053) by @atomiks
+- Skip CSS-hidden items during keyboard navigation in composite widgets (#4195) by @atomiks
+- Optimize hot paths in `useHover` hooks and `safePolygon` (#4199) by @atomiks
+- Snap `--anchor-width` and `--anchor-height` to device pixel grid (#4082) by @flaviendelangle
+- Fix outside press dismissal when a component is portaled into a shadow DOM (#4230) by @dmitri-gb
+- Fix nested hoverable popups (#4206) by @dmitri-gb
+- Apply `data-base-ui-inert` to highest-level node (#3955) by @atomiks
+- Fix portable types (#4058) by @cgatian
+
+### Accordion
+
+- Add generic `Value` typing (#4138) by @atomiks
+
+### Autocomplete
+
+- Respect a `null` `filter` prop (#4117) by @atomiks
+- Add `InputGroup` part (#3745) by @atomiks
+
+### Avatar
+
+- Remove fallback transition logic and prevent premature image display (#4110) by @atomiks
+
+### Button
+
+- Avoid checking `disabled` twice in `onKeyDown` and `onKeyUp` (#4132) by @flaviendelangle
+
+### Checkbox
+
+- Add automatic `aria-labelledby` support (#4142) by @atomiks
+
+### Combobox
+
+- Avoid applying field attributes to input when it is inside popup (#4154) by @atomiks
+- Preserve inline input on `Enter` when nothing is highlighted (#4235) by @atomiks
+- Fix ARIA attributes during SSR (#4179) by @atomiks
+- Fix wrapping in virtualized grid arrow-key navigation (#4164) by @atomiks
+- Add `InputGroup` part (#3745) by @atomiks
+- Add support for a visually hidden close button and improve modal focus trapping (#4084) by @atomiks
+- Add `Label` part (#4167) by @atomiks
+
+### Context Menu
+
+- Ignore `mouseup` on non-Mac platforms (#3944) by @atomiks
+
+### Drawer
+
+- **Breaking change:** `Drawer` is no longer marked as preview<br />
+  `Drawer` is now stable and should be imported as `{ Drawer } from '@base-ui/react/drawer'` (#4293) by @atomiks
+- Fix React 17 support (#4178) by @atomiks
+- Include border in frontmost height variable (#4202) by @atomiks
+- Improve touch selection (#4104) by @atomiks
+- Preserve cross-axis scrolling during touch gestures (#4187) by @atomiks
+- Prevent swipe dismissal when component is controlled (#4133) by @flaviendelangle
+- Add `SwipeArea` part (#4102) by @atomiks
+- Make `data-base-ui-swipe-ignore` explicit for touch interactions (#4295) by @atomiks
+- Disable inheritance for swipe CSS variables (#4099) by @atomiks
+
+### Field
+
+- Fix field validation when `Form` errors or `invalid` prop are present at same time (#4112) by @mj12albert
+
+### Menu
+
+- Prevent `pointerleave` from stealing focus from dialogs (#4125) by @atomiks
+- Optimize `pointer-events` for submenu hover interactions (#4231) by @atomiks
+- Fix `closeDelay` not being applied to `Menu.SubmenuTrigger` (#4134) by @flaviendelangle
+- Implement content transitions with `Viewport` (#4060) by @michaldudak
+
+### Meter
+
+- Fix label announcements in NVDA (#4200) by @mj12albert
+
+### Navigation Menu
+
+- Fix support for nested inline menus (#4198) by @atomiks
+- Fix close propagation in nested hover menus (#4285) by @atomiks
+- Close parent menus when nested link with `closeOnClick` is clicked (#4276) by @CiscoFran10
+- Fix duplicate `aria-orientation` (#4309) by @atomiks
+- Fix delayed trigger switches in Safari (#4310) by @atomiks
+
+### Number Field
+
+- Fix increment/decrement press `reason` values in `onValueCommitted` (#4259) by @jijiseong
+
+### Popover
+
+- Trap focus when `<Popover.Close>` is rendered inside and `modal` is `true`, and add support for a visually hidden close button (#4084) by @atomiks
+- Fix nested hoverable popups (#3798) by @flaviendelangle
+
+### Preview Card
+
+- Fix nested hoverable popups (#3798) by @flaviendelangle
+
+### Progress
+
+- Fix label announcements in NVDA (#4200) by @mj12albert
+
+### Radio Group
+
+- Add automatic `aria-labelledby` support (#4142) by @atomiks
+
+### Scroll Area
+
+- Fix focus trapping with a non-scrollable viewport (#4220) by @atomiks
+- Fix thumb size after remounting (#4107) by @atomiks
+
+### Select
+
+- Fix hidden input `id` fallback (#4135) by @atomiks
+- Fix `Value` placeholder not rendering with `Record` items (#4137) by @vcode-sh
+- Fire `onClick` during drag-to-select (#3969) by @obeattie
+- Fix `items` type definition for groups (#3884) by @aarongarciah
+- Fix `alignItemWithTrigger` fallback with browser zoom (#4292) by @atomiks
+- Add `Label` part (#4167) by @atomiks
+
+### Slider
+
+- Add `Label` part (#4167) by @atomiks
+- Stop committing validation on `touchend` (#4091) by @jijiseong
+
+### Switch
+
+- Add automatic `aria-labelledby` support (#4142) by @atomiks
+
+### Tabs
+
+- Re-render indicator position on tab resize (#4165) by @atomiks
+
+### Toast
+
+- Enable closing all toasts (#3979) by @chuganzy
+- Prevent duplicate `onClose` calls for ending toasts (#4280) by @chuganzy
+
+### Tooltip
+
+- 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
+
+## v1.2.0
+
+_Feb 12, 2026_
+
+### General changes
+
+- Do not memoize `state` when not needed (#3812) by @flaviendelangle
+- Support lazy element in `render` prop (#3856) by @oliviertassinari
+- Replace Firefox deprecated mozInputSource check for virtual click detection (#3942) by @CiscoFran10
+- Use `WeakRef` for previously focused elements (#3916) by @atomiks
+- Fix page scroll jump when input has focus on unmount in Safari (#3925) by @atomiks
+- Fix flash at origin before positioning completes in Preact (#3975) by @OliverSpeir
+- Reduce style recalculation with classic scrollbars (#3854) by @mdm317
+- Fix event handling in useEnhancedClickHandler (#3981) by @sai6855
+
+### Autocomplete
+
+- Fix filter method's `useMemo` dependency (#3862) by @ZeeshanTamboli
+- Fix Autocomplete not using its internal filter method when `mode` is `list` (#3936) by @ZeeshanTamboli
+- Remove unnecessary double stringification of item in filtering logic (#3945) by @ZeeshanTamboli
+- Add `useFilteredItems` hook (#3732) by @guisehn
+- Fix popup closing on iOS VoiceOver (#3859) by @atomiks
+- Remove `aria-readonly` prop from `Clear` and `Popup` components when `readOnly` (#3907) by @markocupic024
+
+### Avatar
+
+- Add transition attributes (#3939) by @atomiks
+
+### Button
+
+- Capture component stack for `nativeButton` error message (#3861) by @atomiks
+
+### Checkbox
+
+- Cleanup disabled state tracking (#3913) by @atomiks
+- Preserve modifier key properties in the change event (#3935) by @mj12albert
+- Allow exit animations on `<Checkbox.Indicator>` when `keepMounted={false}` (#3939) by @atomiks
+
+### Combobox
+
+- Fix the type of the ref of the `Icon` part (#3796) by @flaviendelangle
+- Avoid clearing selected value if item is not present in items array (#3824) by @atomiks
+- Fix highlight change reason in `ChipRemove` (#3980) by @sai6855
+- Keep highlight on last deselect (#3923) by @atomiks
+- Fix inline filtering after selection in single mode (#3978) by @atomiks
+- Clear highlight on inline blur when inline (#3973) by @atomiks
+- Prevent opening popup on autofill change (#3924) by @atomiks
+- Distinguish `input-press` from `trigger-press` in `onOpenChange` reason (#4015) by @jijiseong
+- Fix async items while popup is open (#4034) by @atomiks
+- Prevent `Chip` from receiving focus when `disabled` (#4044) by @jijiseong
+- Add `useFilteredItems` hook (#3732) by @guisehn
+- Fix popup closing on iOS VoiceOver (#3859) by @atomiks
+- Remove `aria-readonly` prop from `Clear` and `Popup` components when `readOnly` (#3907) by @markocupic024
+- Fix `onClick` `Item` type (#3964) by @atomiks
+- Use reactive `domReferenceElement` subscriptions (#4017) by @atomiks
+- Add `autoComplete` prop for explicit browser autofill support (#4005) by @mattrothenberg
+- Fix inconsistent isItemEqualToValue argument order (#4056) by @atomiks
+
+### Context Menu
+
+- Fix `disabled` prop not working (#3806) by @arturbien
+- Fix explicit `collisionAvoidance` with `side: 'flip'` not working (#3877) by @obeattie
+
+### Drawer
+
+- Create new Drawer / Sheet component (#3680) by @atomiks
+
+### Field
+
+- Prevent re-renders when `Field.Control` is uncontrolled (#3820) by @atomiks
+- Fix autofocus in SSR environments (#3871) by @mj12albert
+- Fix max update depth loop when using `<React.Activity>` (#3931) by @atomiks
+- Add transition attributes (#3939) by @atomiks
+
+### Input
+
+- Fix autofocus in SSR environments (#3871) by @mj12albert
+- Update ref type to `HTMLElement` (#3866) by @mj12albert
+
+### Menu
+
+- Fix `onClick` `Item` type (#3964) by @atomiks
+- Fix submenu stuck glitch (#3783) by @atomiks
+- Fix race conditions (#3821) by @atomiks
+- Add `<Menu.LinkItem>` part (#3400) by @mj12albert
+
+### Navigation Menu
+
+- Fix forwarded ref types (#3775) by @CrawlerCode
+- Add `keepMounted` prop to `Content` part (#3794) by @atomiks
+
+### Number Field
+
+- Fix click handlers on ScrubArea (#3827) by @mj12albert
+- Remove `event.isTrusted` (#3920) by @atomiks
+- Stop repeat change at bounds (#3915) by @atomiks
+- Add `allowOutOfRange` prop (#3919) by @atomiks
+- Fix pen pointer handling (#3917) by @atomiks
+- Fix missing field state data attributes (#3909) by @mj12albert
+
+### Popover
+
+- Fix missing `aria-owns` element (#3959) by @atomiks
+- Use reactive `domReferenceElement` subscriptions (#4017) by @atomiks
+- Fix broken scale transition with detached triggers (#3810) by @michaldudak
+
+### Preview Card
+
+- Fix broken scale transition with detached triggers (#3810) by @michaldudak
+
+### Progress
+
+- De-duplicate `formatValue` function (#3805) by @sai6855
+
+### Radio Group
+
+- Preserve modifier key properties in the change event (#3935) by @mj12albert
+- Allow exit animations on `<Radio.Indicator>` when `keepMounted={false}` (#3939) by @atomiks
+- Rely on individual radio hidden inputs (#3826) by @atomiks
+- Add generic `Value` typing to `Radio` (#4033) by @atomiks
+
+### Scroll Area
+
+- Add `data-scrolling` state attribute to `Root` and `Viewport` parts (#3823) by @arturbien
+- Fix overflow edge rounding (#3888) by @atomiks
+
+### Select
+
+- Add `finalFocus` prop (#3785) by @markocupic024
+- Fix `alignItemWithTrigger` transform with CSS animations (#3831) by @atomiks
+- Fix `highlightItemOnHover` not being respected (#3868) by @sarthakmalik0810
+- Reset typeahead on external blur (#2618) by @antonfrolovsky
+- Fix scroll height loop (#3795) by @atomiks
+- Add `autoComplete` prop for explicit browser autofill support (#4005) by @mattrothenberg
+- Fix inconsistent isItemEqualToValue argument order (#4056) by @atomiks
+
+### Slider
+
+- Fix missing field state data attributes (#3909) by @mj12albert
+- Fix change event cloning (#3960) by @atomiks
+
+### Switch
+
+- Preserve modifier key properties in the change event (#3935) by @mj12albert
+
+### Tabs
+
+- Add transition attributes to `<Tabs.Panel>` part (#3880) by @atomiks
+
+### Toast
+
+- Make `useToastManager` and `createToastManager` generic functions (#3882) by @solastley
+- Prevent dismissed promise toast from reopening on updates (#4040) by @atomiks
+- Introduce a store (#3464) by @flaviendelangle
+
+### Toggle
+
+- Improve type safety and inference (#3173) by @michaelhazan
+
+### Toggle Group
+
+- Type value as string to match Toggle (#3770) by @markocupic024
+- Enable `Home`/`End` key navigation (#3971) by @jijiseong
+- Improve type safety and inference (#3173) by @michaelhazan
+
+### Tooltip
+
+- Prevent opening when focusing a disabled Trigger (#3902) by @michaldudak
+- 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
+
 ## v1.1.0
 
 _Jan 15, 2026_
@@ -764,7 +1084,7 @@ _Sep 3, 2025_
   ```diff
   -onOpenChange: (open, event, reason) => {
   +onOpenChange: (open, eventDetails) => {
-  -  if (reason === 'escape-key') {
+  - if (reason === 'escape-key') {
   +  if (eventDetails.reason === 'escape-key') {
        // ...
      }

package/accordion/header/AccordionHeader.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { BaseUIComponentProps } from "../../utils/types.js";
-import type { AccordionItem } from "../item/AccordionItem.js";
+import type { AccordionItemState } from "../item/AccordionItem.js";
 /**
  * A heading that labels the corresponding panel.
  * Renders an `<h3>` element.
@@ -8,7 +8,9 @@ import type { AccordionItem } from "../item/AccordionItem.js";
  * Documentation: [Base UI Accordion](https://base-ui.com/react/components/accordion)
  */
 export declare const AccordionHeader: React.ForwardRefExoticComponent<Omit<AccordionHeaderProps, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-export interface AccordionHeaderProps extends BaseUIComponentProps<'h3', AccordionItem.State> {}
+export interface AccordionHeaderState extends AccordionItemState {}
+export interface AccordionHeaderProps extends BaseUIComponentProps<'h3', AccordionHeaderState> {}
 export declare namespace AccordionHeader {
+  type State = AccordionHeaderState;
   type Props = AccordionHeaderProps;
 }

package/accordion/item/AccordionItem.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { BaseUIComponentProps } from "../../utils/types.js";
-import { useCollapsibleRoot } from "../../collapsible/root/useCollapsibleRoot.js";
-import type { AccordionRoot } from "../root/AccordionRoot.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";
 /**
@@ -11,11 +11,17 @@ import { REASONS } from "../../utils/reasons.js";
  * Documentation: [Base UI Accordion](https://base-ui.com/react/components/accordion)
  */
 export declare const AccordionItem: React.ForwardRefExoticComponent<Omit<AccordionItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export interface AccordionItemState extends AccordionRoot.State {
+export interface AccordionItemState extends AccordionRootState {
+  /**
+   * The item index.
+   */
   index: number;
+  /**
+   * Whether the component is open.
+   */
   open: boolean;
 }
-export interface AccordionItemProps extends BaseUIComponentProps<'div', AccordionItem.State>, Partial<Pick<useCollapsibleRoot.Parameters, 'disabled'>> {
+export interface AccordionItemProps extends BaseUIComponentProps<'div', AccordionItemState>, Partial<Pick<UseCollapsibleRootParameters, 'disabled'>> {
   /**
    * A unique value that identifies this accordion item.
    * If no value is provided, a unique ID will be generated automatically.
@@ -33,7 +39,7 @@ export interface AccordionItemProps extends BaseUIComponentProps<'div', Accordio
   /**
    * Event handler called when the panel is opened or closed.
    */
-  onOpenChange?: (open: boolean, eventDetails: AccordionItem.ChangeEventDetails) => void;
+  onOpenChange?: ((open: boolean, eventDetails: AccordionItem.ChangeEventDetails) => void) | undefined;
 }
 export type AccordionItemChangeEventReason = typeof REASONS.triggerPress | typeof REASONS.none;
 export type AccordionItemChangeEventDetails = BaseUIChangeEventDetails<AccordionItem.ChangeEventReason>;

package/accordion/item/AccordionItemContext.d.ts

@@ -1,10 +1,10 @@
 import * as React from 'react';
-import type { AccordionItem } from "./AccordionItem.js";
+import type { AccordionItemState } from "./AccordionItem.js";
 export interface AccordionItemContext {
   open: boolean;
-  state: AccordionItem.State;
+  state: AccordionItemState;
   setTriggerId: (id: string | undefined) => void;
-  triggerId?: string;
+  triggerId?: string | undefined;
 }
 export declare const AccordionItemContext: React.Context<AccordionItemContext | undefined>;
 export declare function useAccordionItemContext(): AccordionItemContext;

package/accordion/item/stateAttributesMapping.d.ts

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

package/accordion/panel/AccordionPanel.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { BaseUIComponentProps } from "../../utils/types.js";
 import type { AccordionRoot } from "../root/AccordionRoot.js";
-import type { AccordionItem } from "../item/AccordionItem.js";
+import type { AccordionItemState } from "../item/AccordionItem.js";
 import type { TransitionStatus } from "../../utils/useTransitionStatus.js";
 /**
  * A collapsible panel with the accordion item contents.
@@ -10,10 +10,13 @@ import type { TransitionStatus } from "../../utils/useTransitionStatus.js";
  * Documentation: [Base UI Accordion](https://base-ui.com/react/components/accordion)
  */
 export declare const AccordionPanel: React.ForwardRefExoticComponent<Omit<AccordionPanelProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export interface AccordionPanelState extends AccordionItem.State {
+export interface AccordionPanelState extends AccordionItemState {
+  /**
+   * The transition status of the component.
+   */
   transitionStatus: TransitionStatus;
 }
-export interface AccordionPanelProps extends BaseUIComponentProps<'div', AccordionPanel.State>, Pick<AccordionRoot.Props, 'hiddenUntilFound' | 'keepMounted'> {}
+export interface AccordionPanelProps extends BaseUIComponentProps<'div', AccordionPanelState>, Pick<AccordionRoot.Props, 'hiddenUntilFound' | 'keepMounted'> {}
 export declare namespace AccordionPanel {
   type State = AccordionPanelState;
   type Props = AccordionPanelProps;

package/accordion/root/AccordionRoot.d.ts

@@ -8,34 +8,42 @@ import { REASONS } from "../../utils/reasons.js";
  *
  * Documentation: [Base UI Accordion](https://base-ui.com/react/components/accordion)
  */
-export declare const AccordionRoot: React.ForwardRefExoticComponent<Omit<AccordionRootProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export type AccordionValue = (any | null)[];
-export interface AccordionRootState {
-  value: AccordionValue;
+export declare const AccordionRoot: {
+  <Value = any>(props: AccordionRoot.Props<Value>): React.JSX.Element;
+};
+export type AccordionValue<Value = any> = Value[];
+export interface AccordionRootState<Value = any> {
+  /**
+   * The current value.
+   */
+  value: AccordionValue<Value>;
   /**
    * Whether the component should ignore user interaction.
    */
   disabled: boolean;
+  /**
+   * The component orientation.
+   */
   orientation: Orientation;
 }
-export interface AccordionRootProps extends BaseUIComponentProps<'div', AccordionRoot.State> {
+export interface AccordionRootProps<Value = any> extends BaseUIComponentProps<'div', AccordionRoot.State<Value>> {
   /**
    * The controlled value of the item(s) that should be expanded.
    *
    * To render an uncontrolled accordion, use the `defaultValue` prop instead.
    */
-  value?: AccordionValue;
+  value?: AccordionValue<Value> | undefined;
   /**
    * The uncontrolled value of the item(s) that should be initially expanded.
    *
    * To render a controlled accordion, use the `value` prop instead.
    */
-  defaultValue?: AccordionValue;
+  defaultValue?: AccordionValue<Value> | undefined;
   /**
    * Whether the component should ignore user interaction.
    * @default false
    */
-  disabled?: boolean;
+  disabled?: boolean | undefined;
   /**
    * Allows the browser’s built-in page search to find and expand the panel contents.
    *
@@ -43,41 +51,42 @@ export interface AccordionRootProps extends BaseUIComponentProps<'div', Accordio
    * to hide the element without removing it from the DOM.
    * @default false
    */
-  hiddenUntilFound?: boolean;
+  hiddenUntilFound?: boolean | undefined;
   /**
    * Whether to keep the element in the DOM while the panel is closed.
    * This prop is ignored when `hiddenUntilFound` is used.
    * @default false
    */
-  keepMounted?: boolean;
+  keepMounted?: boolean | undefined;
   /**
    * Whether to loop keyboard focus back to the first item
    * when the end of the list is reached while using the arrow keys.
    * @default true
    */
-  loopFocus?: boolean;
+  loopFocus?: boolean | undefined;
   /**
    * Event handler called when an accordion item is expanded or collapsed.
    * Provides the new value as an argument.
    */
-  onValueChange?: (value: AccordionValue, eventDetails: AccordionRootChangeEventDetails) => void;
+  onValueChange?: ((value: AccordionValue<Value>, eventDetails: AccordionRootChangeEventDetails) => void) | undefined;
   /**
    * Whether multiple items can be open at the same time.
    * @default false
    */
-  multiple?: boolean;
+  multiple?: boolean | undefined;
   /**
    * The visual orientation of the accordion.
    * Controls whether roving focus uses left/right or up/down arrow keys.
    * @default 'vertical'
    */
-  orientation?: Orientation;
+  orientation?: Orientation | undefined;
 }
 export type AccordionRootChangeEventReason = typeof REASONS.triggerPress | typeof REASONS.none;
 export type AccordionRootChangeEventDetails = BaseUIChangeEventDetails<AccordionRoot.ChangeEventReason>;
 export declare namespace AccordionRoot {
-  type State = AccordionRootState;
-  type Props = AccordionRootProps;
+  type Value<TValue = any> = AccordionValue<TValue>;
+  type State<TValue = any> = AccordionRootState<TValue>;
+  type Props<TValue = any> = AccordionRootProps<TValue>;
   type ChangeEventReason = AccordionRootChangeEventReason;
   type ChangeEventDetails = AccordionRootChangeEventDetails;
 }

package/accordion/root/AccordionRootContext.d.ts

@@ -1,18 +1,18 @@
 import * as React from 'react';
 import type { Orientation } from "../../utils/types.js";
 import type { TextDirection } from "../../direction-provider/index.js";
-import type { AccordionRoot, AccordionValue } from "./AccordionRoot.js";
-export interface AccordionRootContext {
+import type { AccordionRoot } from "./AccordionRoot.js";
+export interface AccordionRootContext<Value = any> {
   accordionItemRefs: React.RefObject<(HTMLElement | null)[]>;
   direction: TextDirection;
   disabled: boolean;
-  handleValueChange: (newValue: number | string, nextOpen: boolean) => void;
+  handleValueChange: (newValue: AccordionRoot.Value<Value>[number], nextOpen: boolean) => void;
   hiddenUntilFound: boolean;
   keepMounted: boolean;
   loopFocus: boolean;
   orientation: Orientation;
-  state: AccordionRoot.State;
-  value: AccordionValue;
+  state: AccordionRoot.State<Value>;
+  value: AccordionRoot.Value<Value>;
 }
-export declare const AccordionRootContext: React.Context<AccordionRootContext | undefined>;
-export declare function useAccordionRootContext(): AccordionRootContext;
+export declare const AccordionRootContext: React.Context<AccordionRootContext<any> | undefined>;
+export declare function useAccordionRootContext<Value = any>(): AccordionRootContext<Value>;

package/accordion/trigger/AccordionTrigger.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { BaseUIComponentProps, NativeButtonProps } from "../../utils/types.js";
-import type { AccordionItem } from "../item/AccordionItem.js";
+import type { AccordionItemState } from "../item/AccordionItem.js";
 /**
  * A button that opens and closes the corresponding panel.
  * Renders a `<button>` element.
@@ -8,7 +8,9 @@ import type { AccordionItem } from "../item/AccordionItem.js";
  * Documentation: [Base UI Accordion](https://base-ui.com/react/components/accordion)
  */
 export declare const AccordionTrigger: React.ForwardRefExoticComponent<Omit<AccordionTriggerProps, "ref"> & React.RefAttributes<HTMLElement>>;
-export interface AccordionTriggerProps extends NativeButtonProps, BaseUIComponentProps<'button', AccordionItem.State> {}
+export interface AccordionTriggerState extends AccordionItemState {}
+export interface AccordionTriggerProps extends NativeButtonProps, BaseUIComponentProps<'button', AccordionTriggerState> {}
 export declare namespace AccordionTrigger {
+  type State = AccordionTriggerState;
   type Props = AccordionTriggerProps;
 }

package/accordion/trigger/AccordionTrigger.js

@@ -63,7 +63,8 @@ const AccordionTrigger = exports.AccordionTrigger = /*#__PURE__*/React.forwardRe
   } = (0, _useButton.useButton)({
     disabled,
     focusableWhenDisabled: true,
-    native: nativeButton
+    native: nativeButton,
+    composite: true
   });
   const {
     accordionItemRefs,
@@ -90,6 +91,7 @@ const AccordionTrigger = exports.AccordionTrigger = /*#__PURE__*/React.forwardRe
     'aria-controls': open ? panelId : undefined,
     'aria-expanded': open,
     id,
+    tabIndex: 0,
     onClick: handleTrigger,
     onKeyDown(event) {
       if (!SUPPORTED_KEYS.has(event.key)) {

package/alert-dialog/root/AlertDialogRoot.d.ts

@@ -9,11 +9,12 @@ import type { DialogRoot } from "../../dialog/root/DialogRoot.js";
  * Documentation: [Base UI Alert Dialog](https://base-ui.com/react/components/alert-dialog)
  */
 export declare function AlertDialogRoot<Payload>(props: AlertDialogRoot.Props<Payload>): import("react/jsx-runtime").JSX.Element;
+export interface AlertDialogRootState {}
 export interface AlertDialogRootProps<Payload = unknown> extends Omit<DialogRoot.Props<Payload>, 'modal' | 'disablePointerDismissal' | 'onOpenChange' | 'actionsRef' | 'handle'> {
   /**
    * Event handler called when the dialog is opened or closed.
    */
-  onOpenChange?: (open: boolean, eventDetails: AlertDialogRoot.ChangeEventDetails) => void;
+  onOpenChange?: ((open: boolean, eventDetails: AlertDialogRoot.ChangeEventDetails) => void) | undefined;
   /**
    * A ref to imperative actions.
    * - `unmount`: When specified, the dialog will not be unmounted when closed.
@@ -21,13 +22,13 @@ export interface AlertDialogRootProps<Payload = unknown> extends Omit<DialogRoot
    * Useful when the dialog's animation is controlled by an external library.
    * - `close`: Closes the dialog imperatively when called.
    */
-  actionsRef?: React.RefObject<AlertDialogRoot.Actions | null>;
+  actionsRef?: React.RefObject<AlertDialogRoot.Actions | null> | undefined;
   /**
    * A handle to associate the alert dialog with a trigger.
    * If specified, allows external triggers to control the alert dialog's open state.
    * Can be created with the AlertDialog.createHandle() method.
    */
-  handle?: DialogHandle<Payload>;
+  handle?: DialogHandle<Payload> | undefined;
 }
 export type AlertDialogRootActions = DialogRoot.Actions;
 export type AlertDialogRootChangeEventReason = DialogRoot.ChangeEventReason;
@@ -35,6 +36,7 @@ export type AlertDialogRootChangeEventDetails = BaseUIChangeEventDetails<AlertDi
   preventUnmountOnClose(): void;
 };
 export declare namespace AlertDialogRoot {
+  type State = AlertDialogRootState;
   type Props<Payload = unknown> = AlertDialogRootProps<Payload>;
   type Actions = AlertDialogRootActions;
   type ChangeEventReason = AlertDialogRootChangeEventReason;

package/alert-dialog/root/AlertDialogRoot.js

@@ -34,16 +34,18 @@ function AlertDialogRoot(props) {
   const nested = Boolean(parentDialogRootContext);
   const store = (0, _useRefWithInit.useRefWithInit)(() => {
     return handle?.store ?? new _DialogStore.DialogStore({
-      open: openProp ?? defaultOpen,
-      activeTriggerId: triggerIdProp !== undefined ? triggerIdProp : defaultTriggerIdProp,
+      open: defaultOpen,
+      openProp,
+      activeTriggerId: defaultTriggerIdProp,
+      triggerIdProp,
       modal: true,
       disablePointerDismissal: true,
       nested,
       role: 'alertdialog'
     });
   }).current;
-  store.useControlledProp('open', openProp, defaultOpen);
-  store.useControlledProp('activeTriggerId', triggerIdProp, defaultTriggerIdProp);
+  store.useControlledProp('openProp', openProp);
+  store.useControlledProp('triggerIdProp', triggerIdProp);
   store.useSyncedValue('nested', nested);
   store.useContextCallback('onOpenChange', onOpenChange);
   store.useContextCallback('onOpenChangeComplete', onOpenChangeComplete);