@carbon/react 1.101.0 → 1.102.0

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,7 @@ 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');
+var utils = require('../../internal/utils.js');
 require('../Switch/Switch.js');
 var IconSwitch = require('../Switch/IconSwitch.js');
 
@@ -30,7 +30,7 @@ const ContentSwitcher = ({
   selectedIndex: selectedIndexProp = 0,
   selectionMode = 'automatic',
   size,
-  onChange = noopFn.noopFn,
+  onChange,
   ...other
 }) => {
   const prefix = React.useContext(usePrefix.PrefixContext);
@@ -84,7 +84,7 @@ const ContentSwitcher = ({
     }
   };
   const isIconOnly = React.Children.map(children, child => {
-    return /*#__PURE__*/React.isValidElement(child) ? child.type === IconSwitch.default : null;
+    return utils.isComponentElement(child, IconSwitch.default);
   })?.every(val => val === true);
   const classes = cx(`${prefix}--content-switcher`, className, {
     [`${prefix}--content-switcher--light`]: light,

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/TableExpandRow.js

@@ -54,7 +54,7 @@ const TableExpandRow = /*#__PURE__*/React.forwardRef(({
     }
   });
   const normalizedChildren = React.Children.toArray(children).map(child => {
-    if (/*#__PURE__*/React.isValidElement(child) && child.type !== TableSlugRow.default && child.type !== TableDecoratorRow.default) {
+    if (!utils.isComponentElement(child, TableSlugRow.default) && !utils.isComponentElement(child, TableDecoratorRow.default)) {
       return child;
     }
   });

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
      */

package/lib/components/DataTable/TableToolbarSearch.js

@@ -30,6 +30,13 @@ const defaultTranslations = {
 const defaultTranslateWithId = messageId => {
   return defaultTranslations[messageId];
 };
+
+/**
+ * @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.
+ */
+
 const TableToolbarSearch = ({
   className,
   searchContainerClass,
@@ -68,14 +75,14 @@ const TableToolbarSearch = ({
   }, [focusTarget]);
   React.useEffect(() => {
     if (defaultValue) {
+      // TODO: Remove the `''` event sentinel and pass `undefined` for
+      // value initialization in the next major release.
       onChangeProp?.('', defaultValue);
     }
   },
   //eslint-disable-next-line react-hooks/exhaustive-deps
   []);
-  const searchClasses = cx(className, {
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    [searchContainerClass]: searchContainerClass,
+  const searchClasses = cx(className, searchContainerClass, {
     [`${prefix}--toolbar-search-container-active`]: expanded,
     [`${prefix}--toolbar-search-container-disabled`]: disabled,
     [`${prefix}--toolbar-search-container-expandable`]: !persistent,

package/lib/components/DataTable/stories/examples/TableToolbarFilter.d.ts

@@ -12,6 +12,9 @@ interface TableToolbarFilterProps {
     className?: string;
     /**
      * Provide an optional hook that is called each time the input is updated
+     *
+     * Note: the `''` event sentinel exists for `DataTable` compatibility and
+     * should be removed in the next major release.
      */
     onChange?: (event: '' | ChangeEvent<HTMLInputElement>) => void;
     /**

package/lib/components/DataTable/tools/normalize.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var index = require('../../AILabel/index.js');
+var utils = require('../../../internal/utils.js');
 var cells = require('./cells.js');
 
 /**
@@ -64,7 +65,7 @@ const normalize = (rows, headers, prevState = {}) => {
         isEditing: false,
         isValid: true,
         errors: null,
-        hasAILabelHeader: !!(slug || decorator?.type === index.AILabel),
+        hasAILabelHeader: !!(slug || utils.isComponentElement(decorator, index.AILabel)),
         info: {
           header: key
         }

package/lib/components/DataTableSkeleton/DataTableSkeleton.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.
@@ -22,11 +22,6 @@ export interface DataTableSkeletonProps extends TableHTMLAttributes<HTMLTableEle
      * Specify the number of columns that you want to render in the skeleton state
      */
     columnCount?: number;
-    /**
-     * Optionally specify whether you want the Skeleton to be rendered as a
-     * compact DataTable
-     */
-    compact?: boolean;
     /**
      * Optionally specify the displayed headers
      */
@@ -57,7 +52,7 @@ export interface DataTableSkeletonProps extends TableHTMLAttributes<HTMLTableEle
     className?: string;
 }
 declare const DataTableSkeleton: {
-    ({ headers, rowCount, columnCount, zebra, compact, className, showHeader, showToolbar, size, ...rest }: DataTableSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    ({ headers, rowCount, columnCount, zebra, className, showHeader, showToolbar, size, ...rest }: DataTableSkeletonProps): import("react/jsx-runtime").JSX.Element;
     propTypes: {
         /**
          * Specify an optional className to add.
@@ -67,11 +62,6 @@ declare const DataTableSkeleton: {
          * Specify the number of columns that you want to render in the skeleton state
          */
         columnCount: PropTypes.Requireable<number>;
-        /**
-         * Optionally specify whether you want the Skeleton to be rendered as a
-         * compact DataTable
-         */
-        compact: PropTypes.Requireable<boolean>;
         /**
          * Optionally specify the displayed headers
          */

package/lib/components/DataTableSkeleton/DataTableSkeleton.js

@@ -21,7 +21,6 @@ const DataTableSkeleton = ({
   rowCount = 5,
   columnCount = 5,
   zebra = false,
-  compact = false,
   className,
   showHeader = true,
   showToolbar = true,
@@ -33,8 +32,7 @@ const DataTableSkeleton = ({
     [`${prefix}--skeleton`]: true,
     [`${prefix}--data-table`]: true,
     [`${prefix}--data-table--${size}`]: size,
-    [`${prefix}--data-table--zebra`]: zebra,
-    [`${prefix}--data-table--compact`]: compact
+    [`${prefix}--data-table--zebra`]: zebra
   });
   const rowRepeat = rowCount;
   const rows = Array(rowRepeat);
@@ -80,11 +78,6 @@ DataTableSkeleton.propTypes = {
    * Specify the number of columns that you want to render in the skeleton state
    */
   columnCount: PropTypes.number,
-  /**
-   * Optionally specify whether you want the Skeleton to be rendered as a
-   * compact DataTable
-   */
-  compact: PropTypes.bool,
   /**
    * Optionally specify the displayed headers
    */

package/lib/components/DatePicker/DatePicker.js

@@ -22,6 +22,7 @@ var rangePlugin = require('./plugins/rangePlugin.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var keys = require('../../internal/keyboard/keys.js');
 var match = require('../../internal/keyboard/match.js');
+var utils = require('../../internal/utils.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var useSavedCallback = require('../../internal/useSavedCallback.js');
 require('../FluidForm/FluidForm.js');
@@ -246,7 +247,7 @@ const DatePicker = /*#__PURE__*/React.forwardRef((props, ref) => {
   const childrenWithProps = React.Children.toArray(children).map(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
   (child, index) => {
-    if (index === 0 && child.type === /*#__PURE__*/React.createElement(DatePickerInput.default, child.props).type) {
+    if (index === 0 && utils.isComponentElement(child, DatePickerInput.default)) {
       return /*#__PURE__*/React.cloneElement(child, {
         datePickerType,
         ref: startInputField,
@@ -255,7 +256,7 @@ const DatePicker = /*#__PURE__*/React.forwardRef((props, ref) => {
         warn: effectiveWarn
       });
     }
-    if (index === 1 && child.type === /*#__PURE__*/React.createElement(DatePickerInput.default, child.props).type) {
+    if (index === 1 && utils.isComponentElement(child, DatePickerInput.default)) {
       return /*#__PURE__*/React.cloneElement(child, {
         datePickerType,
         ref: endInputField,
@@ -433,7 +434,10 @@ const DatePicker = /*#__PURE__*/React.forwardRef((props, ref) => {
           calendarContainer.classList.add('open');
           const selectedDateElem = calendarContainer.querySelector('.selected') && fpSelectedDateElem;
           const todayDateElem = calendarContainer.querySelector('.today') && fpTodayDateElem;
-          (selectedDateElem || todayDateElem || calendarContainer.querySelector('.flatpickr-day[tabindex]') || calendarContainer).focus();
+          const focusTarget = selectedDateElem || todayDateElem || calendarContainer.querySelector('.flatpickr-day[tabindex]') || calendarContainer;
+          if (focusTarget instanceof HTMLElement) {
+            focusTarget.focus();
+          }
           if (event.target === startInputField.current) {
             lastFocusedField.current = startInputField.current;
           } else if (event.target === endInputField.current) {

package/lib/components/DatePickerInput/DatePickerInput.d.ts

@@ -61,12 +61,9 @@ export interface DatePickerInputProps extends Omit<HTMLAttributes<HTMLInputEleme
      */
     onClick?: func;
     /**
-     * Provide a regular expression that the input value must match
-     * TODO:need to be rewritten
+     * Provide a regular expression pattern string that the input value must match
      */
-    pattern?: (props: {
-        [key: string]: any;
-    }, propName: string, componentName: string) => null | any | Error;
+    pattern?: string;
     /**
      * Specify the placeholder text
      */

package/lib/components/DatePickerInput/DatePickerInput.js

@@ -208,20 +208,9 @@ DatePickerInput.propTypes = {
    */
   onClick: PropTypes.func,
   /**
-   * Provide a regular expression that the input value must match
+   * Provide a regular expression pattern string that the input value must match
    */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-  pattern: (props, propName, componentName) => {
-    if (props[propName] === undefined) {
-      return;
-    }
-    try {
-      new RegExp(props[propName]);
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452
-    } catch (e) {
-      return new Error(`Invalid value of prop '${propName}' supplied to '${componentName}', it should be a valid regular expression`);
-    }
-  },
+  pattern: PropTypes.string,
   /**
    * Specify the placeholder text
    */

package/lib/components/Dropdown/Dropdown.js

@@ -61,6 +61,7 @@ function stateReducer(state, actionAndChanges) {
   } = actionAndChanges;
   switch (type) {
     case ItemMouseMove:
+      return state;
     case MenuMouseLeave:
       if (changes.highlightedIndex === state.highlightedIndex) {
         // Prevent state update if highlightedIndex hasn't changed
@@ -175,9 +176,7 @@ const Dropdown = /*#__PURE__*/React.forwardRef(({
     const {
       highlightedIndex
     } = changes;
-    if (highlightedIndex !== undefined && highlightedIndex > -1 &&
-    // eslint-disable-next-line valid-typeof , no-constant-binary-expression -- https://github.com/carbon-design-system/carbon/issues/20452
-    typeof window !== undefined) {
+    if (highlightedIndex !== undefined && highlightedIndex > -1) {
       const itemArray = document.querySelectorAll(`li.${prefix}--list-box__menu-item[role="option"]`);
       const highlightedItem = itemArray[highlightedIndex];
       if (highlightedItem) {

package/lib/components/ExpandableSearch/ExpandableSearch.js

@@ -19,6 +19,7 @@ var events = require('../../tools/events.js');
 var keys = require('../../internal/keyboard/keys.js');
 var match = require('../../internal/keyboard/match.js');
 var mergeRefs = require('../../tools/mergeRefs.js');
+var utils = require('../Search/utils.js');
 
 const frFn = React.forwardRef;
 const ExpandableSearch = frFn((props, forwardedRef) => {
@@ -32,7 +33,7 @@ const ExpandableSearch = frFn((props, forwardedRef) => {
     ...rest
   } = props;
   const [expanded, setExpanded] = React.useState(isExpanded || false);
-  const [hasContent, setHasContent] = React.useState(Boolean(defaultValue));
+  const [hasContent, setHasContent] = React.useState(utils.isSearchValuePresent(defaultValue));
   const searchRef = React.useRef(null);
   const prefix = usePrefix.usePrefix();
   function handleBlur(evt) {

package/lib/components/ExpandableSearch/index.js

@@ -0,0 +1,17 @@
+/**
+ * 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';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var ExpandableSearch = require('./ExpandableSearch.js');
+
+
+
+exports.ExpandableSearch = ExpandableSearch.default;
+exports.default = ExpandableSearch.default;

package/lib/components/FeatureFlags/index.js

@@ -7,7 +7,7 @@
 
 'use strict';
 
-var FeatureFlags$1 = require('@carbon/feature-flags');
+var featureFlags = require('@carbon/feature-flags');
 var PropTypes = require('prop-types');
 var React = require('react');
 var deprecate = require('../../prop-types/deprecate.js');
@@ -17,7 +17,7 @@ var deprecate = require('../../prop-types/deprecate.js');
  * Our FeatureFlagContext is used alongside the FeatureFlags component to enable
  * or disable feature flags in a given React tree
  */
-const FeatureFlagContext = /*#__PURE__*/React.createContext(FeatureFlags$1.FeatureFlags);
+const FeatureFlagContext = /*#__PURE__*/React.createContext(featureFlags.FeatureFlags);
 
 /**
  * Supports an object of feature flag values with the `flags` prop, merging them
@@ -54,12 +54,12 @@ function FeatureFlags({
     ...flags
   };
   const [scope, updateScope] = React.useState(() => {
-    const scope = FeatureFlags$1.createScope(combinedFlags);
+    const scope = featureFlags.createScope(combinedFlags);
     scope.mergeWithScope(parentScope);
     return scope;
   });
   if (parentScope !== prevParentScope) {
-    const scope = FeatureFlags$1.createScope(combinedFlags);
+    const scope = featureFlags.createScope(combinedFlags);
     scope.mergeWithScope(parentScope);
     updateScope(scope);
     setPrevParentScope(parentScope);
@@ -69,7 +69,7 @@ function FeatureFlags({
   // for flags that are passed in. If they have changed, then we re-create the
   // FeatureFlagScope using the new flags
   useChangedValue(combinedFlags, isEqual, changedFlags => {
-    const scope = FeatureFlags$1.createScope(changedFlags);
+    const scope = featureFlags.createScope(changedFlags);
     scope.mergeWithScope(parentScope);
     updateScope(scope);
   });

package/lib/components/FluidSelect/FluidSelect.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2022
+ * 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.
  */
-import React from 'react';
+import React, { type SelectHTMLAttributes } from 'react';
 export interface FluidSelectProps {
     /**
      * Provide the contents of your Select
@@ -17,7 +17,7 @@ export interface FluidSelectProps {
     /**
      * Optionally provide the default value of the `<select>`
      */
-    defaultValue?: any;
+    defaultValue?: SelectHTMLAttributes<HTMLSelectElement>['defaultValue'];
     /**
      * Specify whether the control is disabled
      */

package/lib/components/FluidTextArea/FluidTextArea.d.ts

@@ -8,8 +8,7 @@ import PropTypes from 'prop-types';
 import React from 'react';
 export interface FluidTextAreaProps {
     /**
-     * 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;
     /**
@@ -101,8 +100,7 @@ declare const FluidTextArea: {
     ({ className, ...other }: FluidTextAreaProps): import("react/jsx-runtime").JSX.Element;
     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.Requireable<string>;
         /**

package/lib/components/FluidTextArea/FluidTextArea.js

@@ -35,8 +35,7 @@ const FluidTextArea = ({
 };
 FluidTextArea.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/lib/components/FluidTimePickerSelect/FluidTimePickerSelect.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2022
+ * 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.
  */
-import React from 'react';
+import React, { type SelectHTMLAttributes } from 'react';
 export interface FluidTimePickerSelectProps {
     /**
      * Provide the contents of your Select
@@ -17,7 +17,7 @@ export interface FluidTimePickerSelectProps {
     /**
      * Optionally provide the default value of the `<select>`
      */
-    defaultValue?: any;
+    defaultValue?: SelectHTMLAttributes<HTMLSelectElement>['defaultValue'];
     /**
      * Specify whether the control is disabled
      */

package/lib/components/Grid/Column.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/Grid/Column.js

@@ -10,32 +10,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
-var FeatureFlags = require('@carbon/feature-flags');
+var featureFlags = require('@carbon/feature-flags');
 var cx = require('classnames');
 var PropTypes = require('prop-types');
 var React = require('react');
 var usePrefix = require('../../internal/usePrefix.js');
 var GridContext = require('./GridContext.js');
 
-function _interopNamespaceDefault(e) {
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
-}
-
-var FeatureFlags__namespace = /*#__PURE__*/_interopNamespaceDefault(FeatureFlags);
-
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20452
 const Column = /*#__PURE__*/React.forwardRef(({
   as,
@@ -75,7 +56,7 @@ const Column = /*#__PURE__*/React.forwardRef(({
   }, rest), children);
 });
 const percentSpanType = PropTypes.oneOf(['25%', '50%', '75%', '100%']);
-const spanPropType = FeatureFlags__namespace.enabled('enable-css-grid') ? PropTypes.oneOfType([PropTypes.bool, PropTypes.number, PropTypes.shape({
+const spanPropType = featureFlags.enabled('enable-css-grid') ? PropTypes.oneOfType([PropTypes.bool, PropTypes.number, PropTypes.shape({
   span: PropTypes.oneOfType([PropTypes.number, percentSpanType]),
   offset: PropTypes.number,
   start: PropTypes.number,

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

@@ -40,7 +40,9 @@ function Loading({
     className: loadingClassName
   }), /*#__PURE__*/React.createElement("svg", {
     className: `${prefix}--loading__svg`,
-    viewBox: "0 0 100 100"
+    viewBox: "0 0 100 100",
+    role: "img",
+    "aria-label": description
   }, /*#__PURE__*/React.createElement("title", null, description), small ? /*#__PURE__*/React.createElement("circle", {
     className: `${prefix}--loading__background`,
     cx: "50%",

package/lib/components/Menu/Menu.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.

package/lib/components/Menu/Menu.js

@@ -86,10 +86,14 @@ const Menu = /*#__PURE__*/React.forwardRef(function Menu({
   }
   function handleOpen() {
     if (menu.current) {
-      focusReturn.current = document.activeElement;
+      const {
+        activeElement,
+        dir
+      } = document;
+      focusReturn.current = activeElement instanceof HTMLElement ? activeElement : null;
       if (legacyAutoalign) {
         const pos = calculatePosition();
-        if ((document?.dir === 'rtl' || direction === 'rtl') && !rest?.id?.includes('MenuButton')) {
+        if ((dir === 'rtl' || direction === 'rtl') && !rest?.id?.includes('MenuButton')) {
           menu.current.style.insetInlineStart = `initial`;
           menu.current.style.insetInlineEnd = `${pos[0]}px`;
         } else {

package/lib/components/Menu/MenuItem.js

@@ -71,7 +71,7 @@ const MenuItem = /*#__PURE__*/React.forwardRef(function MenuItem({
   const context = React.useContext(MenuContext.MenuContext);
   const menuItem = React.useRef(null);
   const ref = useMergedRefs.useMergedRefs([forwardRef, menuItem, refs.setReference]);
-  const hasChildren = Boolean(children);
+  const hasChildren = React.Children.toArray(children).length > 0;
   const isDisabled = disabled && !hasChildren;
   const isDanger = kind === 'danger' && !hasChildren;
   function registerItem() {
@@ -79,7 +79,7 @@ const MenuItem = /*#__PURE__*/React.forwardRef(function MenuItem({
       type: 'registerItem',
       payload: {
         ref: menuItem,
-        disabled: Boolean(disabled)
+        disabled: disabled ?? false
       }
     });
   }