@base-ui/react 1.4.0 → 1.5.0

package/tabs/indicator/TabsIndicator.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.TabsIndicator = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _useForcedRerendering = require("@base-ui/utils/useForcedRerendering");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 var _getCssDimensions = require("../../utils/getCssDimensions");
 var _useIsHydrating = require("../../utils/useIsHydrating");
 var _TabsRootContext = require("../root/TabsRootContext");
@@ -16,7 +16,7 @@ var _stateAttributesMapping = require("../root/stateAttributesMapping");
 var _TabsListContext = require("../list/TabsListContext");
 var _prehydrationScript = require("./prehydrationScript.min");
 var _TabsIndicatorCssVars = require("./TabsIndicatorCssVars");
-var _CSPContext = require("../../csp-provider/CSPContext");
+var _CSPContext = require("../../internals/csp-context/CSPContext");
 var _jsxRuntime = require("react/jsx-runtime");
 const stateAttributesMapping = {
   ..._stateAttributesMapping.tabsStateAttributesMapping,
@@ -30,7 +30,7 @@ const stateAttributesMapping = {
  *
  * Documentation: [Base UI Tabs](https://base-ui.com/react/components/tabs)
  */
-const TabsIndicator = exports.TabsIndicator = /*#__PURE__*/React.forwardRef(function TabIndicator(componentProps, forwardedRef) {
+const TabsIndicator = exports.TabsIndicator = /*#__PURE__*/React.forwardRef(function TabsIndicator(componentProps, forwardedRef) {
   const {
     className,
     render,
@@ -95,29 +95,24 @@ const TabsIndicator = exports.TabsIndicator = /*#__PURE__*/React.forwardRef(func
       bottom = tabsListElement.scrollHeight - top - height;
     }
   }
-  const activeTabPosition = React.useMemo(() => isTabSelected ? {
+  const activeTabPosition = isTabSelected ? {
     left,
     right,
     top,
     bottom
-  } : null, [left, right, top, bottom, isTabSelected]);
-  const activeTabSize = React.useMemo(() => isTabSelected ? {
+  } : null;
+  const activeTabSize = isTabSelected ? {
     width,
     height
-  } : null, [width, height, isTabSelected]);
-  const style = React.useMemo(() => {
-    if (!isTabSelected) {
-      return undefined;
-    }
-    return {
-      [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabLeft]: `${left}px`,
-      [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabRight]: `${right}px`,
-      [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabTop]: `${top}px`,
-      [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabBottom]: `${bottom}px`,
-      [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabWidth]: `${width}px`,
-      [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabHeight]: `${height}px`
-    };
-  }, [left, right, top, bottom, width, height, isTabSelected]);
+  } : null;
+  const style = isTabSelected ? {
+    [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabLeft]: `${left}px`,
+    [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabRight]: `${right}px`,
+    [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabTop]: `${top}px`,
+    [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabBottom]: `${bottom}px`,
+    [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabWidth]: `${width}px`,
+    [_TabsIndicatorCssVars.TabsIndicatorCssVars.activeTabHeight]: `${height}px`
+  } : undefined;
   const displayIndicator = isTabSelected && width > 0 && height > 0;
   const state = {
     orientation,

package/tabs/list/TabsList.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 { TabsRootState } from "../root/TabsRoot.js";
 /**
  * Groups the individual tab buttons.

package/tabs/list/TabsList.js

@@ -8,11 +8,11 @@ Object.defineProperty(exports, "__esModule", {
 exports.TabsList = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
-var _CompositeRoot = require("../../composite/root/CompositeRoot");
+var _empty = require("@base-ui/utils/empty");
+var _CompositeRoot = require("../../internals/composite/root/CompositeRoot");
 var _stateAttributesMapping = require("../root/stateAttributesMapping");
 var _TabsRootContext = require("../root/TabsRootContext");
 var _TabsListContext = require("./TabsListContext");
-var _constants = require("../../utils/constants");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Groups the individual tab buttons.
@@ -41,20 +41,14 @@ const TabsList = exports.TabsList = /*#__PURE__*/React.forwardRef(function TabsL
   const indicatorUpdateListenersRef = React.useRef(new Set());
   const tabResizeObserverElementsRef = React.useRef(new Set());
   const resizeObserverRef = React.useRef(null);
-  const notifyIndicatorUpdateListeners = (0, _useStableCallback.useStableCallback)(() => {
-    indicatorUpdateListenersRef.current.forEach(listener => {
-      listener();
-    });
-  });
   React.useEffect(() => {
     if (typeof ResizeObserver === 'undefined') {
       return undefined;
     }
     const resizeObserver = new ResizeObserver(() => {
-      if (!indicatorUpdateListenersRef.current.size) {
-        return;
-      }
-      notifyIndicatorUpdateListeners();
+      indicatorUpdateListenersRef.current.forEach(listener => {
+        listener();
+      });
     });
     resizeObserverRef.current = resizeObserver;
     if (tabsListElement) {
@@ -67,7 +61,7 @@ const TabsList = exports.TabsList = /*#__PURE__*/React.forwardRef(function TabsL
       resizeObserver.disconnect();
       resizeObserverRef.current = null;
     };
-  }, [tabsListElement, notifyIndicatorUpdateListeners]);
+  }, [tabsListElement]);
   const registerIndicatorUpdateListener = (0, _useStableCallback.useStableCallback)(listener => {
     indicatorUpdateListenersRef.current.add(listener);
     return () => {
@@ -120,7 +114,7 @@ const TabsList = exports.TabsList = /*#__PURE__*/React.forwardRef(function TabsL
       orientation: orientation,
       onHighlightedIndexChange: setHighlightedTabIndex,
       onMapChange: setTabMap,
-      disabledIndices: _constants.EMPTY_ARRAY
+      disabledIndices: _empty.EMPTY_ARRAY
     })
   });
 });

package/tabs/list/TabsListContext.d.ts

@@ -1,11 +1,12 @@
 import * as React from 'react';
 import type { TabsRoot } from "../root/TabsRoot.js";
+import type { TabsTab } from "../tab/TabsTab.js";
 export interface TabsListContext {
   activateOnFocus: boolean;
   highlightedTabIndex: number;
   registerIndicatorUpdateListener: (listener: () => void) => () => void;
   registerTabResizeObserverElement: (element: HTMLElement) => () => void;
-  onTabActivation: (newValue: any, eventDetails: TabsRoot.ChangeEventDetails) => void;
+  onTabActivation: (newValue: TabsTab.Value, eventDetails: TabsRoot.ChangeEventDetails) => void;
   setHighlightedTabIndex: (index: number) => void;
   tabsListElement: HTMLElement | null;
 }

package/tabs/panel/TabsPanel.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { type TransitionStatus } from "../../utils/useTransitionStatus.js";
-import type { BaseUIComponentProps } from "../../utils/types.js";
+import { type TransitionStatus } from "../../internals/useTransitionStatus.js";
+import type { BaseUIComponentProps } from "../../internals/types.js";
 import type { TabsRootState } from "../root/TabsRoot.js";
 import type { TabsTab } from "../tab/TabsTab.js";
 /**

package/tabs/panel/TabsPanel.js

@@ -9,12 +9,12 @@ exports.TabsPanel = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _inertValue = require("@base-ui/utils/inertValue");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
-var _useBaseUiId = require("../../utils/useBaseUiId");
-var _stateAttributesMapping = require("../../utils/stateAttributesMapping");
-var _useOpenChangeComplete = require("../../utils/useOpenChangeComplete");
-var _useTransitionStatus = require("../../utils/useTransitionStatus");
-var _useRenderElement = require("../../utils/useRenderElement");
-var _useCompositeListItem = require("../../composite/list/useCompositeListItem");
+var _useBaseUiId = require("../../internals/useBaseUiId");
+var _stateAttributesMapping = require("../../internals/stateAttributesMapping");
+var _useOpenChangeComplete = require("../../internals/useOpenChangeComplete");
+var _useTransitionStatus = require("../../internals/useTransitionStatus");
+var _useRenderElement = require("../../internals/useRenderElement");
+var _useCompositeListItem = require("../../internals/composite/list/useCompositeListItem");
 var _stateAttributesMapping2 = require("../root/stateAttributesMapping");
 var _TabsRootContext = require("../root/TabsRootContext");
 var _TabsPanelDataAttributes = require("./TabsPanelDataAttributes");
@@ -29,7 +29,7 @@ const stateAttributesMapping = {
  *
  * Documentation: [Base UI Tabs](https://base-ui.com/react/components/tabs)
  */
-const TabsPanel = exports.TabsPanel = /*#__PURE__*/React.forwardRef(function TabPanel(componentProps, forwardedRef) {
+const TabsPanel = exports.TabsPanel = /*#__PURE__*/React.forwardRef(function TabsPanel(componentProps, forwardedRef) {
   const {
     className,
     value,

package/tabs/panel/TabsPanelDataAttributes.js

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

package/tabs/root/TabsRoot.d.ts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import type { BaseUIComponentProps, Orientation as BaseOrientation } from "../../utils/types.js";
+import type { BaseUIComponentProps, Orientation as BaseOrientation } from "../../internals/types.js";
 import type { TabsTab } from "../tab/TabsTab.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 the tabs and the corresponding panels.
  * Renders a `<div>` element.
@@ -40,10 +40,25 @@ export interface TabsRootProps extends BaseUIComponentProps<'div', TabsRootState
   orientation?: TabsRoot.Orientation | undefined;
   /**
    * Callback invoked when new value is being set.
+   *
+   * The event `reason` is `'none'` for user-initiated changes, such as a click
+   * or keyboard navigation; `'initial'` for the first automatic selection or
+   * fallback in uncontrolled roots when `defaultValue` is omitted or
+   * `undefined`, including when the implicit initial value is disabled or
+   * missing; `'disabled'` for automatic fallback when the selected tab becomes
+   * disabled in uncontrolled roots; or `'missing'` for automatic fallback when
+   * the selected tab is removed, or when an explicit `defaultValue` never
+   * matches a mounted tab in uncontrolled roots.
+   *
+   * For automatic changes, the selected value can be `null` when no enabled Tab
+   * is available as a fallback.
+   *
+   * Automatic changes cannot be canceled; calling `eventDetails.cancel()` for
+   * `'initial'`, `'disabled'`, or `'missing'` has no effect.
    */
   onValueChange?: ((value: TabsTab.Value, eventDetails: TabsRoot.ChangeEventDetails) => void) | undefined;
 }
-export type TabsRootChangeEventReason = typeof REASONS.none;
+export type TabsRootChangeEventReason = typeof REASONS.none | typeof REASONS.disabled | typeof REASONS.missing | typeof REASONS.initial;
 export type TabsRootChangeEventDetails = BaseUIChangeEventDetails<TabsRoot.ChangeEventReason, {
   activationDirection: TabsTab.ActivationDirection;
 }>;

package/tabs/root/TabsRoot.js

@@ -10,10 +10,12 @@ var React = _interopRequireWildcard(require("react"));
 var _useControlled = require("@base-ui/utils/useControlled");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
-var _useRenderElement = require("../../utils/useRenderElement");
-var _CompositeList = require("../../composite/list/CompositeList");
+var _useRenderElement = require("../../internals/useRenderElement");
+var _CompositeList = require("../../internals/composite/list/CompositeList");
 var _TabsRootContext = require("./TabsRootContext");
 var _stateAttributesMapping = require("./stateAttributesMapping");
+var _createBaseUIEventDetails = require("../../internals/createBaseUIEventDetails");
+var _reasons = require("../../internals/reasons");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Groups the tabs and the corresponding panels.
@@ -33,9 +35,9 @@ const TabsRoot = exports.TabsRoot = /*#__PURE__*/React.forwardRef(function TabsR
     ...elementProps
   } = componentProps;
 
-  // Track whether the user explicitly provided a `defaultValue` prop.
+  // Track whether the user explicitly provided a defined `defaultValue` prop.
   // Used to determine if we should honor a disabled tab selection.
-  const hasExplicitDefaultValueProp = Object.hasOwn(componentProps, 'defaultValue');
+  const hasExplicitDefaultValueProp = componentProps.defaultValue !== undefined;
   const tabPanelRefs = React.useRef([]);
   const [mountedTabPanels, setMountedTabPanels] = React.useState(() => new Map());
   const [value, setValue] = (0, _useControlled.useControlled)({
@@ -103,6 +105,11 @@ const TabsRoot = exports.TabsRoot = /*#__PURE__*/React.forwardRef(function TabsR
     }
     setValue(newValue);
   });
+  const notifyAutomaticValueChange = (0, _useStableCallback.useStableCallback)((nextValue, reason) => {
+    onValueChangeProp?.(nextValue, (0, _createBaseUIEventDetails.createChangeEventDetails)(reason, undefined, undefined, {
+      activationDirection: 'none'
+    }));
+  });
   const registerMountedTabPanel = (0, _useStableCallback.useStableCallback)((panelValue, panelId) => {
     setMountedTabPanels(prev => {
       if (prev.get(panelValue) === panelId) {
@@ -170,38 +177,78 @@ const TabsRoot = exports.TabsRoot = /*#__PURE__*/React.forwardRef(function TabsR
     return undefined;
   }, [tabMap]);
 
-  // Automatically switch to the first enabled tab when:
-  // - The current selection is disabled (and wasn't explicitly set via defaultValue)
-  // - The current selection is missing (tab was removed from DOM)
-  // Falls back to null if all tabs are disabled.
+  // Implicit uncontrolled selections are still automatic changes, so notify
+  // once when the tabs first register. Explicit defaults are treated as user-owned.
+  const shouldNotifyInitialValueChangeRef = React.useRef(!hasExplicitDefaultValueProp);
+  // An explicit defaultValue can intentionally point at a disabled tab on mount.
+  // Once that selection becomes valid, later disabled states should fall back.
+  const shouldHonorDisabledDefaultValueRef = React.useRef(hasExplicitDefaultValueProp);
+  const didRegisterTabsRef = React.useRef(false);
+
+  // Uncontrolled roots own automatic fallback. Controlled roots keep the exact
+  // value supplied by the parent, even when that tab is disabled or missing.
   (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
-    if (isControlled || tabMap.size === 0) {
+    if (isControlled) {
       return;
     }
+    function commitAutomaticValueChange(fallbackValue, fallbackReason) {
+      setValue(fallbackValue);
+      // Automatic fallbacks are not directional transitions; reset the direction
+      // alongside the value so the batched commit keeps both in sync.
+      setActivationDirectionState(prev => {
+        if (prev.previousValue === fallbackValue && prev.tabActivationDirection === 'none') {
+          return prev;
+        }
+        return {
+          previousValue: fallbackValue,
+          tabActivationDirection: 'none'
+        };
+      });
+      notifyAutomaticValueChange(fallbackValue, fallbackReason);
+      // Mark the initial notification as delivered only after the consumer
+      // callback returns. The fallback value is queued first so automatic
+      // consistency updates are not cancelable through a throwing handler.
+      shouldNotifyInitialValueChangeRef.current = false;
+    }
+    if (tabMap.size === 0) {
+      if (!didRegisterTabsRef.current || value === null) {
+        return;
+      }
+      commitAutomaticValueChange(null, _reasons.REASONS.missing);
+      return;
+    }
+    didRegisterTabsRef.current = true;
     const selectionIsDisabled = selectedTabMetadata?.disabled;
     const selectionIsMissing = selectedTabMetadata == null && value !== null;
-    const shouldHonorExplicitDefaultSelection = hasExplicitDefaultValueProp && selectionIsDisabled && value === defaultValueProp;
-    if (shouldHonorExplicitDefaultSelection) {
-      return;
+    if (!selectionIsDisabled && value === defaultValueProp) {
+      shouldHonorDisabledDefaultValueRef.current = false;
     }
-    if (!selectionIsDisabled && !selectionIsMissing) {
+    if (shouldHonorDisabledDefaultValueRef.current && selectionIsDisabled && value === defaultValueProp) {
       return;
     }
-    const fallbackValue = firstEnabledTabValue ?? null;
-    if (value === fallbackValue) {
+    const shouldNotifyInitialValueChange = shouldNotifyInitialValueChangeRef.current;
+    if (selectionIsDisabled || selectionIsMissing) {
+      const fallbackValue = firstEnabledTabValue ?? null;
+      if (value === fallbackValue) {
+        // Already at the fallback value; no commit or notification needed,
+        // but record that the implicit-initial transition has resolved.
+        shouldNotifyInitialValueChangeRef.current = false;
+        return;
+      }
+      let fallbackReason = _reasons.REASONS.missing;
+      if (shouldNotifyInitialValueChange) {
+        fallbackReason = _reasons.REASONS.initial;
+      } else if (selectionIsDisabled) {
+        fallbackReason = _reasons.REASONS.disabled;
+      }
+      commitAutomaticValueChange(fallbackValue, fallbackReason);
       return;
     }
-    setValue(fallbackValue);
-    setActivationDirectionState(prev => {
-      if (prev.tabActivationDirection === 'none') {
-        return prev;
-      }
-      return {
-        ...prev,
-        tabActivationDirection: 'none'
-      };
-    });
-  }, [defaultValueProp, firstEnabledTabValue, hasExplicitDefaultValueProp, isControlled, selectedTabMetadata, setValue, tabMap, value]);
+    if (shouldNotifyInitialValueChange && selectedTabMetadata != null) {
+      notifyAutomaticValueChange(value, _reasons.REASONS.initial);
+      shouldNotifyInitialValueChangeRef.current = false;
+    }
+  }, [defaultValueProp, firstEnabledTabValue, isControlled, notifyAutomaticValueChange, selectedTabMetadata, setValue, tabMap, value]);
   const state = {
     orientation,
     tabActivationDirection

package/tabs/root/TabsRootContext.d.ts

@@ -20,12 +20,10 @@ export interface TabsRootContext {
   getTabElementBySelectedValue: (selectedValue: TabsTab.Value | undefined) => HTMLElement | null;
   /**
    * Gets the `id` attribute of the Tab that corresponds to the given TabPanel value.
-   * @param (any) panelValue Value to find the Tab for.
    */
   getTabIdByPanelValue: (panelValue: TabsTab.Value) => string | undefined;
   /**
    * Gets the `id` attribute of the TabPanel that corresponds to the given Tab value.
-   * @param (any) tabValue Value to find the TabPanel for.
    */
   getTabPanelIdByValue: (tabValue: TabsTab.Value) => string | undefined;
   registerMountedTabPanel: (panelValue: TabsTab.Value | number, panelId: string) => void;

package/tabs/root/stateAttributesMapping.d.ts

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

package/tabs/tab/TabsTab.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BaseUIComponentProps, NativeButtonProps } from "../../utils/types.js";
+import type { BaseUIComponentProps, NativeButtonProps } from "../../internals/types.js";
 import type { TabsRoot } from "../root/TabsRoot.js";
 /**
  * An individual interactive tab button that toggles the corresponding panel.

package/tabs/tab/TabsTab.js

@@ -9,15 +9,15 @@ exports.TabsTab = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _owner = require("@base-ui/utils/owner");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
-var _useBaseUiId = require("../../utils/useBaseUiId");
-var _useRenderElement = require("../../utils/useRenderElement");
-var _useButton = require("../../use-button");
-var _constants = require("../../composite/constants");
-var _useCompositeItem = require("../../composite/item/useCompositeItem");
+var _useBaseUiId = require("../../internals/useBaseUiId");
+var _useRenderElement = require("../../internals/useRenderElement");
+var _useButton = require("../../internals/use-button");
+var _constants = require("../../internals/composite/constants");
+var _useCompositeItem = require("../../internals/composite/item/useCompositeItem");
 var _TabsRootContext = require("../root/TabsRootContext");
 var _TabsListContext = require("../list/TabsListContext");
-var _createBaseUIEventDetails = require("../../utils/createBaseUIEventDetails");
-var _reasons = require("../../utils/reasons");
+var _createBaseUIEventDetails = require("../../internals/createBaseUIEventDetails");
+var _reasons = require("../../internals/reasons");
 var _utils = require("../../floating-ui-react/utils");
 /**
  * An individual interactive tab button that toggles the corresponding panel.

package/toast/action/ToastAction.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BaseUIComponentProps, NativeButtonProps } from "../../utils/types.js";
+import type { BaseUIComponentProps, NativeButtonProps } from "../../internals/types.js";
 /**
  * Performs an action when clicked.
  * Renders a `<button>` element.

package/toast/action/ToastAction.js

@@ -8,8 +8,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.ToastAction = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _ToastRootContext = require("../root/ToastRootContext");
-var _useButton = require("../../use-button/useButton");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useButton = require("../../internals/use-button/useButton");
+var _useRenderElement = require("../../internals/useRenderElement");
 /**
  * Performs an action when clicked.
  * Renders a `<button>` element.

package/toast/arrow/ToastArrow.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BaseUIComponentProps } from "../../utils/types.js";
+import type { BaseUIComponentProps } from "../../internals/types.js";
 import type { Side, Align } from "../../utils/useAnchorPositioning.js";
 /**
  * Displays an element positioned against the toast anchor.

package/toast/arrow/ToastArrow.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.ToastArrow = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _ToastPositionerContext = require("../positioner/ToastPositionerContext");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 /**
  * Displays an element positioned against the toast anchor.
  * Renders a `<div>` element.

package/toast/close/ToastClose.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BaseUIComponentProps, NativeButtonProps } from "../../utils/types.js";
+import type { BaseUIComponentProps, NativeButtonProps } from "../../internals/types.js";
 /**
  * Closes the toast when clicked.
  * Renders a `<button>` element.

package/toast/close/ToastClose.js

@@ -9,8 +9,8 @@ exports.ToastClose = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _ToastRootContext = require("../root/ToastRootContext");
 var _ToastProviderContext = require("../provider/ToastProviderContext");
-var _useButton = require("../../use-button/useButton");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useButton = require("../../internals/use-button/useButton");
+var _useRenderElement = require("../../internals/useRenderElement");
 /**
  * Closes the toast when clicked.
  * Renders a `<button>` element.

package/toast/content/ToastContent.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BaseUIComponentProps } from "../../utils/types.js";
+import type { BaseUIComponentProps } from "../../internals/types.js";
 /**
  * A container for the contents of a toast.
  * Renders a `<div>` element.

package/toast/content/ToastContent.js

@@ -9,7 +9,7 @@ exports.ToastContent = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _ToastRootContext = require("../root/ToastRootContext");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 /**
  * A container for the contents of a toast.
  * Renders a `<div>` element.

package/toast/description/ToastDescription.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BaseUIComponentProps } from "../../utils/types.js";
+import type { BaseUIComponentProps } from "../../internals/types.js";
 /**
  * A description that describes the toast.
  * Can be used as the default message for the toast when no title is provided.

package/toast/description/ToastDescription.js

@@ -10,7 +10,7 @@ var React = _interopRequireWildcard(require("react"));
 var _useId = require("@base-ui/utils/useId");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _ToastRootContext = require("../root/ToastRootContext");
-var _useRenderElement = require("../../utils/useRenderElement");
+var _useRenderElement = require("../../internals/useRenderElement");
 /**
  * A description that describes the toast.
  * Can be used as the default message for the toast when no title is provided.

package/toast/positioner/ToastPositioner.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { type Side, type Align, type UseAnchorPositioningSharedParameters } from "../../utils/useAnchorPositioning.js";
-import type { BaseUIComponentProps } from "../../utils/types.js";
+import type { BaseUIComponentProps } from "../../internals/types.js";
 import type { ToastObject } from "../useToastManager.js";
 /**
  * Positions the toast against the anchor.

package/toast/positioner/ToastPositioner.js

@@ -8,11 +8,12 @@ Object.defineProperty(exports, "__esModule", {
 exports.ToastPositioner = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _dom = require("@floating-ui/utils/dom");
+var _empty = require("@base-ui/utils/empty");
 var _useAnchorPositioning = require("../../utils/useAnchorPositioning");
-var _constants = require("../../utils/constants");
+var _constants = require("../../internals/constants");
 var _ToastPositionerContext = require("./ToastPositionerContext");
 var _floatingUiReact = require("../../floating-ui-react");
-var _noop = require("../../utils/noop");
+var _noop = require("../../internals/noop");
 var _ToastRootCssVars = require("../root/ToastRootCssVars");
 var _ToastProviderContext = require("../provider/ToastProviderContext");
 var _usePositioner = require("../../utils/usePositioner");
@@ -29,7 +30,7 @@ const ToastPositioner = exports.ToastPositioner = /*#__PURE__*/React.forwardRef(
     ...props
   } = componentProps;
   const store = (0, _ToastProviderContext.useToastProviderContext)();
-  const positionerProps = toast.positionerProps ?? _constants.EMPTY_OBJECT;
+  const positionerProps = toast.positionerProps ?? _empty.EMPTY_OBJECT;
   const {
     render,
     className,

package/toast/provider/ToastProvider.js

@@ -55,7 +55,7 @@ const ToastProvider = exports.ToastProvider = function ToastProvider(props) {
       }
     });
     return unsubscribe;
-  }, [store, timeout, toastManager]);
+  }, [store, toastManager]);
   store.useSyncedValues({
     timeout,
     limit

package/toast/root/ToastRoot.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import type { BaseUIComponentProps } from "../../utils/types.js";
+import type { BaseUIComponentProps } from "../../internals/types.js";
 import type { ToastObject as ToastObjectType } from "../useToastManager.js";
-import type { TransitionStatus } from "../../utils/useTransitionStatus.js";
+import type { TransitionStatus } from "../../internals/useTransitionStatus.js";
 /**
  * Groups all parts of an individual toast.
  * Renders a `<div>` element.
@@ -20,7 +20,7 @@ export interface ToastRootState {
    */
   expanded: boolean;
   /**
-   * Whether the toast was removed due to exceeding the limit.
+   * Whether the toast was limited because the toast limit was exceeded.
    */
   limited: boolean;
   /**