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

package/lib/components/Tooltip/DefinitionTooltip.d.ts

@@ -4,6 +4,7 @@
  * 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 { PopoverAlignment } from '../Popover';
 export interface DefinitionTooltipProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'id' | 'classname' | 'children' | 'type'> {
@@ -54,5 +55,55 @@ export interface DefinitionTooltipProps extends Omit<React.ButtonHTMLAttributes<
      */
     triggerClassName?: string;
 }
-declare const DefinitionTooltip: React.FC<DefinitionTooltipProps>;
+declare const DefinitionTooltip: {
+    ({ align, autoAlign, className, children, definition, defaultOpen, id, openOnHover, tooltipText, triggerClassName, ...rest }: DefinitionTooltipProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify how the trigger should align with the tooltip
+         */
+        align: PropTypes.Requireable<string>;
+        /**
+         * Will auto-align the popover. This prop is currently experimental and is
+         * subject to future changes. Requires React v17+
+         * @see https://github.com/carbon-design-system/carbon/issues/18714
+         */
+        autoAlign: PropTypes.Requireable<boolean>;
+        /**
+         * The `children` prop will be used as the value that is being defined
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Specify an optional className to be applied to the container node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the tooltip should be open when it first renders
+         */
+        defaultOpen: PropTypes.Requireable<boolean>;
+        /**
+         * The `definition` prop is used as the content inside of the tooltip that
+         * appears when a user interacts with the element rendered by the `children`
+         * prop
+         */
+        definition: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide a value that will be assigned as the id of the tooltip
+         */
+        id: PropTypes.Requireable<string>;
+        /**
+         * Specifies whether or not the `DefinitionTooltip` should open on hover or not
+         */
+        openOnHover: PropTypes.Requireable<boolean>;
+        /**
+         * [Deprecated in v11] Please use the `definition` prop instead.
+         *
+         * Provide the text that will be displayed in the tooltip when it is rendered.
+         */
+        tooltipText: (props: Record<string, any>, propName: string, componentName: string, ...rest: any[]) => any;
+        /**
+         * The CSS class name of the trigger element
+         */
+        triggerClassName: PropTypes.Requireable<string>;
+    };
+};
 export { DefinitionTooltip };

package/lib/components/Tooltip/Tooltip.js

@@ -189,6 +189,8 @@ const Tooltip = /*#__PURE__*/React.forwardRef(({
     }, label || description))
   );
 });
+
+// @ts-expect-error - `propTypes` isn't typed.
 Tooltip.propTypes = {
   /**
    * Specify how the trigger should align with the tooltip

package/lib/components/TreeView/TreeNode.d.ts

@@ -1,10 +1,10 @@
 /**
- * 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 React, { type ComponentType, type FunctionComponent } from 'react';
+import React, { type ElementType } from 'react';
 type UncontrolledOnToggle = (event: React.MouseEvent | React.KeyboardEvent, node: Pick<TreeNodeProps, 'id' | 'label' | 'value' | 'isExpanded'>) => void;
 type ControlledOnToggle = (isExpanded: TreeNodeProps['isExpanded']) => void;
 export type TreeNodeProps = {
@@ -78,7 +78,7 @@ export type TreeNodeProps = {
     /**
      * A component used to render an icon.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
     /**
      * **Note:** this is controlled by the parent TreeView component, do not set manually.
      * Array containing all selected node IDs in the tree
@@ -178,7 +178,7 @@ declare const TreeNode: React.ForwardRefExoticComponent<{
     /**
      * A component used to render an icon.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
     /**
      * **Note:** this is controlled by the parent TreeView component, do not set manually.
      * Array containing all selected node IDs in the tree

package/lib/components/UIShell/Header.d.ts

@@ -1,10 +1,11 @@
 /**
- * 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 React, { ReactNode } from 'react';
+import PropTypes from 'prop-types';
+import { ReactNode } from 'react';
 export interface HeaderProps {
     children?: ReactNode;
     /**
@@ -20,5 +21,21 @@ export interface HeaderProps {
      */
     className?: string;
 }
-declare const Header: React.FC<HeaderProps>;
+declare const Header: {
+    ({ className: customClassName, children, ...rest }: HeaderProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Optionally provide aria-label
+         */
+        'aria-label': PropTypes.Requireable<string>;
+        /**
+         * Optionally provide aria-labelledby
+         */
+        'aria-labelledby': PropTypes.Requireable<string>;
+        /**
+         * Optionally provide a custom class name that is applied to the underlying header
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default Header;

package/lib/components/UIShell/HeaderGlobalAction.d.ts

@@ -1,5 +1,5 @@
 /**
- * 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.
@@ -55,5 +55,5 @@ export interface HeaderGlobalActionProps {
  *
  * Note: children passed to this component should be an Icon.
  */
-declare const HeaderGlobalAction: React.FC<HeaderGlobalActionProps>;
+declare const HeaderGlobalAction: React.ForwardRefExoticComponent<HeaderGlobalActionProps & React.RefAttributes<HTMLButtonElement>>;
 export default HeaderGlobalAction;

package/lib/components/UIShell/HeaderName.js

@@ -28,7 +28,7 @@ function HeaderName({
     className: className
   }), prefix && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
     className: `${selectorPrefix}--header__name--prefix`
-  }, prefix), "\xA0"), children);
+  }, prefix), "\xA0"), /*#__PURE__*/React.createElement("span", null, children));
 }
 HeaderName.propTypes = {
   /**

package/lib/components/UIShell/Link.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/UIShell/Link.js

@@ -16,24 +16,24 @@ var deprecate = require('../../prop-types/deprecate.js');
 
 // First define the component without generics
 
-const LinkBase = ({
-  element,
-  as: BaseComponent,
-  // Captured here to prevent it from being passed into the created element.
-  // See https://github.com/carbon-design-system/carbon/issues/3970
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452
-  isSideNavExpanded: _isSideNavExpanded,
-  ...rest
-}, ref) => {
+const frFn = React.forwardRef;
+const Link = frFn((props, ref) => {
+  const {
+    element,
+    as: BaseComponent,
+    // Captured here to prevent it from being passed into the created element.
+    // See https://github.com/carbon-design-system/carbon/issues/3970
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452
+    isSideNavExpanded: _isSideNavExpanded,
+    ...rest
+  } = props;
+
   // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
   const BaseComponentAsAny = BaseComponent ?? element ?? 'a';
   return /*#__PURE__*/React.createElement(BaseComponentAsAny, _rollupPluginBabelHelpers.extends({
     ref: ref
   }, rest));
-};
-
-// Use forwardRef with the non-generic function
-const Link = /*#__PURE__*/React.forwardRef(LinkBase);
+});
 
 /**
  * Link is a custom component that allows us to supporting rendering elements

package/lib/components/UIShell/SideNav.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.
@@ -9,7 +9,7 @@ export interface SideNavProps {
     expanded?: boolean | undefined;
     defaultExpanded?: boolean | undefined;
     isChildOfHeader?: boolean | undefined;
-    onToggle?: (event: FocusEvent<HTMLElement> | KeyboardEvent<HTMLElement> | boolean, value: boolean) => void | undefined;
+    onToggle?: (event: FocusEvent<HTMLElement> | KeyboardEvent<HTMLElement> | boolean, value: boolean) => void;
     href?: string | undefined;
     isFixedNav?: boolean | undefined;
     isRail?: boolean | undefined;
@@ -17,7 +17,7 @@ export interface SideNavProps {
     addFocusListeners?: boolean | undefined;
     addMouseListeners?: boolean | undefined;
     onOverlayClick?: MouseEventHandler<HTMLDivElement> | undefined;
-    onSideNavBlur?: () => void | undefined;
+    onSideNavBlur?: () => void;
     enterDelayMs?: number;
     inert?: boolean;
 }

package/lib/components/UIShell/SideNav.js

@@ -28,28 +28,30 @@ var useMatchMedia = require('../../internal/useMatchMedia.js');
 // import SideNavFooter from './SideNavFooter';
 
 const SideNavContext = /*#__PURE__*/React.createContext({});
-function SideNavRenderFunction({
-  expanded: expandedProp,
-  defaultExpanded = false,
-  isChildOfHeader = true,
-  'aria-label': ariaLabel,
-  'aria-labelledby': ariaLabelledBy,
-  children,
-  onToggle,
-  className: customClassName,
-  // TO-DO: comment back in when footer is added for rails
-  // translateById: t = (id) => translations[id],
-  href,
-  isFixedNav = false,
-  isRail,
-  isPersistent = true,
-  addFocusListeners = true,
-  addMouseListeners = true,
-  onOverlayClick,
-  onSideNavBlur,
-  enterDelayMs = 100,
-  ...other
-}, ref) {
+const frFn = React.forwardRef;
+const SideNav = frFn((props, ref) => {
+  const {
+    expanded: expandedProp,
+    defaultExpanded = false,
+    isChildOfHeader = true,
+    'aria-label': ariaLabel,
+    'aria-labelledby': ariaLabelledBy,
+    children,
+    onToggle,
+    className: customClassName,
+    // TO-DO: comment back in when footer is added for rails
+    // translateById: t = (id) => translations[id],
+    href,
+    isFixedNav = false,
+    isRail,
+    isPersistent = true,
+    addFocusListeners = true,
+    addMouseListeners = true,
+    onOverlayClick,
+    onSideNavBlur,
+    enterDelayMs = 100,
+    ...other
+  } = props;
   const prefix = usePrefix.usePrefix();
   const {
     current: controlled
@@ -175,8 +177,7 @@ function SideNavRenderFunction({
     className: `${prefix}--side-nav__navigation ${className}`,
     inert: !isRail ? !(expanded || isLg) : undefined
   }, accessibilityLabel, eventHandlers, other), childrenToRender));
-}
-const SideNav = /*#__PURE__*/React.forwardRef(SideNavRenderFunction);
+});
 SideNav.displayName = 'SideNav';
 SideNav.propTypes = {
   /**

package/lib/components/UIShell/SideNavDivider.d.ts

@@ -1,15 +1,23 @@
 /**
- * Copyright IBM Corp. 2021
+ * Copyright IBM Corp. 2021, 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 React from 'react';
+import PropTypes from 'prop-types';
 interface SideNavDividerProps {
     /**
      * Provide an optional class to be applied to the containing node
      */
     className?: string;
 }
-declare const SideNavDivider: React.FC<SideNavDividerProps>;
+declare const SideNavDivider: {
+    ({ className }: SideNavDividerProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default SideNavDivider;

package/lib/components/UIShell/SideNavHeader.d.ts

@@ -4,6 +4,7 @@
  * 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';
 export interface SideNavHeaderProps {
     /**
@@ -24,5 +25,27 @@ export interface SideNavHeaderProps {
      */
     renderIcon: React.ComponentType;
 }
-declare const SideNavHeader: React.FC<SideNavHeaderProps>;
+declare const SideNavHeader: {
+    ({ children, className: customClassName, renderIcon: IconElement, }: SideNavHeaderProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+    propTypes: {
+        /**
+         * The child nodes to be rendered
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Property to indicate if the side nav container is open (or not). Use to
+         * keep local state and styling in step with the SideNav expansion state.
+         */
+        isSideNavExpanded: PropTypes.Requireable<boolean>;
+        /**
+         * A component used to render an icon.
+         */
+        renderIcon: PropTypes.Validator<object>;
+    };
+};
 export default SideNavHeader;

package/lib/components/UIShell/SideNavIcon.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';
 export interface SideNavIconProps {
     /**
@@ -21,5 +22,22 @@ export interface SideNavIconProps {
      */
     small?: boolean;
 }
-declare const SideNavIcon: React.FC<SideNavIconProps>;
+declare const SideNavIcon: {
+    ({ children, className: customClassName, small, }: SideNavIconProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide a single icon as the child to `SideNavIcon` to render in the
+         * container
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the icon should be placed in a smaller bounding box
+         */
+        small: PropTypes.Requireable<boolean>;
+    };
+};
 export default SideNavIcon;

package/lib/components/UIShell/SideNavItem.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';
 export interface SideNavItemProps {
     /**
@@ -20,5 +21,22 @@ export interface SideNavItemProps {
      */
     large?: boolean;
 }
-declare const SideNavItem: React.FC<SideNavItemProps>;
+declare const SideNavItem: {
+    ({ className: customClassName, children, large, }: SideNavItemProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide a single icon as the child to `SideNavItem` to render in the
+         * container
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify if this is a large variation of the SideNavItem
+         */
+        large: PropTypes.Requireable<boolean>;
+    };
+};
 export default SideNavItem;

package/lib/components/UIShell/SideNavItems.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';
 export interface SideNavItemsProps {
     /**
@@ -21,5 +22,24 @@ export interface SideNavItemsProps {
      */
     isSideNavExpanded?: boolean;
 }
-declare const SideNavItems: React.FC<SideNavItemsProps>;
+declare const SideNavItems: {
+    ({ className: customClassName, children, isSideNavExpanded, }: SideNavItemsProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+    propTypes: {
+        /**
+         * Provide a single icon as the child to `SideNavIcon` to render in the
+         * container
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Property to indicate if the side nav container is open (or not). Use to
+         * keep local state and styling in step with the SideNav expansion state.
+         */
+        isSideNavExpanded: PropTypes.Requireable<boolean>;
+    };
+};
 export default SideNavItems;

package/lib/components/UIShell/SideNavLink.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/UIShell/SideNavLink.js

@@ -22,16 +22,18 @@ var SideNav = require('./SideNav.js');
 
 // First define a non-generic base component to work with forwardRef
 
-const SideNavLinkBase = ({
-  children,
-  className: customClassName,
-  renderIcon: IconElement,
-  isActive,
-  isSideNavExpanded,
-  large = false,
-  tabIndex,
-  ...rest
-}, ref) => {
+const frFn = React.forwardRef;
+const SideNavLink = frFn((props, ref) => {
+  const {
+    children,
+    className: customClassName,
+    renderIcon: IconElement,
+    isActive,
+    isSideNavExpanded,
+    large = false,
+    tabIndex,
+    ...rest
+  } = props;
   const isRail = React.useContext(SideNav.SideNavContext);
   const prefix = usePrefix.usePrefix();
   const className = cx({
@@ -48,10 +50,8 @@ const SideNavLinkBase = ({
   }), IconElement && /*#__PURE__*/React.createElement(SideNavIcon.default, {
     small: true
   }, /*#__PURE__*/React.createElement(IconElement, null)), /*#__PURE__*/React.createElement(SideNavLinkText.default, null, children)));
-};
-
-// Use forwardRef with the non-generic function and cast to the generic component type
-const SideNavLink = /*#__PURE__*/React.forwardRef(SideNavLinkBase);
+  // Cast preserves the generic call signature for consumers after forwardRef.
+});
 SideNavLink.displayName = 'SideNavLink';
 SideNavLink.propTypes = {
   ...Link.LinkPropTypes,

package/lib/components/UIShell/SideNavMenu.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/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/lib/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/lib/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/lib/internal/FloatingMenu.js

@@ -174,8 +174,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/lib/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/lib/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/lib/internal/useNoInteractiveChildren.js

@@ -10,13 +10,12 @@
 var React = require('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
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node) {
@@ -30,13 +29,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
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node && !node.hasAttribute('aria-describedby')) {