@carbon/react 1.91.0 → 1.92.0-rc.0

package/lib/components/Select/Select.js

@@ -20,10 +20,10 @@ require('../FluidForm/FluidForm.js');
 var FormContext = require('../FluidForm/FormContext.js');
 var useId = require('../../internal/useId.js');
 var events = require('../../tools/events.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var index = require('../AILabel/index.js');
 var utils = require('../../internal/utils.js');
-var Text = require('../Text/Text.js');
 
 const Select = /*#__PURE__*/React.forwardRef(({
   className,

package/lib/components/Slider/Slider.js

@@ -16,13 +16,13 @@ var match = require('../../internal/keyboard/match.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var iconsReact = require('@carbon/icons-react');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 require('../Tooltip/DefinitionTooltip.js');
 var Tooltip = require('../Tooltip/Tooltip.js');
 var SliderHandles = require('./SliderHandles.js');
 var clamp = require('../../internal/clamp.js');
 var throttle = require('../../node_modules/es-toolkit/dist/compat/function/throttle.js');
-var Text = require('../Text/Text.js');
 
 const ThumbWrapper = ({
   hasTooltip,

package/lib/components/StructuredList/StructuredList.js

@@ -14,10 +14,10 @@ var cx = require('classnames');
 var useId = require('../../internal/useId.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var usePrefix = require('../../internal/usePrefix.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var iconsReact = require('@carbon/icons-react');
 var useOutsideClick = require('../../internal/useOutsideClick.js');
-var Text = require('../Text/Text.js');
 
 var _StructuredListCell;
 const GridSelectedRowStateContext = /*#__PURE__*/React.createContext(null);

package/lib/components/Tabs/Tabs.js

@@ -34,10 +34,10 @@ var usePressable = require('./usePressable.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var useEvent = require('../../internal/useEvent.js');
 var useMatchMedia = require('../../internal/useMatchMedia.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var index = require('../BadgeIndicator/index.js');
 var debounce = require('../../node_modules/es-toolkit/dist/compat/function/debounce.js');
-var Text = require('../Text/Text.js');
 
 var _ChevronLeft, _ChevronRight, _BadgeIndicator;
 const verticalTabHeight = 64;

package/lib/components/Tag/DismissibleTag.js

@@ -20,12 +20,12 @@ var Tag = require('./Tag.js');
 var iconsReact = require('@carbon/icons-react');
 require('../Tooltip/DefinitionTooltip.js');
 var Tooltip = require('../Tooltip/Tooltip.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var isEllipsisActive = require('./isEllipsisActive.js');
 var mergeRefs = require('../../tools/mergeRefs.js');
 var index = require('../AILabel/index.js');
 var utils = require('../../internal/utils.js');
-var Text = require('../Text/Text.js');
 
 var _Close;
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20071
@@ -56,7 +56,7 @@ const DismissibleTag = /*#__PURE__*/React.forwardRef(({
     const newElement = tagLabelRef.current?.getElementsByClassName(`${prefix}--tag__label`)[0];
     setIsEllipsisApplied(isEllipsisActive.isEllipsisActive(newElement));
   }, [prefix, tagLabelRef]);
-  const combinedRef = mergeRefs.default(tagLabelRef, forwardRef);
+  const combinedRef = mergeRefs.mergeRefs(tagLabelRef, forwardRef);
   const handleClose = event => {
     if (onClose) {
       event.stopPropagation();

package/lib/components/Tag/OperationalTag.js

@@ -18,10 +18,10 @@ var usePrefix = require('../../internal/usePrefix.js');
 var Tag = require('./Tag.js');
 require('../Tooltip/DefinitionTooltip.js');
 var Tooltip = require('../Tooltip/Tooltip.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var isEllipsisActive = require('./isEllipsisActive.js');
 var mergeRefs = require('../../tools/mergeRefs.js');
-var Text = require('../Text/Text.js');
 
 const TYPES = {
   red: 'Red',
@@ -57,7 +57,7 @@ const OperationalTag = /*#__PURE__*/React.forwardRef(({
     setIsEllipsisApplied(isEllipsisActive.isEllipsisActive(newElement));
   }, [prefix, tagRef]);
   const tooltipClasses = cx(`${prefix}--icon-tooltip`, `${prefix}--tag-label-tooltip`);
-  const combinedRef = mergeRefs.default(tagRef, forwardRef);
+  const combinedRef = mergeRefs.mergeRefs(tagRef, forwardRef);
   if (isEllipsisApplied) {
     return /*#__PURE__*/React.createElement(Tooltip.Tooltip, {
       label: text,

package/lib/components/Tag/SelectableTag.js

@@ -18,11 +18,11 @@ var usePrefix = require('../../internal/usePrefix.js');
 var Tag = require('./Tag.js');
 require('../Tooltip/DefinitionTooltip.js');
 var Tooltip = require('../Tooltip/Tooltip.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var isEllipsisActive = require('./isEllipsisActive.js');
 var mergeRefs = require('../../tools/mergeRefs.js');
 var useControllableState = require('../../internal/useControllableState.js');
-var Text = require('../Text/Text.js');
 
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20071
 const SelectableTag = /*#__PURE__*/React.forwardRef(({
@@ -56,7 +56,7 @@ const SelectableTag = /*#__PURE__*/React.forwardRef(({
     setIsEllipsisApplied(isEllipsisActive.isEllipsisActive(newElement));
   }, [prefix, tagRef]);
   const tooltipClasses = cx(`${prefix}--icon-tooltip`, `${prefix}--tag-label-tooltip`);
-  const combinedRef = mergeRefs.default(tagRef, forwardRef);
+  const combinedRef = mergeRefs.mergeRefs(tagRef, forwardRef);
   const handleClick = e => {
     setSelectedTag(!selectedTag);
     onClick?.(e);

package/lib/components/Tag/Tag.js

@@ -16,7 +16,8 @@ var cx = require('classnames');
 var iconsReact = require('@carbon/icons-react');
 var useId = require('../../internal/useId.js');
 var usePrefix = require('../../internal/usePrefix.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var DefinitionTooltip = require('../Tooltip/DefinitionTooltip.js');
 require('../Tooltip/Tooltip.js');
@@ -24,7 +25,6 @@ var isEllipsisActive = require('./isEllipsisActive.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var index = require('../AILabel/index.js');
 var utils = require('../../internal/utils.js');
-var Text = require('../Text/Text.js');
 
 var _Close;
 const TYPES = {

package/lib/components/Text/Text.d.ts

@@ -6,7 +6,7 @@
  */
 import { type ElementType, type ReactElement, type ReactNode } from 'react';
 import { PolymorphicComponentPropWithRef, PolymorphicRef } from '../../internal/PolymorphicProps';
-import { type TextDir } from '.';
+import { type TextDir } from './TextDirectionContext';
 export interface TextBaseProps {
     dir?: TextDir;
     children?: ReactNode;

package/lib/components/Text/Text.js

@@ -10,7 +10,6 @@
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var PropTypes = require('prop-types');
 var React = require('react');
-require('./index.js');
 var TextDirectionContext = require('./TextDirectionContext.js');
 
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20071

package/lib/components/Text/TextDirection.d.ts

@@ -6,7 +6,7 @@
  */
 import PropTypes from 'prop-types';
 import { ReactNode } from 'react';
-import { type GetTextDirection, type TextDir } from '.';
+import { type GetTextDirection, type TextDir } from './TextDirectionContext';
 export interface TextDirectionProps {
     children: ReactNode;
     dir?: TextDir;

package/lib/components/Text/TextDirection.js

@@ -9,7 +9,6 @@
 
 var PropTypes = require('prop-types');
 var React = require('react');
-require('./index.js');
 var TextDirectionContext = require('./TextDirectionContext.js');
 
 const TextDirection = ({

package/lib/components/Text/createTextComponent.d.ts

@@ -5,14 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { type ElementType } from 'react';
-import { TextProps } from '.';
-/**
- * Create a text component wrapper for a given text node type. Useful for
- * returning a `Text` component for a text node like a `<label>`.
- * @param {string} element
- * @param {string} displayName
- */
-export declare const createTextComponent: (element: ElementType, displayName: string) => {
+import { TextProps } from './Text';
+export declare const Legend: {
     (props: TextProps<ElementType>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

package/lib/components/Text/createTextComponent.js

@@ -9,7 +9,6 @@
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var React = require('react');
-require('./index.js');
 var Text = require('./Text.js');
 
 /**
@@ -29,5 +28,6 @@ const createTextComponent = (element, displayName) => {
   }
   return TextWrapper;
 };
+const Legend = createTextComponent('legend', 'Legend');
 
-exports.createTextComponent = createTextComponent;
+exports.Legend = Legend;

package/lib/components/Text/index.d.ts

@@ -7,11 +7,3 @@
 export * from './Text';
 export * from './TextDirection';
 export * from './TextDirectionContext';
-export declare const Label: {
-    (props: import("./Text").TextProps<import("react").ElementType>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-export declare const Legend: {
-    (props: import("./Text").TextProps<import("react").ElementType>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};

package/lib/components/TextArea/TextArea.js

@@ -23,10 +23,10 @@ var useIsomorphicEffect = require('../../internal/useIsomorphicEffect.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var useId = require('../../internal/useId.js');
 var noopFn = require('../../internal/noopFn.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var index = require('../AILabel/index.js');
 var utils = require('../../internal/utils.js');
-var Text = require('../Text/Text.js');
 
 const frFn = React.forwardRef;
 const TextArea = frFn((props, forwardRef) => {

package/lib/components/TextInput/TextInput.js

@@ -20,10 +20,10 @@ var FormContext = require('../FluidForm/FormContext.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var getAnnouncement = require('../../internal/getAnnouncement.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var index = require('../AILabel/index.js');
 var utils = require('../../internal/utils.js');
-var Text = require('../Text/Text.js');
 
 const TextInput = /*#__PURE__*/React.forwardRef(({
   className,

package/lib/components/Tile/Tile.js

@@ -23,10 +23,10 @@ var useNoInteractiveChildren = require('../../internal/useNoInteractiveChildren.
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var index = require('../FeatureFlags/index.js');
 var useId = require('../../internal/useId.js');
-require('../Text/index.js');
+var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 var index$1 = require('../AILabel/index.js');
 var utils = require('../../internal/utils.js');
-var Text = require('../Text/Text.js');
 
 var _CheckboxCheckedFille, _Checkbox, _ChevronDown, _ChevronDown2;
 const Tile = /*#__PURE__*/React.forwardRef(({

package/lib/components/Toggle/Toggle.js

@@ -15,8 +15,8 @@ var PropTypes = require('prop-types');
 var cx = require('classnames');
 var useControllableState = require('../../internal/useControllableState.js');
 var usePrefix = require('../../internal/usePrefix.js');
-require('../Text/index.js');
 var Text = require('../Text/Text.js');
+require('../Text/TextDirection.js');
 
 var _path;
 function Toggle({
@@ -105,7 +105,7 @@ function Toggle({
       className: appearanceClasses
     }, /*#__PURE__*/React.createElement("div", {
       className: switchClasses
-    }, isSm && /*#__PURE__*/React.createElement("svg", {
+    }, isSm && !readOnly && /*#__PURE__*/React.createElement("svg", {
       "aria-hidden": "true",
       focusable: "false",
       className: `${prefix}--toggle__check`,

package/lib/components/UIShell/Switcher.js

@@ -16,34 +16,8 @@ var usePrefix = require('../../internal/usePrefix.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var PropTypes = require('prop-types');
 var AriaPropTypes = require('../../prop-types/AriaPropTypes.js');
-require('./Content.js');
-require('./Header.js');
-require('./HeaderContainer.js');
-require('./HeaderGlobalAction.js');
-require('./HeaderGlobalBar.js');
-require('./HeaderMenu.js');
-require('./HeaderMenuButton.js');
-require('./HeaderMenuItem.js');
-require('./HeaderName.js');
-require('./HeaderNavigation.js');
-require('./HeaderPanel.js');
-require('./HeaderSideNavItems.js');
 var SwitcherItem = require('./SwitcherItem.js');
 var SwitcherDivider = require('./SwitcherDivider.js');
-require('./SkipToContent.js');
-require('./SideNav.js');
-require('./SideNavDetails.js');
-require('./SideNavDivider.js');
-require('./SideNavFooter.js');
-require('./SideNavHeader.js');
-require('./SideNavIcon.js');
-require('./SideNavItem.js');
-require('./SideNavItems.js');
-require('./SideNavLink.js');
-require('./SideNavLinkText.js');
-require('./SideNavMenu.js');
-require('./SideNavMenuItem.js');
-require('./SideNavSwitcher.js');
 
 const Switcher = /*#__PURE__*/React.forwardRef((props, forwardRef) => {
   const switcherRef = React.useRef(null);

package/lib/index.d.ts

@@ -111,7 +111,7 @@ export { FluidMultiSelect, FluidMultiSelectSkeleton, FluidMultiSelect as unstabl
 export { FluidSelect, FluidSelectSkeleton, FluidSelect as unstable__FluidSelect, FluidSelectSkeleton as unstable__FluidSelectSkeleton, FluidSelect as preview__FluidSelect, FluidSelectSkeleton as preview__FluidSelectSkeleton, } from './components/FluidSelect';
 export { FluidSearch, FluidSearchSkeleton, FluidSearch as unstable__FluidSearch, FluidSearchSkeleton as unstable__FluidSearchSkeleton, FluidSearch as preview__FluidSearch, FluidSearchSkeleton as preview__FluidSearchSkeleton, } from './components/FluidSearch';
 export { FluidTextArea, FluidTextAreaSkeleton, FluidTextArea as unstable__FluidTextArea, FluidTextAreaSkeleton as unstable__FluidTextAreaSkeleton, FluidTextArea as preview__FluidTextArea, FluidTextAreaSkeleton as preview__FluidTextAreaSkeleton, } from './components/FluidTextArea';
-export { FluidTextInput, FluidTextInputSkeleton, FluidTextInput as unstable__FluidTextInput, FluidTextInputSkeleton as unstable__FluidTextInputSkeleton, FluidTextInput as preview__FluidTextInput, FluidTextInputSkeleton as preview__FluidTextInputSkeleton, } from './components/FluidTextInput';
+export { FluidPasswordInput, FluidTextInput, FluidTextInputSkeleton, FluidTextInput as unstable__FluidTextInput, FluidTextInputSkeleton as unstable__FluidTextInputSkeleton, FluidTextInput as preview__FluidTextInput, FluidTextInputSkeleton as preview__FluidTextInputSkeleton, } from './components/FluidTextInput';
 export { FluidNumberInput, FluidNumberInputSkeleton, FluidNumberInput as unstable__FluidNumberInput, FluidNumberInputSkeleton as unstable__FluidNumberInputSkeleton, FluidNumberInput as preview__FluidNumberInput, FluidNumberInputSkeleton as preview__FluidNumberInputSkeleton, } from './components/FluidNumberInput';
 export { FluidTimePicker, FluidTimePickerSkeleton, FluidTimePicker as unstable__FluidTimePicker, FluidTimePickerSkeleton as unstable__FluidTimePickerSkeleton, FluidTimePicker as preview__FluidTimePicker, FluidTimePickerSkeleton as preview__FluidTimePickerSkeleton, } from './components/FluidTimePicker';
 export { FluidTimePickerSelect, FluidTimePickerSelect as unstable__FluidTimePickerSelect, FluidTimePickerSelect as preview__FluidTimePickerSelect, } from './components/FluidTimePickerSelect';

package/lib/index.js

@@ -28,6 +28,7 @@ var CodeSnippet_Skeleton = require('./components/CodeSnippet/CodeSnippet.Skeleto
 var ComboBox = require('./components/ComboBox/ComboBox.js');
 var index$9 = require('./components/ComboButton/index.js');
 var ComposedModal = require('./components/ComposedModal/ComposedModal.js');
+var ComposedModalPresence = require('./components/ComposedModal/ComposedModalPresence.js');
 var ModalHeader = require('./components/ComposedModal/ModalHeader.js');
 var ModalFooter = require('./components/ComposedModal/ModalFooter.js');
 require('./components/ContainedList/index.js');
@@ -97,6 +98,7 @@ var Menu = require('./components/Menu/Menu.js');
 var MenuItem = require('./components/Menu/MenuItem.js');
 var index$b = require('./components/MenuButton/index.js');
 var Modal = require('./components/Modal/Modal.js');
+var ModalPresence = require('./components/Modal/ModalPresence.js');
 var ModalWrapper = require('./components/ModalWrapper/ModalWrapper.js');
 var FilterableMultiSelect = require('./components/MultiSelect/FilterableMultiSelect.js');
 var MultiSelect = require('./components/MultiSelect/MultiSelect.js');
@@ -207,7 +209,7 @@ var FluidSearch_Skeleton = require('./components/FluidSearch/FluidSearch.Skeleto
 var FluidTextArea = require('./components/FluidTextArea/FluidTextArea.js');
 var FluidTextArea_Skeleton = require('./components/FluidTextArea/FluidTextArea.Skeleton.js');
 var FluidTextInput = require('./components/FluidTextInput/FluidTextInput.js');
-require('./components/FluidTextInput/FluidPasswordInput.js');
+var FluidPasswordInput = require('./components/FluidTextInput/FluidPasswordInput.js');
 var FluidTextInput_Skeleton = require('./components/FluidTextInput/FluidTextInput.Skeleton.js');
 var FluidNumberInput = require('./components/FluidNumberInput/FluidNumberInput.js');
 var FluidNumberInput_Skeleton = require('./components/FluidNumberInput/FluidNumberInput.Skeleton.js');
@@ -233,7 +235,9 @@ var AISkeletonIcon = require('./components/AISkeleton/AISkeletonIcon.js');
 var AISkeletonText = require('./components/AISkeleton/AISkeletonText.js');
 var DefinitionTooltip = require('./components/Tooltip/DefinitionTooltip.js');
 var Tooltip = require('./components/Tooltip/Tooltip.js');
-require('./components/Text/index.js');
+var Text = require('./components/Text/Text.js');
+var TextDirection = require('./components/Text/TextDirection.js');
+require('react');
 var index$i = require('./components/Theme/index.js');
 var usePrefix = require('./internal/usePrefix.js');
 var useIdPrefix = require('./internal/useIdPrefix.js');
@@ -241,8 +245,6 @@ var PageSelector = require('./components/Pagination/experimental/PageSelector.js
 var Pagination = require('./components/Pagination/experimental/Pagination.js');
 var ContainedListItem = require('./components/ContainedList/ContainedListItem/ContainedListItem.js');
 var ContainedList = require('./components/ContainedList/ContainedList.js');
-var Text = require('./components/Text/Text.js');
-var TextDirection = require('./components/Text/TextDirection.js');
 
 
 
@@ -270,6 +272,7 @@ exports.ComboBox = ComboBox.default;
 exports.ComboButton = index$9.ComboButton;
 exports.ComposedModal = ComposedModal.default;
 exports.ModalBody = ComposedModal.ModalBody;
+exports.ComposedModalPresence = ComposedModalPresence.ComposedModalPresence;
 exports.ModalHeader = ModalHeader.ModalHeader;
 exports.ModalFooter = ModalFooter.ModalFooter;
 exports.ContentSwitcher = ContentSwitcher.ContentSwitcher;
@@ -350,6 +353,7 @@ exports.MenuItemRadioGroup = MenuItem.MenuItemRadioGroup;
 exports.MenuItemSelectable = MenuItem.MenuItemSelectable;
 exports.MenuButton = index$b.MenuButton;
 exports.Modal = Modal.default;
+exports.ModalPresence = ModalPresence.ModalPresence;
 exports.ModalWrapper = ModalWrapper.default;
 exports.FilterableMultiSelect = FilterableMultiSelect.FilterableMultiSelect;
 exports.MultiSelect = MultiSelect.MultiSelect;
@@ -521,6 +525,7 @@ exports.unstable__FluidTextAreaSkeleton = FluidTextArea_Skeleton.default;
 exports.FluidTextInput = FluidTextInput.default;
 exports.preview__FluidTextInput = FluidTextInput.default;
 exports.unstable__FluidTextInput = FluidTextInput.default;
+exports.FluidPasswordInput = FluidPasswordInput.default;
 exports.FluidTextInputSkeleton = FluidTextInput_Skeleton.default;
 exports.preview__FluidTextInputSkeleton = FluidTextInput_Skeleton.default;
 exports.unstable__FluidTextInputSkeleton = FluidTextInput_Skeleton.default;
@@ -584,6 +589,10 @@ exports.preview__AiSkeletonText = AISkeletonText.default;
 exports.unstable__AiSkeletonText = AISkeletonText.default;
 exports.DefinitionTooltip = DefinitionTooltip.DefinitionTooltip;
 exports.Tooltip = Tooltip.Tooltip;
+exports.preview_Text = Text.Text;
+exports.unstable_Text = Text.Text;
+exports.preview_TextDirection = TextDirection.TextDirection;
+exports.unstable_TextDirection = TextDirection.TextDirection;
 exports.GlobalTheme = index$i.GlobalTheme;
 exports.Theme = index$i.Theme;
 exports.ThemeContext = index$i.ThemeContext;
@@ -598,7 +607,3 @@ exports.preview_Pagination = Pagination.default;
 exports.unstable_Pagination = Pagination.default;
 exports.ContainedListItem = ContainedListItem.default;
 exports.ContainedList = ContainedList.default;
-exports.preview_Text = Text.Text;
-exports.unstable_Text = Text.Text;
-exports.preview_TextDirection = TextDirection.TextDirection;
-exports.unstable_TextDirection = TextDirection.TextDirection;

package/lib/internal/useNormalizedInputProps.js

@@ -9,9 +9,9 @@
 
 var React = require('react');
 var iconsReact = require('@carbon/icons-react');
-require('../components/Text/index.js');
-var usePrefix = require('./usePrefix.js');
 var Text = require('../components/Text/Text.js');
+require('../components/Text/TextDirection.js');
+var usePrefix = require('./usePrefix.js');
 
 /**
  * Returns an object containing normalized properties for an input component.

package/lib/internal/usePresence.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright IBM Corp. 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type RefObject } from 'react';
+export declare const usePresence: (ref: RefObject<HTMLElement | null>, isOpen: boolean) => {
+    /**
+     * Indicates whether the ref object is supposed to be mounted
+     */
+    isPresent: boolean;
+    /**
+     * Indicates whether the ref object is currently exiting
+     */
+    isExiting: boolean;
+};

package/lib/internal/usePresence.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+var React = require('react');
+var usePrefix = require('./usePrefix.js');
+
+const usePresence = (ref, isOpen) => {
+  const prefix = usePrefix.usePrefix();
+  const [exitState, setExitState] = React.useState(isOpen ? 'idle' : 'finished');
+  const isExiting = exitState === 'active';
+
+  // element is exiting
+  if (!isOpen && exitState === 'idle') {
+    setExitState('active');
+  }
+
+  // element exit was interrupted
+  if (isOpen && exitState !== 'idle') {
+    setExitState('idle');
+  }
+  const handleAnimationEnd = React.useCallback(() => {
+    setExitState('finished');
+  }, []);
+  React.useLayoutEffect(() => {
+    if (!ref.current || !isExiting) return;
+
+    // resolve for JSDOM
+    if (!('getAnimations' in ref.current)) {
+      handleAnimationEnd();
+      return;
+    }
+
+    // cover all animations that start with the presence prefix
+    const animations = ref.current.getAnimations({
+      subtree: true
+    }).filter(animation => animation instanceof CSSAnimation && animation.animationName.startsWith(`${prefix}--presence`));
+    if (!animations.length) {
+      handleAnimationEnd();
+      return;
+    }
+    let cancelled = false;
+    Promise.all(animations.map(animation => animation.finished)).finally(() => {
+      if (cancelled) return;
+      handleAnimationEnd();
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [ref, isExiting, prefix, handleAnimationEnd]);
+  return {
+    /**
+     * Indicates whether the ref object is supposed to be mounted
+     */
+    isPresent: isOpen || exitState !== 'finished',
+    /**
+     * Indicates whether the ref object is currently exiting
+     */
+    isExiting
+  };
+};
+
+exports.usePresence = usePresence;

package/lib/internal/usePresenceContext.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright IBM Corp. 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type RefObject } from 'react';
+export interface PresenceContext {
+    /**
+     * The ref object the presence mode is mounted with
+     */
+    presenceRef: RefObject<HTMLDivElement | null>;
+    /**
+     * Indicates whether the ref object is currently exiting
+     */
+    isExiting: boolean;
+    /**
+     * Returns if the caller is exclusive to this presence context
+     */
+    isPresenceExclusive: (id: string) => boolean;
+}
+/**
+ * Returns if the presence node is present and the context value to be used by a presence context, e.g. ModalPresence.
+ */
+export declare const usePresenceContext: (open: boolean, initialPresenceId?: string) => readonly [boolean, PresenceContext];

package/lib/internal/usePresenceContext.js

@@ -0,0 +1,48 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+var React = require('react');
+var usePresence = require('./usePresence.js');
+
+/**
+ * Returns if the presence node is present and the context value to be used by a presence context, e.g. ModalPresence.
+ */
+const usePresenceContext = (open, initialPresenceId) => {
+  const presenceIdRef = React.useRef(initialPresenceId);
+  const presenceRef = React.useRef(null);
+  const prevPresenceRef = React.useRef(null);
+
+  // clean up the presence id, if not predefined and if the presence node was unmounted
+  if (!initialPresenceId && prevPresenceRef.current && !presenceRef.current) {
+    presenceIdRef.current = null;
+  }
+  prevPresenceRef.current = presenceRef.current;
+  const {
+    isPresent,
+    isExiting
+  } = usePresence.usePresence(presenceRef, open);
+  const isPresenceExclusive = React.useCallback(id => {
+    if (!id) return false;
+
+    // return false if the presence context is occupied
+    if (presenceIdRef.current && presenceIdRef.current !== id) return false;
+
+    // otherwise occupy presence context and return true
+    presenceIdRef.current = id;
+    return true;
+  }, []);
+  const contextValue = React.useMemo(() => ({
+    presenceRef,
+    isPresenceExclusive,
+    isExiting
+  }), [presenceRef, isPresenceExclusive, isExiting]);
+  return [isPresent, contextValue];
+};
+
+exports.usePresenceContext = usePresenceContext;

package/lib/tools/mergeRefs.d.ts

@@ -1,12 +1,12 @@
-export default mergeRefs;
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import type { Ref, RefCallback } from 'react';
 /**
- * @param {...Ref<Element>} refs List of React refs to merge.
- * @returns {Ref<Element>} Merged React ref.
+ * @param refs Refs to merge.
+ * @returns Merged ref.
  */
-declare function mergeRefs(...refs: Ref<Element>[]): Ref<Element>;
+export declare const mergeRefs: <T>(...refs: (Ref<T> | null | undefined)[]) => RefCallback<T>;