@carbon/react 1.101.0-rc.0 → 1.102.0-rc.0

package/es/components/Tabs/Tabs.js

@@ -848,8 +848,8 @@ const Tab = /*#__PURE__*/forwardRef(({
     if (tabRef.current && tabRef.current.parentElement) {
       // determine number of tabs, excluding disabled
       const tabCount = Array.from(tabRef.current.parentElement.childNodes).filter(node => {
-        const element = node;
-        return element.classList.contains(`${prefix}--tabs__nav-link`) && !element.classList.contains(`${prefix}--tabs__nav-item--disabled`);
+        if (!(node instanceof HTMLElement)) return false;
+        return node.classList.contains(`${prefix}--tabs__nav-link`) && !node.classList.contains(`${prefix}--tabs__nav-item--disabled`);
       }).length;
 
       // if not removing last tab focus on next tab
@@ -859,7 +859,10 @@ const Tab = /*#__PURE__*/forwardRef(({
       // if removing last tab focus on previous tab
       else {
         const prevTabIndex = (tabCount - 2) * 2;
-        tabRef.current.parentElement.childNodes[prevTabIndex]?.focus();
+        const previousTab = tabRef.current.parentElement.childNodes[prevTabIndex];
+        if (previousTab instanceof HTMLElement) {
+          previousTab.focus();
+        }
       }
     }
   };
@@ -1160,7 +1163,9 @@ function TabPanels({
       // set max height to TabList
       const heights = refs.current.map(ref => ref?.offsetHeight || 0);
       const max = Math.max(...heights);
-      tabContainer.style.height = max + 'px';
+      if (tabContainer instanceof HTMLElement) {
+        tabContainer.style.height = max + 'px';
+      }
 
       // re-hide hidden Tab Panels
       refs.current.forEach((ref, index) => {

package/es/components/Tag/DismissibleTag.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/components/Tag/DismissibleTag.js

@@ -45,8 +45,8 @@ const DismissibleTag = /*#__PURE__*/forwardRef(({
 }, forwardRef) => {
   const prefix = usePrefix();
   const tagLabelRef = useRef(null);
-  // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
-  const tagId = id || `tag-${useId()}`;
+  const generatedTagId = useId();
+  const tagId = id ?? `tag-${generatedTagId}`;
   const tagClasses = cx(`${prefix}--tag--filter`, className);
   const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
   useIsomorphicEffect(() => {

package/es/components/Tag/OperationalTag.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/components/Tag/OperationalTag.js

@@ -45,8 +45,8 @@ const OperationalTag = /*#__PURE__*/forwardRef(({
 }, forwardRef) => {
   const prefix = usePrefix();
   const tagRef = useRef(null);
-  // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
-  const tagId = id || `tag-${useId()}`;
+  const generatedTagId = useId();
+  const tagId = id ?? `tag-${generatedTagId}`;
   const tagClasses = cx(`${prefix}--tag--operational`, className);
   const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
   useIsomorphicEffect(() => {

package/es/components/Tag/SelectableTag.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/components/Tag/SelectableTag.js

@@ -37,8 +37,8 @@ const SelectableTag = /*#__PURE__*/forwardRef(({
 }, forwardRef) => {
   const prefix = usePrefix();
   const tagRef = useRef(null);
-  // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
-  const tagId = id || `tag-${useId()}`;
+  const generatedTagId = useId();
+  const tagId = id ?? `tag-${generatedTagId}`;
   const [selectedTag, setSelectedTag] = useControllableState({
     value: selected,
     onChange: onChange,

package/es/components/Tag/Tag.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/components/Tag/Tag.js

@@ -74,8 +74,8 @@ const TagBase = /*#__PURE__*/React.forwardRef(({
     console.warn('The `onClose` prop for Tag has been deprecated and will be removed in the next major version. Use DismissibleTag instead.');
   }
   const ref = useMergedRefs([forwardRef, tagRef]);
-  // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
-  const tagId = id || `tag-${useId()}`;
+  const generatedTagId = useId();
+  const tagId = id ?? `tag-${generatedTagId}`;
   const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
   useIsomorphicEffect(() => {
     const newElement = tagRef.current?.getElementsByClassName(`${prefix}--tag__label`)[0];

package/es/components/TextArea/TextArea.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.
@@ -7,8 +7,7 @@
 import React, { type ReactNode } from 'react';
 export interface TextAreaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
     /**
-     * Provide a custom className that is applied directly to the underlying
-     * `<textarea>` node
+     * Provide a custom className that is applied to the wrapper node
      */
     className?: string;
     /**

package/es/components/TextArea/TextArea.js

@@ -38,7 +38,7 @@ const TextArea = frFn((props, forwardRef) => {
     onKeyDown = noopFn,
     invalid = false,
     invalidText = '',
-    helperText = '',
+    helperText,
     light,
     placeholder = '',
     enableCounter = false,
@@ -239,7 +239,7 @@ const TextArea = frFn((props, forwardRef) => {
     ariaDescribedBy = warnId;
   } else {
     const ids = [];
-    if (!isFluid && helperText && helperId) ids.push(helperId);
+    if (!isFluid && hasHelper && helperId) ids.push(helperId);
     if (counterDescriptionId) ids.push(counterDescriptionId);
     ariaDescribedBy = ids.length > 0 ? ids.join(' ') : undefined;
   }
@@ -278,7 +278,7 @@ const TextArea = frFn((props, forwardRef) => {
   }, [ariaAnnouncement, prevAnnouncement, counterMode]);
   const input = /*#__PURE__*/React.createElement("textarea", _extends({}, other, textareaProps, {
     placeholder: placeholder,
-    "aria-readonly": other.readOnly ? true : false,
+    "aria-readonly": other.readOnly,
     className: textareaClasses,
     "aria-invalid": invalid,
     "aria-describedby": ariaDescribedBy,
@@ -324,8 +324,7 @@ const TextArea = frFn((props, forwardRef) => {
 TextArea.displayName = 'TextArea';
 TextArea.propTypes = {
   /**
-   * Provide a custom className that is applied directly to the underlying
-   * `<textarea>` node
+   * Provide a custom className that is applied to the wrapper node
    */
   className: PropTypes.string,
   /**

package/es/components/TextInput/ControlledPasswordInput.js

@@ -27,7 +27,7 @@ const ControlledPasswordInput = /*#__PURE__*/forwardRef(({
   hideLabel,
   invalid = false,
   invalidText = '',
-  helperText = '',
+  helperText,
   light,
   type = 'password',
   togglePasswordVisibility,

package/es/components/TimePickerSelect/TimePickerSelect.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 from 'react';
+import React, { type SelectHTMLAttributes } from 'react';
 export type TimePickerSelectProps = {
     /**
      * Provide the contents of your TimePickerSelect
@@ -17,7 +17,7 @@ export type TimePickerSelectProps = {
     /**
      * Optionally provide the default value of the `<select>`
      */
-    defaultValue?: any;
+    defaultValue?: SelectHTMLAttributes<HTMLSelectElement>['defaultValue'];
     /**
      * Specify whether the control is disabled
      */
@@ -39,7 +39,7 @@ declare const TimePickerSelect: React.ForwardRefExoticComponent<{
     /**
      * Optionally provide the default value of the `<select>`
      */
-    defaultValue?: any;
+    defaultValue?: SelectHTMLAttributes<HTMLSelectElement>["defaultValue"];
     /**
      * Specify whether the control is disabled
      */

package/es/components/Toggletip/index.js

@@ -134,8 +134,7 @@ function Toggletip({
     const eventType = 'PointerEvent' in window ? 'pointerdown' : 'mousedown';
     const handleOutsideClick = event => {
       const node = event.target;
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- https://github.com/carbon-design-system/carbon/issues/20452
-      if (open && node && !ref.current.contains(node)) {
+      if (open && node && !ref.current?.contains(node)) {
         setOpen(false);
       }
     };

package/es/components/TreeView/TreeNode.js

@@ -241,7 +241,7 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
           return node;
         }
         if (node.classList.contains(`${prefix}--tree-node-link-parent`)) {
-          return node.firstChild;
+          return node.firstElementChild;
         }
         if (node.classList.contains(`${prefix}--tree`)) {
           return null;
@@ -263,7 +263,7 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
          * When focus is on a leaf node or a closed parent node, move focus to
          * its parent node (unless its depth is level 1)
          */
-        const parentNode = findParentTreeNode(href ? currentNode.current?.parentElement?.parentElement : currentNode.current?.parentElement);
+        const parentNode = findParentTreeNode((href ? currentNode.current?.parentElement?.parentElement : currentNode.current?.parentElement) ?? null);
         if (parentNode instanceof HTMLElement) {
           parentNode.focus();
         }

package/es/components/TreeView/TreeView.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/components/UIShell/HeaderPanel.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/components/UIShell/HeaderPanel.js

@@ -59,8 +59,10 @@ const HeaderPanel = /*#__PURE__*/React.forwardRef(({
     };
   }
   useWindowEvent('click', event => {
-    const target = event.target;
-    if (!(target instanceof HTMLElement)) return;
+    const {
+      target
+    } = event;
+    if (!(target instanceof Element)) return;
     setLastClickedElement(target);
     const isChildASwitcher = /*#__PURE__*/isValidElement(children) && typeof children.type !== 'string' && children.type === Switcher;
     if (isChildASwitcher && !target.closest(`.${prefix}--header-panel--expanded`) && !target.closest(`.${prefix}--header__action`) && !headerPanelReference?.current?.classList.contains(`${prefix}--switcher`) && expanded) {

package/es/components/UIShell/SideNav.js

@@ -20,7 +20,7 @@ import { useDelayedState } from '../../internal/useDelayedState.js';
 import { breakpoints } from '@carbon/layout';
 import { useMatchMedia } from '../../internal/useMatchMedia.js';
 
-// TO-DO: comment back in when footer is added for rails
+// TODO: comment back in when footer is added for rails
 // import SideNavFooter from './SideNavFooter';
 
 const SideNavContext = /*#__PURE__*/createContext({});
@@ -35,7 +35,7 @@ const SideNav = frFn((props, ref) => {
     children,
     onToggle,
     className: customClassName,
-    // TO-DO: comment back in when footer is added for rails
+    // TODO: comment back in when footer is added for rails
     // translateById: t = (id) => translations[id],
     href,
     isFixedNav = false,
@@ -73,7 +73,7 @@ const SideNav = frFn((props, ref) => {
     'aria-labelledby': ariaLabelledBy
   };
 
-  // TO-DO: comment back in when footer is added for rails
+  // TODO: comment back in when footer is added for rails
   // const assistiveText = expanded
   //   ? t('carbon.sidenav.state.open')
   //   : t('carbon.sidenav.state.closed');

package/es/components/UIShell/Switcher.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/components/UIShell/Switcher.js

@@ -61,7 +61,7 @@ const Switcher = /*#__PURE__*/forwardRef((props, forwardRef) => {
       }
     })();
     const switcherItem = switcherRef.current?.children[nextValidIndex]?.children[0];
-    if (switcherItem) {
+    if (switcherItem instanceof HTMLElement) {
       switcherItem.focus();
     }
   };

package/es/feature-flags.js

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import * as FeatureFlags from '@carbon/feature-flags';
+import { merge } from '@carbon/feature-flags';
 
-FeatureFlags.merge({
+merge({
   'enable-css-custom-properties': true,
   'enable-css-grid': true,
   'enable-v11-release': true,

package/es/internal/FloatingMenu.js

@@ -6,7 +6,7 @@
  */
 
 import React, { useContext, useState, useRef, useCallback, useEffect, cloneElement } from 'react';
-import * as FeatureFlags from '@carbon/feature-flags';
+import { enabled } from '@carbon/feature-flags';
 import ReactDOM from 'react-dom';
 import { Tab } from './keyboard/keys.js';
 import { match } from './keyboard/match.js';
@@ -274,8 +274,8 @@ const FloatingMenu = ({
       });
     }
   };
-  const deprecatedFlag = FeatureFlags.enabled('enable-experimental-focus-wrap-without-sentinels');
-  const focusTrapWithoutSentinelsFlag = FeatureFlags.enabled('enable-focus-wrap-without-sentinels');
+  const deprecatedFlag = enabled('enable-experimental-focus-wrap-without-sentinels');
+  const focusTrapWithoutSentinelsFlag = enabled('enable-focus-wrap-without-sentinels');
   const focusTrapWithoutSentinels = deprecatedFlag || focusTrapWithoutSentinelsFlag;
   if (typeof document !== 'undefined') {
     const portalTarget = target ? target() : document.body;

package/lib/components/Accordion/AccordionItem.js

@@ -41,7 +41,7 @@ function AccordionItem({
   ...rest
 }) {
   const [isOpen, setIsOpen] = React.useState(open);
-  const [prevIsOpen, setPrevIsOpen] = React.useState(open);
+  const prevOpenRef = React.useRef(open);
   const accordionState = React.useContext(AccordionProvider.AccordionContext);
   const disabledIsControlled = typeof controlledDisabled === 'boolean';
   const disabled = disabledIsControlled ? controlledDisabled : accordionState.disabled;
@@ -64,10 +64,12 @@ function AccordionItem({
       node.style.maxBlockSize = '';
     }
   }, [isOpen]);
-  if (open !== prevIsOpen) {
-    setIsOpen(open);
-    setPrevIsOpen(open);
-  }
+  React.useEffect(() => {
+    if (open !== prevOpenRef.current) {
+      setIsOpen(open);
+      prevOpenRef.current = open;
+    }
+  }, [open]);
 
   // When the AccordionItem heading is clicked, toggle the open state of the
   // panel

package/lib/components/ComboBox/ComboBox.js

@@ -149,7 +149,8 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     middleware: autoAlign ? [react.flip(), react.hide()] : undefined,
     whileElementsMounted: react.autoUpdate
   } : {});
-  const parentWidth = refs?.reference?.current?.clientWidth;
+  const referenceElement = refs?.reference?.current;
+  const parentWidth = referenceElement instanceof HTMLElement ? referenceElement.clientWidth : undefined;
   React.useEffect(() => {
     if (enableFloatingStyles) {
       const updatedFloatingStyles = {
@@ -503,10 +504,9 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     onHighlightedIndexChange: ({
       highlightedIndex
     }) => {
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion , valid-typeof , no-constant-binary-expression -- https://github.com/carbon-design-system/carbon/issues/20452
+      // eslint-disable-next-line valid-typeof , no-constant-binary-expression -- https://github.com/carbon-design-system/carbon/issues/20452
       if (highlightedIndex > -1 && typeof window !== undefined) {
         const itemArray = document.querySelectorAll(`li.${prefix}--list-box__menu-item[role="option"]`);
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- https://github.com/carbon-design-system/carbon/issues/20452
         const highlightedItem = itemArray[highlightedIndex];
         if (highlightedItem) {
           highlightedItem.scrollIntoView({
@@ -785,15 +785,20 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     const {
       'aria-disabled': unusedAriaDisabled,
       // eslint-disable-line @typescript-eslint/no-unused-vars
+      'aria-selected': unusedAriaSelected,
+      // eslint-disable-line @typescript-eslint/no-unused-vars
       ...modifiedItemProps
     } = itemProps;
+    const isSelected = isEqual(currentSelectedItem, item);
     return /*#__PURE__*/React.createElement(index$2.default.MenuItem, _rollupPluginBabelHelpers.extends({
       key: itemProps.id,
-      isActive: isEqual(currentSelectedItem, item),
+      isActive: isSelected,
       isHighlighted: highlightedIndex === index,
       title: title,
       disabled: disabled
-    }, modifiedItemProps), itemToElement ? itemToElement(item) : itemToString(item), isEqual(currentSelectedItem, item) && /*#__PURE__*/React.createElement(iconsReact.Checkmark, {
+    }, modifiedItemProps, {
+      "aria-selected": isSelected
+    }), itemToElement ? itemToElement(item) : itemToString(item), isSelected && /*#__PURE__*/React.createElement(iconsReact.Checkmark, {
       className: `${prefix}--list-box__menu-item__selected-icon`
     }));
   }) : null)), helperText && !normalizedProps.invalid && !normalizedProps.warn && !isFluid && /*#__PURE__*/React.createElement(Text.Text, {

package/lib/components/ComposedModal/ComposedModal.js

@@ -200,7 +200,6 @@ const ComposedModalDialog = /*#__PURE__*/React.forwardRef(function ComposedModal
       target
     } = evt;
     const mouseDownTarget = onMouseDownTarget.current;
-    evt.stopPropagation();
     const shouldCloseOnOutsideClick =
     // Passive modals can close on clicks outside the modal when
     // preventCloseOnClickOutside is undefined or explicitly set to false.

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

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2022, 2025
+ * Copyright IBM Corp. 2022, 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/ContainedList/ContainedList.js

@@ -14,36 +14,25 @@ var React = require('react');
 var PropTypes = require('prop-types');
 var cx = require('classnames');
 var index = require('../Layout/index.js');
+var utils = require('../../internal/utils.js');
 var useId = require('../../internal/useId.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var ContainedListItem = require('./ContainedListItem/ContainedListItem.js');
+var ExpandableSearch = require('../ExpandableSearch/ExpandableSearch.js');
 var Search = require('../Search/Search.js');
 require('../Search/Search.Skeleton.js');
 
 const variants = ['on-page', 'disclosed'];
-function filterChildren(children) {
+const isSearchComponent = node => utils.isComponentElement(node, Search.default) || utils.isComponentElement(node, ExpandableSearch.default);
+const filterChildren = children => {
   if (Array.isArray(children)) {
-    return children?.filter(child => !['Search', 'ExpandableSearch'].includes(child?.type?.displayName));
+    return children.filter(child => !isSearchComponent(child));
   }
-  if (children && !['Search', 'ExpandableSearch'].includes(children?.type?.displayName)) {
+  if (children && !isSearchComponent(children)) {
     return children;
   }
   return null;
-}
-function renderChildren(children) {
-  if (Array.isArray(children)) {
-    children.map((child, index) => {
-      if (index === 0 && child.type === Search.default) {
-        return child;
-      }
-      return child;
-    });
-  }
-  if (children && children.type === Search.default) {
-    return children;
-  }
-  return children;
-}
+};
 const ContainedList = ({
   action,
   children,
@@ -63,21 +52,7 @@ const ContainedList = ({
     [`${prefix}--layout--size-${size}`]: size
   }, `${prefix}--contained-list--${kind}`, className);
   const filteredChildren = filterChildren(children);
-  function isSearchAction(action) {
-    if (! /*#__PURE__*/React.isValidElement(action)) {
-      return false;
-    }
-    const actionTypes = ['Search', 'ExpandableSearch'];
-    let actionType = '';
-    if (typeof action.type === 'string') {
-      actionType = action.type;
-    } else {
-      actionType = action.type.displayName || '';
-    }
-    return actionTypes.includes(actionType);
-  }
-  const isActionSearch = isSearchAction(action);
-  const renderedChildren = renderChildren(children);
+  const isActionSearch = isSearchComponent(action);
   return /*#__PURE__*/React.createElement("div", _rollupPluginBabelHelpers.extends({
     className: classes
   }, rest), label && /*#__PURE__*/React.createElement("div", {
@@ -104,7 +79,7 @@ const ContainedList = ({
   React.createElement("ul", {
     role: "list",
     "aria-labelledby": label ? labelId : undefined
-  }, isActionSearch ? filteredChildren : renderedChildren));
+  }, isActionSearch ? filteredChildren : children));
 };
 ContainedList.propTypes = {
   /**

package/lib/components/ContentSwitcher/ContentSwitcher.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.
@@ -35,7 +35,7 @@ export interface ContentSwitcherProps extends Omit<HTMLAttributes<HTMLElement>,
     /**
      * Specify a selected index for the initially selected content
      */
-    selectedIndex: number;
+    selectedIndex?: number;
     /**
      * Choose whether or not to automatically change selection on focus when left/right arrow pressed. Defaults to 'automatic'
      */
@@ -43,7 +43,7 @@ export interface ContentSwitcherProps extends Omit<HTMLAttributes<HTMLElement>,
     /**
      * Specify the size of the Content Switcher. Currently supports either `sm`, `md` (default) or `lg` as an option.
      */
-    size: 'sm' | 'md' | 'lg';
+    size?: 'sm' | 'md' | 'lg';
 }
 export declare const ContentSwitcher: {
     ({ children, className, light, lowContrast, selectedIndex: selectedIndexProp, selectionMode, size, onChange, ...other }: ContentSwitcherProps): import("react/jsx-runtime").JSX.Element;

package/lib/components/ContentSwitcher/ContentSwitcher.js

@@ -18,7 +18,6 @@ var keys = require('../../internal/keyboard/keys.js');
 var match = require('../../internal/keyboard/match.js');
 var navigation = require('../../internal/keyboard/navigation.js');
 var usePrefix = require('../../internal/usePrefix.js');
-var noopFn = require('../../internal/noopFn.js');
 require('../Switch/Switch.js');
 var IconSwitch = require('../Switch/IconSwitch.js');
 
@@ -30,7 +29,7 @@ const ContentSwitcher = ({
   selectedIndex: selectedIndexProp = 0,
   selectionMode = 'automatic',
   size,
-  onChange = noopFn.noopFn,
+  onChange,
   ...other
 }) => {
   const prefix = React.useContext(usePrefix.PrefixContext);

package/lib/components/DataTable/DataTable.d.ts

@@ -5,9 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import PropTypes from 'prop-types';
-import React, { type ChangeEvent, type MouseEvent, type ReactElement, type ReactNode } from 'react';
+import React, { type MouseEvent, type ReactElement, type ReactNode } from 'react';
 import { type SortRowFn } from './state/sorting';
 import type { DataTableSortState } from './state/sortStates';
+import { type TableToolbarSearchOnChangeEvent } from './TableToolbarSearch';
 import type { TranslateWithId } from '../../types/common';
 declare const translationIds: {
     readonly 'carbon.table.row.expand': "carbon.table.row.expand";
@@ -169,8 +170,11 @@ export interface DataTableRenderProps<RowType, ColTypes extends any[]> {
     };
     /**
      * Handles input value changes.
+     *
+     * Note: the `''` event sentinel is supported for compatibility with
+     * `TableToolbarSearch` and should be removed in the next major release.
      */
-    onInputChange: (event: ChangeEvent<HTMLInputElement>, defaultValue?: string) => void;
+    onInputChange: (event: TableToolbarSearchOnChangeEvent, defaultValue?: string) => void;
     /**
      * Sorts the table by a specific header.
      */

package/lib/components/DataTable/DataTable.js

@@ -518,7 +518,9 @@ const DataTable = props => {
    * Event handler for table filter input changes.
    */
   const handleOnInputValueChange = (event, defaultValue) => {
-    const value = defaultValue || event.target?.value;
+    // TODO: Remove `''` sentinel support once `TableToolbarSearch` no
+    // longer emits it on mount.
+    const value = defaultValue ?? (event === '' ? event : event.target.value);
     setState(prev => ({
       ...prev,
       filterInputValue: value

package/lib/components/DataTable/Table.js

@@ -95,7 +95,7 @@ const Table = ({
         const isBodyMultiline = Array.from(tableRef.current.querySelectorAll('td')).some(td => isElementWrappingContent(td, context));
         const isHeaderMultiline = Array.from(tableRef.current.querySelectorAll('th')).some(th => {
           const label = th.querySelector(`.${prefix}--table-header-label`);
-          return label && isElementWrappingContent(label, context);
+          return label instanceof HTMLElement && isElementWrappingContent(label, context);
         });
         toggleTableBodyAlignmentClass(isBodyMultiline);
         toggleTableHeaderAlignmentClass(isHeaderMultiline);

package/lib/components/DataTable/TableToolbarSearch.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.
@@ -15,6 +15,12 @@ declare const translationIds: {
 type TranslationKey = keyof typeof translationIds;
 type ExcludedInheritedProps = 'defaultValue' | 'labelText' | 'onBlur' | 'onChange' | 'onExpand' | 'onFocus' | 'tabIndex';
 export type TableToolbarSearchHandleExpand = (event: FocusEvent<HTMLInputElement>, newValue?: boolean) => void;
+/**
+ * @deprecated Passing `''` as the event sentinel is legacy compatibility
+ * behavior for `DataTable` filtering. In the next major release, this type
+ * should become an optional `ChangeEvent<HTMLInputElement>` instead.
+ */
+export type TableToolbarSearchOnChangeEvent = '' | ChangeEvent<HTMLInputElement>;
 export interface TableToolbarSearchProps extends Omit<SearchProps, ExcludedInheritedProps>, TranslateWithId<TranslationKey> {
     /**
      * Specifies if the search should initially render in an expanded state
@@ -40,8 +46,11 @@ export interface TableToolbarSearchProps extends Omit<SearchProps, ExcludedInher
     onBlur?(event: FocusEvent<HTMLInputElement>, handleExpand: TableToolbarSearchHandleExpand): void;
     /**
      * Provide an optional hook that is called each time the input is updated
+     *
+     * Note: the `''` event sentinel is legacy compatibility behavior and will be
+     * removed in the next major release.
      */
-    onChange?: (event: '' | ChangeEvent<HTMLInputElement>, value?: string) => void;
+    onChange?: (event: TableToolbarSearchOnChangeEvent, value?: string) => void;
     /**
      * Provide an optional hook that is called each time the input is expanded
      */