@carbon/react 1.99.0-rc.0 → 1.100.0-rc.0

package/es/components/UIShell/SideNavMenu.js

@@ -8,7 +8,7 @@
 import { ChevronDown } from '@carbon/icons-react';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
-import React, { useContext, useState } from 'react';
+import React, { forwardRef, useContext, useState } from 'react';
 import SideNavIcon from './SideNavIcon.js';
 import { Escape } from '../../internal/keyboard/keys.js';
 import { match } from '../../internal/keyboard/match.js';
@@ -16,7 +16,7 @@ import { usePrefix } from '../../internal/usePrefix.js';
 import { SideNavContext } from './SideNav.js';
 
 var _ChevronDown;
-const SideNavMenu = /*#__PURE__*/React.forwardRef(({
+const SideNavMenu = /*#__PURE__*/forwardRef(({
   className: customClassName,
   children,
   defaultExpanded = false,

package/es/components/UIShell/SideNavMenuItem.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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 React, { ElementType, ComponentProps } from 'react';
+import React, { type ComponentProps, type ElementType } from 'react';
 import Link from './Link';
 export type SideNavMenuItemProps = ComponentProps<typeof Link> & {
     /**

package/es/components/UIShell/SideNavMenuItem.js

@@ -8,12 +8,12 @@
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
-import React from 'react';
+import React, { forwardRef } from 'react';
 import SideNavLinkText from './SideNavLinkText.js';
 import Link from './Link.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-const SideNavMenuItem = /*#__PURE__*/React.forwardRef((props, ref) => {
+const SideNavMenuItem = /*#__PURE__*/forwardRef((props, ref) => {
   const prefix = usePrefix();
   const {
     children,

package/es/components/UIShell/SwitcherDivider.d.ts

@@ -4,12 +4,20 @@
  * 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 React from 'react';
+import PropTypes from 'prop-types';
 export interface SwitcherDividerProps {
     /**
      * Optionally provide a custom class to apply to the underlying `<li>` node
      */
     className?: string;
 }
-declare const SwitcherDivider: React.FC<SwitcherDividerProps>;
+declare const SwitcherDivider: {
+    ({ className: customClassName, ...other }: SwitcherDividerProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Optionally provide a custom class to apply to the underlying `<li>` node
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default SwitcherDivider;

package/es/internal/FloatingMenu.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/internal/FloatingMenu.js

@@ -153,8 +153,6 @@ const FloatingMenu = ({
       // Re-check after setting the position if not already adjusting.
       if (!isAdjustment) {
         const newMenuSize = menuBody.getBoundingClientRect();
-        // TODO: Was there a bug in the old code? How could one `DOMRect` be
-        // compared to another using `!==`?
         if (newMenuSize.width !== menuSize.width || newMenuSize.height !== menuSize.height) {
           updateMenuPosition(true);
         }

package/es/internal/PolymorphicProps.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2025
+ * Copyright IBM Corp. 2025, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -8,9 +8,9 @@ type AsProp<C extends React.ElementType> = {
     as?: C;
 };
 type PropsToOmit<C extends React.ElementType, P> = keyof (AsProp<C> & P);
-export type PolymorphicComponentProp<C extends React.ElementType, Props = {}> = React.PropsWithChildren<Props & AsProp<C>> & Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
+export type PolymorphicComponentProp<C extends React.ElementType, Props = Record<string, never>> = React.PropsWithChildren<Props & AsProp<C>> & Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
 export type PolymorphicRef<C extends React.ElementType> = React.ComponentPropsWithRef<C>['ref'];
-export type PolymorphicComponentPropWithRef<C extends React.ElementType, Props = {}> = PolymorphicComponentProp<C, Props> & {
+export type PolymorphicComponentPropWithRef<C extends React.ElementType, Props = Record<string, never>> = PolymorphicComponentProp<C, Props> & {
     ref?: PolymorphicRef<C>;
 };
 export {};

package/es/internal/useNoInteractiveChildren.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/internal/useNoInteractiveChildren.js

@@ -8,13 +8,12 @@
 import { useEffect } from 'react';
 
 const useNoInteractiveChildren = (ref, message = 'component should have no interactive child nodes') => {
-  // TODO: Why can't the condition go inside the hook?
   if (process.env.NODE_ENV !== 'production') {
-    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
-    /*
+    // This hook is intentionally called conditionally because it is
+    // stripped from production builds. In development it runs once
+    // to enforce accessibility constraints.
+    //
     // eslint-disable-next-line react-hooks/rules-of-hooks
-    */
-    // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
     useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node) {
@@ -28,13 +27,12 @@ const useNoInteractiveChildren = (ref, message = 'component should have no inter
   }
 };
 const useInteractiveChildrenNeedDescription = (ref, message = `interactive child node(s) should have an \`aria-describedby\` property`) => {
-  // TODO: Why can't the condition go inside the hook?
   if (process.env.NODE_ENV !== 'production') {
-    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
-    /*
+    // This hook is intentionally called conditionally because it is
+    // stripped from production builds. In development it runs once
+    // to enforce accessibility constraints.
+    //
     // eslint-disable-next-line react-hooks/rules-of-hooks
-    */
-    // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
     useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node && !node.hasAttribute('aria-describedby')) {

package/es/internal/useOutsideClick.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/internal/useOutsideClick.js

@@ -19,11 +19,7 @@ const useOutsideClick = (ref, callback) => {
   // treated as a constant as it will be false when executed in a Node.js
   // environment and true when executed in the browser
   if (canUseDOM) {
-    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
-    /*
     // eslint-disable-next-line react-hooks/rules-of-hooks
-    */
-    // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
     useWindowEvent('click', event => {
       const {
         target

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

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/BadgeIndicator/index.js

@@ -15,11 +15,13 @@ var React = require('react');
 var cx = require('classnames');
 var usePrefix = require('../../internal/usePrefix.js');
 
-const BadgeIndicator = /*#__PURE__*/React.forwardRef(function BadgeIndicatorContent({
-  className: customClassName,
-  count,
-  ...rest
-}, ref) {
+const frFn = React.forwardRef;
+const BadgeIndicator = frFn((props, ref) => {
+  const {
+    className: customClassName,
+    count,
+    ...rest
+  } = props;
   const prefix = usePrefix.usePrefix();
   const classNames = cx(`${prefix}--badge-indicator`, customClassName, {
     [`${prefix}--badge-indicator--count`]: count

package/lib/components/Breadcrumb/BreadcrumbItem.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Breadcrumb/BreadcrumbItem.js

@@ -37,10 +37,9 @@ const BreadcrumbItem = frFn((props, ref) => {
     [`${prefix}--breadcrumb-item--current`]: isCurrentPage && ariaCurrent !== 'page',
     [customClassName]: !!customClassName
   });
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-  const child = children;
-  if (child.type && child.type.displayName !== undefined && child.type.displayName.includes('OverflowMenu')) {
+  const child = /*#__PURE__*/React.isValidElement(children) ? children : null;
+  const childType = child?.type;
+  if (child && typeof child.type !== 'string' && childType?.displayName?.includes('OverflowMenu')) {
     const horizontalOverflowIcon = /*#__PURE__*/React.createElement(iconsReact.OverflowMenuHorizontal, {
       className: `${prefix}--overflow-menu__icon`
     });
@@ -70,10 +69,10 @@ const BreadcrumbItem = frFn((props, ref) => {
   return /*#__PURE__*/React.createElement("li", _rollupPluginBabelHelpers.extends({
     className: className,
     ref: ref
-  }, rest), /*#__PURE__*/React.cloneElement(child, {
+  }, rest), child ? /*#__PURE__*/React.cloneElement(child, {
     'aria-current': ariaCurrent,
     className: cx(`${prefix}--link`, child.props.className)
-  }));
+  }) : children);
 });
 BreadcrumbItem.displayName = 'BreadcrumbItem';
 BreadcrumbItem.propTypes = {

package/lib/components/Button/Button.Skeleton.d.ts

@@ -1,9 +1,10 @@
 /**
- * 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 PropTypes from 'prop-types';
 import React from 'react';
 import { ButtonSize } from './Button';
 export interface ButtonSkeletonProps extends React.HTMLAttributes<HTMLElement> {
@@ -23,6 +24,31 @@ export interface ButtonSkeletonProps extends React.HTMLAttributes<HTMLElement> {
      */
     small?: boolean;
 }
-declare const ButtonSkeleton: React.FC<ButtonSkeletonProps>;
+declare const ButtonSkeleton: {
+    ({ className, small, href, size, ...rest }: ButtonSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Optionally specify an href for your Button to become an `<a>` element
+         */
+        href: PropTypes.Requireable<string>;
+        /**
+         * Specify the size of the button, from a list of available sizes.
+         * For `default` buttons, this prop can remain unspecified or use `default`.
+         * In the next major release of Carbon, `default`, `field`, and `small` will be removed
+         */
+        size: PropTypes.Requireable<string>;
+        /**
+         * @deprecated This property will be removed in the next major Carbon version,
+         * use size={sm} instead.
+         *
+         * Specify whether the Button should be a small variant
+         */
+        small: PropTypes.Requireable<boolean>;
+    };
+};
 export default ButtonSkeleton;
 export { ButtonSkeleton };

package/lib/components/Button/Button.js

@@ -25,8 +25,6 @@ function isIconOnlyButton(hasIconOnly, _kind) {
   }
   return false;
 }
-
-// eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20452
 const Button = /*#__PURE__*/React.forwardRef((props, ref) => {
   const {
     as,
@@ -108,7 +106,10 @@ const Button = /*#__PURE__*/React.forwardRef((props, ref) => {
     );
   }
 });
+
+// @ts-expect-error - `displayName` isn't typed.
 Button.displayName = 'Button';
+// @ts-expect-error - `propTypes` isn't typed.
 Button.propTypes = {
   /**
    * Specify how the button itself should be rendered.

package/lib/components/ChatButton/ChatButton.d.ts

@@ -4,7 +4,8 @@
  * 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 React, { type ComponentType, type FunctionComponent } from 'react';
+import React, { type ComponentProps } from 'react';
+import Button from '../Button';
 export type ChatButtonKind = 'primary' | 'secondary' | 'danger' | 'ghost' | 'tertiary';
 export type ChatButtonSize = 'sm' | 'md' | 'lg';
 export interface ChatButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
@@ -35,7 +36,7 @@ export interface ChatButtonProps extends React.ButtonHTMLAttributes<HTMLButtonEl
     /**
      * A component used to render an icon.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ComponentProps<typeof Button>['renderIcon'];
     /**
      * Specify the size of the `ChatButton`, from the following list of sizes:
      */

package/lib/components/CheckboxGroup/CheckboxGroup.d.ts

@@ -4,7 +4,8 @@
  * 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 React, { type ReactNode } from 'react';
+import PropTypes from 'prop-types';
+import { type ReactNode } from 'react';
 export interface CheckboxGroupProps {
     children?: ReactNode;
     className?: string;
@@ -28,5 +29,62 @@ export interface CustomType {
     size: string;
     kind: string;
 }
-declare const CheckboxGroup: React.FC<CheckboxGroupProps>;
+declare const CheckboxGroup: {
+    ({ children, className, decorator, helperText, invalid, invalidText, legendId, legendText, readOnly, warn, warnText, slug, orientation, ...rest }: CheckboxGroupProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide the children form elements to be rendered inside of the <fieldset>
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide a custom className to be applied to the containing <fieldset> node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * **Experimental**: Provide a decorator component to be rendered inside the `CheckboxGroup` component
+         */
+        decorator: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide text for the form group for additional help
+         */
+        helperText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify whether the form group is currently invalid
+         */
+        invalid: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the form group is in an invalid state
+         */
+        invalidText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide id for the fieldset <legend> which corresponds to the fieldset
+         * `aria-labelledby`
+         */
+        legendId: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide the text to be rendered inside of the fieldset <legend>
+         */
+        legendText: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide the orientation for how the checkbox should be displayed
+         */
+        orientation: PropTypes.Requireable<string>;
+        /**
+         * Whether the CheckboxGroup should be read-only
+         */
+        readOnly: PropTypes.Requireable<boolean>;
+        /**
+         * **Experimental**: Provide a `Slug` component to be rendered inside the `CheckboxGroup` component
+         */
+        slug: (props: Record<string, any>, propName: string, componentName: string, ...rest: any[]) => any;
+        /**
+         * Specify whether the form group is currently in warning state
+         */
+        warn: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the form group is in warning state
+         */
+        warnText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+    };
+};
 export default CheckboxGroup;

package/lib/components/ComboBox/ComboBox.d.ts

@@ -1,11 +1,11 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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 { UseComboboxProps, UseComboboxActions } from 'downshift';
-import React, { type ComponentType, type InputHTMLAttributes, type MouseEvent, type PropsWithChildren, type PropsWithRef, type ReactElement, type ReactNode, type RefAttributes } from 'react';
+import { type ComponentType, type InputHTMLAttributes, type MouseEvent, type PropsWithChildren, type ReactElement, type ReactNode, type RefAttributes, type RefObject } from 'react';
 import { type ListBoxMenuIconTranslationKey, type ListBoxSelectionTranslationKey, type ListBoxSize } from '../ListBox';
 import type { TranslateWithId } from '../../types/common';
 type ExcludedAttributes = 'id' | 'onChange' | 'onClick' | 'type' | 'size';
@@ -74,7 +74,7 @@ export interface ComboBoxProps<ItemType> extends Omit<InputHTMLAttributes<HTMLIn
      * cases they can not be shimmed by Carbon to shield you from potentially breaking
      * changes.
      */
-    downshiftActions?: React.MutableRefObject<UseComboboxActions<ItemType> | undefined>;
+    downshiftActions?: RefObject<UseComboboxActions<ItemType> | undefined>;
     /**
      * Provide helper text that is used alongside the control label for
      * additional help
@@ -196,7 +196,7 @@ export interface ComboBoxProps<ItemType> extends Omit<InputHTMLAttributes<HTMLIn
      */
     inputProps?: InputHTMLAttributes<HTMLInputElement>;
 }
-type ComboboxComponentProps<ItemType> = PropsWithRef<PropsWithChildren<ComboBoxProps<ItemType>> & RefAttributes<HTMLInputElement>>;
+type ComboboxComponentProps<ItemType> = PropsWithChildren<ComboBoxProps<ItemType>> & RefAttributes<HTMLInputElement>;
 export interface ComboBoxComponent {
     <ItemType>(props: ComboboxComponentProps<ItemType>): ReactElement<any> | null;
 }

package/lib/components/ComboBox/ComboBox.js

@@ -197,6 +197,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     // eslint-disable-next-line  react-hooks/exhaustive-deps -- https://github.com/carbon-design-system/carbon/issues/20452
   }, [typeahead, inputValue, items, itemToString, autocompleteCustomFilter]);
   const isManualClearingRef = React.useRef(false);
+  const committedCustomValueRef = React.useRef('');
   const [isClearing, setIsClearing] = React.useState(false);
   const prefix = usePrefix.usePrefix();
   const {
@@ -286,11 +287,13 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
               return changes;
             }
             const nextSelectedItem = items.find(item => itemToString(item) === inputValue) ?? inputValue;
+            const isCustomSelection = typeof nextSelectedItem === 'string' && !items.some(item => isEqual(item, nextSelectedItem));
             if (!isEqual(currentSelectedItem, nextSelectedItem) && onChange) {
               onChange({
                 selectedItem: nextSelectedItem,
                 inputValue
               });
+              committedCustomValueRef.current = isCustomSelection ? inputValue : '';
             }
             return {
               ...changes,
@@ -529,6 +532,9 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
         return;
       }
       if ((type === ItemClick || type === FunctionSelectItem || type === InputKeyDownEnter) && typeof newSelectedItem !== 'undefined' && !isEqual(selectedItemProp, newSelectedItem)) {
+        if (items.some(item => isEqual(item, newSelectedItem))) {
+          committedCustomValueRef.current = '';
+        }
         onChange({
           selectedItem: newSelectedItem
         });
@@ -538,7 +544,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
 
   // Keep the dropdown highlight in sync with either the controlled value or
   // Downshift's own selection when uncontrolled.
-  const menuSelectedItem = typeof selectedItemProp !== 'undefined' ? selectedItemProp : selectedItem;
+  const currentSelectedItem = typeof selectedItemProp !== 'undefined' ? selectedItemProp : selectedItem;
   React.useEffect(() => {
     // Used to expose the downshift actions to consumers for use with downshiftProps
     // An odd pattern, here we mutate the value stored in the ref provided from the consumer.
@@ -653,8 +659,18 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     ...inputProps,
     onChange: e => {
       const newValue = e.target.value;
+      const shouldClearSelection = allowCustomValue && committedCustomValueRef.current && inputValue === committedCustomValueRef.current && newValue === '';
       setInputValue(newValue);
       downshiftSetInputValue(newValue);
+      if (shouldClearSelection) {
+        setIsClearing(true);
+        onChange({
+          selectedItem: null,
+          inputValue: ''
+        });
+        selectItem(null);
+        committedCustomValueRef.current = '';
+      }
     },
     ref: mergeRefs.mergeRefs(textInput, ref, inputRef),
     onKeyDown: event => {
@@ -671,6 +687,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
         // manually fire it when `allowCustomValue` is provided, the menu is closing,
         // and there is a value.
         if (allowCustomValue && isOpen && inputValue && highlightedIndex === -1) {
+          committedCustomValueRef.current = inputValue;
           onChange({
             selectedItem: null,
             inputValue
@@ -735,6 +752,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
         selectedItem: null
       });
       selectItem(null);
+      committedCustomValueRef.current = '';
       handleSelectionClear();
     },
     translateWithId: translateWithId,
@@ -766,13 +784,13 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     } = itemProps;
     return /*#__PURE__*/React.createElement(index$2.default.MenuItem, _rollupPluginBabelHelpers.extends({
       key: itemProps.id,
-      isActive: isEqual(menuSelectedItem, item),
+      isActive: isEqual(currentSelectedItem, item),
       isHighlighted: highlightedIndex === index,
       title: title,
       disabled: disabled
     }, modifiedItemProps), ItemToElement ? /*#__PURE__*/React.createElement(ItemToElement, _rollupPluginBabelHelpers.extends({
       key: itemProps.id
-    }, item)) : itemToString(item), isEqual(menuSelectedItem, item) && /*#__PURE__*/React.createElement(iconsReact.Checkmark, {
+    }, item)) : itemToString(item), isEqual(currentSelectedItem, item) && /*#__PURE__*/React.createElement(iconsReact.Checkmark, {
       className: `${prefix}--list-box__menu-item__selected-icon`
     }));
   }) : null)), helperText && !invalid && !warn && !isFluid && /*#__PURE__*/React.createElement(Text.Text, {

package/lib/components/ComposedModal/ComposedModal.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2023, 2025
+ * Copyright IBM Corp. 2023, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -61,7 +61,7 @@ export interface ComposedModalProps extends HTMLAttributes<HTMLDivElement> {
      * Specify an optional handler for closing modal.
      * Returning `false` here prevents closing modal.
      */
-    onClose?(event: MouseEvent): void | boolean;
+    onClose?: ((event: MouseEvent) => boolean) | ((event: MouseEvent) => void);
     /**
      * Called for all `onKeyDown` events that do not close the modal
      */

package/lib/components/ContainedList/ContainedList.d.ts

@@ -4,12 +4,9 @@
  * 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 React, { ReactNode } from 'react';
-import ContainedListItem from './ContainedListItem';
+import { ReactNode } from 'react';
+import PropTypes from 'prop-types';
 declare const variants: readonly ["on-page", "disclosed"];
-export type ContainedListType = React.FC<ContainedListProps> & {
-    ContainedListItem: typeof ContainedListItem;
-};
 export type Variants = (typeof variants)[number];
 export interface ContainedListProps {
     /**
@@ -41,5 +38,37 @@ export interface ContainedListProps {
      */
     size?: 'sm' | 'md' | 'lg' | 'xl';
 }
-declare const ContainedList: ContainedListType;
+declare const ContainedList: {
+    ({ action, children, className, isInset, kind, label, size, ...rest }: ContainedListProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * A slot for a possible interactive element to render.
+         */
+        action: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * A collection of ContainedListItems to be rendered in the ContainedList
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Additional CSS class names.
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the dividing lines in between list items should be inset.
+         */
+        isInset: PropTypes.Requireable<boolean>;
+        /**
+         * The kind of ContainedList you want to display
+         */
+        kind: PropTypes.Requireable<"on-page" | "disclosed">;
+        /**
+         * A label describing the contained list.
+         */
+        label: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Specify the size of the contained list.
+         */
+        size: PropTypes.Requireable<string>;
+    };
+};
 export default ContainedList;

package/lib/components/ContainedList/ContainedList.js

@@ -136,6 +136,8 @@ ContainedList.propTypes = {
    */
   size: PropTypes.oneOf(['sm', 'md', 'lg', 'xl'])
 };
-ContainedList.ContainedListItem = ContainedListItem.default;
+Object.assign(ContainedList, {
+  ContainedListItem: ContainedListItem.default
+});
 
 exports.default = ContainedList;

package/lib/components/ContainedList/ContainedListItem/ContainedListItem.d.ts

@@ -4,7 +4,8 @@
  * 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 React, { type ComponentType, type FunctionComponent, ReactNode } from 'react';
+import { type ElementType, type ReactNode } from 'react';
+import PropTypes from 'prop-types';
 interface ContainedListItemProps {
     /**
      * A slot for a possible interactive element to render within the item.
@@ -29,7 +30,35 @@ interface ContainedListItemProps {
     /**
      * A component used to render an icon.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
 }
-declare const ContainedListItem: React.FC<ContainedListItemProps>;
+declare const ContainedListItem: {
+    ({ action, children, className, disabled, onClick, renderIcon: IconElement, ...rest }: ContainedListItemProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * A slot for a possible interactive element to render within the item.
+         */
+        action: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * The content of this item. Must not contain any interactive elements. Use props.action to include those.
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Additional CSS class names.
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Whether this item is disabled.
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * Provide an optional function to be called when the item is clicked.
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * A component used to render an icon.
+         */
+        renderIcon: PropTypes.Requireable<object>;
+    };
+};
 export default ContainedListItem;