@base-ui/react 1.2.0 → 1.3.0

package/meter/label/MeterLabel.js

@@ -7,10 +7,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.MeterLabel = void 0;
 var React = _interopRequireWildcard(require("react"));
-var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
-var _useBaseUiId = require("../../utils/useBaseUiId");
 var _MeterRootContext = require("../root/MeterRootContext");
 var _useRenderElement = require("../../utils/useRenderElement");
+var _useRegisteredLabelId = require("../../utils/useRegisteredLabelId");
 /**
  * An accessible label for the meter.
  * Renders a `<span>` element.
@@ -24,18 +23,15 @@ const MeterLabel = exports.MeterLabel = /*#__PURE__*/React.forwardRef(function M
     id: idProp,
     ...elementProps
   } = componentProps;
-  const id = (0, _useBaseUiId.useBaseUiId)(idProp);
   const {
     setLabelId
   } = (0, _MeterRootContext.useMeterRootContext)();
-  (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
-    setLabelId(id);
-    return () => setLabelId(undefined);
-  }, [id, setLabelId]);
+  const id = (0, _useRegisteredLabelId.useRegisteredLabelId)(idProp, setLabelId);
   return (0, _useRenderElement.useRenderElement)('span', componentProps, {
     ref: forwardedRef,
     props: [{
-      id
+      id,
+      role: 'presentation'
     }, elementProps]
   });
 });

package/meter/root/MeterRoot.d.ts

@@ -8,7 +8,7 @@ import { BaseUIComponentProps } from "../../utils/types.js";
  */
 export declare const MeterRoot: React.ForwardRefExoticComponent<Omit<MeterRootProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export interface MeterRootState {}
-export interface MeterRootProps extends BaseUIComponentProps<'div', MeterRoot.State> {
+export interface MeterRootProps extends BaseUIComponentProps<'div', MeterRootState> {
   /**
    * A string value that provides a user-friendly name for `aria-valuenow`, the current value of the meter.
    */

package/meter/root/MeterRoot.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.MeterRoot = void 0;
 var React = _interopRequireWildcard(require("react"));
+var _visuallyHidden = require("@base-ui/utils/visuallyHidden");
 var _MeterRootContext = require("./MeterRootContext");
 var _formatNumber = require("../../utils/formatNumber");
 var _useRenderElement = require("../../utils/useRenderElement");
@@ -27,6 +28,7 @@ const MeterRoot = exports.MeterRoot = /*#__PURE__*/React.forwardRef(function Met
     value: valueProp,
     render,
     className,
+    children,
     ...elementProps
   } = componentProps;
   const [labelId, setLabelId] = React.useState();
@@ -43,7 +45,14 @@ const MeterRoot = exports.MeterRoot = /*#__PURE__*/React.forwardRef(function Met
     'aria-valuemin': min,
     'aria-valuenow': valueProp,
     'aria-valuetext': ariaValuetext,
-    role: 'meter'
+    role: 'meter',
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
+      children: [children, /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+        role: "presentation",
+        style: _visuallyHidden.visuallyHidden,
+        children: "x"
+      })]
+    })
   };
   const contextValue = React.useMemo(() => ({
     formattedValue,

package/meter/track/MeterTrack.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { MeterRoot } from "../root/MeterRoot.js";
+import type { MeterRootState } from "../root/MeterRoot.js";
 import { BaseUIComponentProps } from "../../utils/types.js";
 /**
  * Contains the meter indicator and represents the entire range of the meter.
@@ -8,7 +8,9 @@ import { BaseUIComponentProps } from "../../utils/types.js";
  * Documentation: [Base UI Meter](https://base-ui.com/react/components/meter)
  */
 export declare const MeterTrack: React.ForwardRefExoticComponent<Omit<MeterTrackProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export interface MeterTrackProps extends BaseUIComponentProps<'div', MeterRoot.State> {}
+export interface MeterTrackState extends MeterRootState {}
+export interface MeterTrackProps extends BaseUIComponentProps<'div', MeterTrackState> {}
 export declare namespace MeterTrack {
+  type State = MeterTrackState;
   type Props = MeterTrackProps;
 }

package/meter/value/MeterValue.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { BaseUIComponentProps } from "../../utils/types.js";
-import type { MeterRoot } from "../root/MeterRoot.js";
+import type { MeterRootState } from "../root/MeterRoot.js";
 /**
  * A text element displaying the current value.
  * Renders a `<span>` element.
@@ -8,9 +8,11 @@ import type { MeterRoot } from "../root/MeterRoot.js";
  * Documentation: [Base UI Meter](https://base-ui.com/react/components/meter)
  */
 export declare const MeterValue: React.ForwardRefExoticComponent<Omit<MeterValueProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
-export interface MeterValueProps extends Omit<BaseUIComponentProps<'span', MeterRoot.State>, 'children'> {
-  children?: (null | ((formattedValue: string, value: number) => React.ReactNode)) | undefined;
+export interface MeterValueState extends MeterRootState {}
+export interface MeterValueProps extends Omit<BaseUIComponentProps<'span', MeterValueState>, 'children'> {
+  children?: null | ((formattedValue: string, value: number) => React.ReactNode) | undefined;
 }
 export declare namespace MeterValue {
+  type State = MeterValueState;
   type Props = MeterValueProps;
 }

package/navigation-menu/arrow/NavigationMenuArrow.d.ts

@@ -13,11 +13,20 @@ export interface NavigationMenuArrowState {
    * Whether the popup is currently open.
    */
   open: boolean;
+  /**
+   * The side of the anchor the component is placed on.
+   */
   side: Side;
+  /**
+   * The alignment of the component relative to the anchor.
+   */
   align: Align;
+  /**
+   * Whether the arrow cannot be centered on the anchor.
+   */
   uncentered: boolean;
 }
-export interface NavigationMenuArrowProps extends BaseUIComponentProps<'div', NavigationMenuArrow.State> {}
+export interface NavigationMenuArrowProps extends BaseUIComponentProps<'div', NavigationMenuArrowState> {}
 export declare namespace NavigationMenuArrow {
   type State = NavigationMenuArrowState;
   type Props = NavigationMenuArrowProps;

package/navigation-menu/backdrop/NavigationMenuBackdrop.d.ts

@@ -18,7 +18,7 @@ export interface NavigationMenuBackdropState {
    */
   transitionStatus: TransitionStatus;
 }
-export interface NavigationMenuBackdropProps extends BaseUIComponentProps<'div', NavigationMenuBackdrop.State> {}
+export interface NavigationMenuBackdropProps extends BaseUIComponentProps<'div', NavigationMenuBackdropState> {}
 export declare namespace NavigationMenuBackdrop {
   type State = NavigationMenuBackdropState;
   type Props = NavigationMenuBackdropProps;

package/navigation-menu/content/NavigationMenuContent.d.ts

@@ -23,7 +23,7 @@ export interface NavigationMenuContentState {
    */
   activationDirection: 'left' | 'right' | 'up' | 'down' | null;
 }
-export interface NavigationMenuContentProps extends BaseUIComponentProps<'div', NavigationMenuContent.State> {
+export interface NavigationMenuContentProps extends BaseUIComponentProps<'div', NavigationMenuContentState> {
   /**
    * Whether to keep the content mounted in the DOM while the popup is closed.
    * Ensures the content is present during server-side rendering for web crawlers.

package/navigation-menu/content/NavigationMenuContent.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.NavigationMenuContent = void 0;
 var React = _interopRequireWildcard(require("react"));
 var ReactDOM = _interopRequireWildcard(require("react-dom"));
+var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _inertValue = require("@base-ui/utils/inertValue");
 var _floatingUiReact = require("../../floating-ui-react");
 var _utils = require("../../floating-ui-react/utils");
@@ -83,6 +84,16 @@ const NavigationMenuContent = exports.NavigationMenuContent = /*#__PURE__*/React
       }
     }
   });
+
+  // When a content re-enters while still mounted (e.g. switching top-level triggers
+  // back before the exit animation completes), the DOM element hasn't changed so the
+  // callback ref won't fire again. Ensure the shared ref is updated so the
+  // MutationObserver in the trigger watches the correct content element.
+  (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
+    if (open && ref.current) {
+      currentContentRef.current = ref.current;
+    }
+  }, [open, currentContentRef]);
   const state = {
     open,
     transitionStatus,

package/navigation-menu/icon/NavigationMenuIcon.d.ts

@@ -12,7 +12,7 @@ export interface NavigationMenuIconState {
    */
   open: boolean;
 }
-export interface NavigationMenuIconProps extends BaseUIComponentProps<'span', NavigationMenuIcon.State> {}
+export interface NavigationMenuIconProps extends BaseUIComponentProps<'span', NavigationMenuIconState> {}
 export declare namespace NavigationMenuIcon {
   type State = NavigationMenuIconState;
   type Props = NavigationMenuIconProps;

package/navigation-menu/item/NavigationMenuItem.d.ts

@@ -8,7 +8,7 @@ import type { BaseUIComponentProps } from "../../utils/types.js";
  */
 export declare const NavigationMenuItem: React.ForwardRefExoticComponent<Omit<NavigationMenuItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;
 export interface NavigationMenuItemState {}
-export interface NavigationMenuItemProps extends BaseUIComponentProps<'li', NavigationMenuItem.State> {
+export interface NavigationMenuItemProps extends BaseUIComponentProps<'li', NavigationMenuItemState> {
   /**
    * A unique value that identifies this navigation menu item.
    * If no value is provided, a unique ID will be generated automatically.

package/navigation-menu/link/NavigationMenuLink.d.ts

@@ -13,7 +13,7 @@ export interface NavigationMenuLinkState {
    */
   active: boolean;
 }
-export interface NavigationMenuLinkProps extends BaseUIComponentProps<'a', NavigationMenuLink.State> {
+export interface NavigationMenuLinkProps extends BaseUIComponentProps<'a', NavigationMenuLinkState> {
   /**
    * Whether the link is the currently active page.
    * @default false

package/navigation-menu/list/NavigationMenuList.d.ts

@@ -13,7 +13,7 @@ export interface NavigationMenuListState {
    */
   open: boolean;
 }
-export interface NavigationMenuListProps extends BaseUIComponentProps<'ul', NavigationMenuList.State> {}
+export interface NavigationMenuListProps extends BaseUIComponentProps<'ul', NavigationMenuListState> {}
 export declare namespace NavigationMenuList {
   type State = NavigationMenuListState;
   type Props = NavigationMenuListProps;

package/navigation-menu/list/NavigationMenuList.js

@@ -35,11 +35,18 @@ const NavigationMenuList = exports.NavigationMenuList = /*#__PURE__*/React.forwa
     floatingRootContext,
     positionerElement,
     value,
+    closeDelay,
+    viewportElement,
     nested
   } = (0, _NavigationMenuRootContext.useNavigationMenuRootContext)();
   const fallbackContext = React.useMemo(() => (0, _getEmptyRootContext.getEmptyRootContext)(), []);
   const context = floatingRootContext || fallbackContext;
   const interactionsEnabled = positionerElement ? true : !value;
+  const hoverInteractionsEnabled = positionerElement || viewportElement ? true : !value;
+  (0, _floatingUiReact.useHoverFloatingInteraction)(context, {
+    enabled: Boolean(floatingRootContext) && hoverInteractionsEnabled,
+    closeDelay
+  });
   const dismiss = (0, _floatingUiReact.useDismiss)(context, {
     enabled: interactionsEnabled,
     outsidePressEvent: 'intentional',
@@ -57,7 +64,9 @@ const NavigationMenuList = exports.NavigationMenuList = /*#__PURE__*/React.forwa
   // `stopEventPropagation` won't stop the propagation if the end of the list is reached,
   // but we want to block it in this case.
   // When nested, skip this handler so arrow keys can reach the parent CompositeRoot.
-  const defaultProps = nested ? {} : {
+  const defaultProps = nested ? {
+    'aria-orientation': orientation
+  } : {
     onKeyDown(event) {
       const shouldStop = orientation === 'horizontal' && (event.key === 'ArrowLeft' || event.key === 'ArrowRight') || orientation === 'vertical' && (event.key === 'ArrowUp' || event.key === 'ArrowDown');
       if (shouldStop) {

package/navigation-menu/popup/NavigationMenuPopup.d.ts

@@ -31,7 +31,7 @@ export interface NavigationMenuPopupState {
    */
   anchorHidden: boolean;
 }
-export interface NavigationMenuPopupProps extends BaseUIComponentProps<'nav', NavigationMenuPopup.State> {}
+export interface NavigationMenuPopupProps extends BaseUIComponentProps<'nav', NavigationMenuPopupState> {}
 export declare namespace NavigationMenuPopup {
   type State = NavigationMenuPopupState;
   type Props = NavigationMenuPopupProps;

package/navigation-menu/portal/NavigationMenuPortal.d.ts

@@ -8,10 +8,8 @@ import { FloatingPortal } from "../../floating-ui-react/index.js";
  * Documentation: [Base UI Navigation Menu](https://base-ui.com/react/components/navigation-menu)
  */
 export declare const NavigationMenuPortal: React.ForwardRefExoticComponent<Omit<NavigationMenuPortalProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export declare namespace NavigationMenuPortal {
-  interface State {}
-}
-export interface NavigationMenuPortalProps extends FloatingPortal.Props<NavigationMenuPortal.State> {
+export interface NavigationMenuPortalState {}
+export interface NavigationMenuPortalProps extends FloatingPortal.Props<NavigationMenuPortalState> {
   /**
    * Whether to keep the portal mounted in the DOM while the popup is hidden.
    * @default false
@@ -20,8 +18,9 @@ export interface NavigationMenuPortalProps extends FloatingPortal.Props<Navigati
   /**
    * A parent element to render the portal element into.
    */
-  container?: FloatingPortal.Props<NavigationMenuPortal.State>['container'] | undefined;
+  container?: FloatingPortal.Props<NavigationMenuPortalState>['container'] | undefined;
 }
 export declare namespace NavigationMenuPortal {
+  type State = NavigationMenuPortalState;
   type Props = NavigationMenuPortalProps;
 }

package/navigation-menu/positioner/NavigationMenuPositioner.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { BaseUIComponentProps } from "../../utils/types.js";
-import { useAnchorPositioning, type Align, type Side } from "../../utils/useAnchorPositioning.js";
+import { type Align, type Side, type UseAnchorPositioningSharedParameters } from "../../utils/useAnchorPositioning.js";
 /**
  * Positions the navigation menu against the currently active trigger.
  * Renders a `<div>` element.
@@ -13,15 +13,24 @@ export interface NavigationMenuPositionerState {
    * Whether the navigation menu is currently open.
    */
   open: boolean;
+  /**
+   * The side of the anchor the component is placed on.
+   */
   side: Side;
+  /**
+   * The alignment of the component relative to the anchor.
+   */
   align: Align;
+  /**
+   * Whether the anchor element is hidden.
+   */
   anchorHidden: boolean;
   /**
    * Whether CSS transitions should be disabled.
    */
   instant: boolean;
 }
-export interface NavigationMenuPositionerProps extends useAnchorPositioning.SharedParameters, BaseUIComponentProps<'div', NavigationMenuPositioner.State> {}
+export interface NavigationMenuPositionerProps extends UseAnchorPositioningSharedParameters, BaseUIComponentProps<'div', NavigationMenuPositionerState> {}
 export declare namespace NavigationMenuPositioner {
   type State = NavigationMenuPositionerState;
   type Props = NavigationMenuPositionerProps;

package/navigation-menu/root/NavigationMenuRoot.d.ts

@@ -19,7 +19,7 @@ export interface NavigationMenuRootState {
    */
   nested: boolean;
 }
-export interface NavigationMenuRootProps extends BaseUIComponentProps<'nav', NavigationMenuRoot.State> {
+export interface NavigationMenuRootProps extends BaseUIComponentProps<'nav', NavigationMenuRootState> {
   /**
    * A ref to imperative actions.
    */
@@ -48,12 +48,12 @@ export interface NavigationMenuRootProps extends BaseUIComponentProps<'nav', Nav
    */
   onValueChange?: ((value: any, eventDetails: NavigationMenuRoot.ChangeEventDetails) => void) | undefined;
   /**
-   * How long to wait before opening the navigation menu. Specified in milliseconds.
+   * How long to wait before opening the navigation popup. Specified in milliseconds.
    * @default 50
    */
   delay?: number | undefined;
   /**
-   * How long to wait before closing the navigation menu. Specified in milliseconds.
+   * How long to wait before closing the navigation popup. Specified in milliseconds.
    * @default 50
    */
   closeDelay?: number | undefined;
@@ -61,7 +61,7 @@ export interface NavigationMenuRootProps extends BaseUIComponentProps<'nav', Nav
    * The orientation of the navigation menu.
    * @default 'horizontal'
    */
-  orientation?: ('horizontal' | 'vertical') | undefined;
+  orientation?: 'horizontal' | 'vertical' | undefined;
 }
 export interface NavigationMenuRootActions {
   unmount: () => void;

package/navigation-menu/root/NavigationMenuRoot.js

@@ -17,10 +17,25 @@ var _useRenderElement = require("../../utils/useRenderElement");
 var _NavigationMenuRootContext = require("./NavigationMenuRootContext");
 var _useOpenChangeComplete = require("../../utils/useOpenChangeComplete");
 var _useTransitionStatus = require("../../utils/useTransitionStatus");
-var _setFixedSize = require("../utils/setFixedSize");
+var _getCssDimensions = require("../../utils/getCssDimensions");
 var _reasons = require("../../utils/reasons");
+var _NavigationMenuPopupCssVars = require("../popup/NavigationMenuPopupCssVars");
+var _NavigationMenuPositionerCssVars = require("../positioner/NavigationMenuPositionerCssVars");
 var _jsxRuntime = require("react/jsx-runtime");
 const blockedReturnFocusReasons = new Set([_reasons.REASONS.triggerHover, _reasons.REASONS.outsidePress, _reasons.REASONS.focusOut]);
+function setSharedFixedSize(popupElement, positionerElement) {
+  const {
+    width,
+    height
+  } = (0, _getCssDimensions.getCssDimensions)(popupElement);
+  if (width === 0 || height === 0) {
+    return;
+  }
+  popupElement.style.setProperty(_NavigationMenuPopupCssVars.NavigationMenuPopupCssVars.popupWidth, `${width}px`);
+  popupElement.style.setProperty(_NavigationMenuPopupCssVars.NavigationMenuPopupCssVars.popupHeight, `${height}px`);
+  positionerElement.style.setProperty(_NavigationMenuPositionerCssVars.NavigationMenuPositionerCssVars.positionerWidth, `${width}px`);
+  positionerElement.style.setProperty(_NavigationMenuPositionerCssVars.NavigationMenuPositionerCssVars.positionerHeight, `${height}px`);
+}
 
 /**
  * Groups all parts of the navigation menu.
@@ -40,6 +55,7 @@ const NavigationMenuRoot = exports.NavigationMenuRoot = /*#__PURE__*/React.forwa
     onOpenChangeComplete
   } = componentProps;
   const nested = (0, _floatingUiReact.useFloatingParentNodeId)() != null;
+  const parentRootContext = (0, _NavigationMenuRootContext.useNavigationMenuRootContext)(true);
   const [value, setValueUnwrapped] = (0, _useControlled.useControlled)({
     controlled: valueParam,
     default: defaultValue,
@@ -78,8 +94,7 @@ const NavigationMenuRoot = exports.NavigationMenuRoot = /*#__PURE__*/React.forwa
       setActivationDirection(null);
       setFloatingRootContext(undefined);
       if (positionerElement && popupElement) {
-        (0, _setFixedSize.setFixedSize)(popupElement, 'popup');
-        (0, _setFixedSize.setFixedSize)(positionerElement, 'positioner');
+        setSharedFixedSize(popupElement, positionerElement);
       }
     }
     if (nextValue !== value) {
@@ -89,6 +104,9 @@ const NavigationMenuRoot = exports.NavigationMenuRoot = /*#__PURE__*/React.forwa
       return;
     }
     setValueUnwrapped(nextValue);
+    if (nested && !nextValue && eventDetails.reason === _reasons.REASONS.linkPress && parentRootContext) {
+      parentRootContext.setValue(null, eventDetails);
+    }
   });
   const handleUnmount = (0, _useStableCallback.useStableCallback)(() => {
     const doc = (0, _owner.ownerDocument)(rootRef.current);
@@ -209,12 +227,13 @@ function TreeContext(props) {
   const element = (0, _useRenderElement.useRenderElement)(nested ? 'div' : 'nav', props.componentProps, {
     state,
     ref: [props.forwardedRef, rootRef],
-    props: [{
-      'aria-orientation': orientation
-    }, elementProps]
+    props: elementProps
   });
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_NavigationMenuRootContext.NavigationMenuTreeContext.Provider, {
     value: nodeId,
-    children: element
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_floatingUiReact.FloatingNode, {
+      id: nodeId,
+      children: element
+    })
   });
 }

package/navigation-menu/trigger/NavigationMenuTrigger.d.ts

@@ -14,7 +14,7 @@ export interface NavigationMenuTriggerState {
    */
   open: boolean;
 }
-export interface NavigationMenuTriggerProps extends NativeButtonProps, BaseUIComponentProps<'button', NavigationMenuTrigger.State> {}
+export interface NavigationMenuTriggerProps extends NativeButtonProps, BaseUIComponentProps<'button', NavigationMenuTriggerState> {}
 export declare namespace NavigationMenuTrigger {
   type State = NavigationMenuTriggerState;
   type Props = NavigationMenuTriggerProps;