@carbon/react 1.99.0 → 1.100.0

package/lib/components/FluidMultiSelect/FluidFilterableMultiSelect.d.ts

@@ -4,7 +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 React, { FunctionComponent, type ComponentProps } from 'react';
+import React, { type ComponentProps, type ReactNode } from 'react';
 import type { UseComboboxProps, UseMultipleSelectionProps } from 'downshift';
 import { type FilterableMultiSelectProps, type MultiSelect } from '../MultiSelect';
 interface OnChangeData<ItemType> {
@@ -65,7 +65,7 @@ export interface FluidFilterableMultiSelectProps<ItemType> extends FilterableMul
      * Function to render items as custom components instead of strings.
      * Defaults to null and is overridden by a getter
      */
-    itemToElement?: FunctionComponent<ItemType>;
+    itemToElement?: (item: ItemType) => ReactNode;
     /**
      * Helper function passed to downshift that allows the library to render a
      * given item to a string label. By default, it extracts the `label` field

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

@@ -1,15 +1,23 @@
 /**
- * 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 from 'react';
+import PropTypes from 'prop-types';
 export interface FluidMultiSelectSkeletonProps {
     /**
      * Specify an optional className to add.
      */
     className?: string;
 }
-declare const FluidMultiSelectSkeleton: React.FC<FluidMultiSelectSkeletonProps>;
+declare const FluidMultiSelectSkeleton: {
+    ({ className, ...rest }: FluidMultiSelectSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default FluidMultiSelectSkeleton;

package/lib/components/FluidMultiSelect/FluidMultiSelect.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.
@@ -66,11 +66,6 @@ export interface FluidMultiSelectProps<ItemType> extends MultiSelectProps<ItemTy
      * @deprecated This prop is deprecated in favor of new component called FluidFilterableMultiSelect and will be removed in the next major release
      */
     isFilterable?: boolean;
-    /**
-     * Function to render items as custom components instead of strings.
-     * Defaults to null and is overridden by a getter
-     */
-    itemToElement?: React.JSXElementConstructor<ItemType>;
     /**
      * Helper function passed to downshift that allows the library to render a
      * given item to a string label. By default, it extracts the `label` field

package/lib/components/FluidMultiSelect/FluidMultiSelect.js

@@ -110,8 +110,7 @@ FluidMultiSelect.propTypes = {
    */
   isFilterable: PropTypes.bool,
   /**
-   * Function to render items as custom components instead of strings.
-   * Defaults to null and is overridden by a getter
+   * Renders an item as a custom React node instead of a string.
    */
   itemToElement: PropTypes.func,
   /**

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

@@ -1,15 +1,23 @@
 /**
- * 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 from 'react';
+import PropTypes from 'prop-types';
 export interface FluidNumberInputSkeletonProps {
     /**
      * Specify an optional className to be applied to the outer FluidForm wrapper
      */
     className?: string;
 }
-declare const FluidNumberInputSkeleton: React.FC<FluidNumberInputSkeletonProps>;
+declare const FluidNumberInputSkeleton: {
+    ({ className, ...other }: FluidNumberInputSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to be applied to the outer FluidForm wrapper
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default FluidNumberInputSkeleton;

package/lib/components/FluidNumberInput/FluidNumberInput.d.ts

@@ -132,5 +132,5 @@ export interface FluidNumberInputProps extends Pick<ComponentProps<typeof Number
      */
     readOnly?: boolean;
 }
-declare const FluidNumberInput: React.FC<FluidNumberInputProps>;
+declare const FluidNumberInput: React.ForwardRefExoticComponent<FluidNumberInputProps & React.RefAttributes<HTMLInputElement>>;
 export default FluidNumberInput;

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

@@ -1,15 +1,23 @@
 /**
- * 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 from 'react';
+import PropTypes from 'prop-types';
 export interface FluidSearchSkeletonProps {
     /**
      * Specify an optional className to be applied to the outer FluidForm wrapper
      */
     className?: string;
 }
-declare const FluidSearchSkeleton: React.FC<FluidSearchSkeletonProps>;
+declare const FluidSearchSkeleton: {
+    ({ className, ...other }: FluidSearchSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to be applied to the outer FluidForm wrapper
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default FluidSearchSkeleton;

package/lib/components/FluidSearch/FluidSearch.d.ts

@@ -66,5 +66,5 @@ export interface FluidSearchProps {
      */
     value?: string | number;
 }
-declare const FluidSearch: React.FC<FluidSearchProps>;
+declare const FluidSearch: React.ForwardRefExoticComponent<FluidSearchProps & React.RefAttributes<HTMLInputElement>>;
 export default FluidSearch;

package/lib/components/FluidSearch/FluidSearch.js

@@ -18,8 +18,8 @@ require('../Search/Search.Skeleton.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var FormContext = require('../FluidForm/FormContext.js');
 
-// eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20452
-const FluidSearch = /*#__PURE__*/React.forwardRef(({
+const frFn = React.forwardRef;
+const FluidSearch = frFn(({
   className,
   ...other
 }, ref) => {

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

@@ -1,15 +1,23 @@
 /**
- * Copyright IBM Corp. 2022
+ * Copyright IBM Corp. 2022, 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';
 export interface FluidSelectSkeletonProps {
     /**
      * Specify an optional className to add.
      */
     className?: string;
 }
-declare const FluidSelectSkeleton: React.FC<FluidSelectSkeletonProps>;
+declare const FluidSelectSkeleton: {
+    ({ className, ...rest }: FluidSelectSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default FluidSelectSkeleton;

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

@@ -1,15 +1,23 @@
 /**
- * Copyright IBM Corp. 2024
+ * Copyright IBM Corp. 2024, 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';
 export interface FluidTextAreaSkeletonProps {
     /**
      * Specify an optional className to be applied to the outer FluidForm wrapper
      */
     className?: string;
 }
-declare const FluidTextAreaSkeleton: React.FC<FluidTextAreaSkeletonProps>;
+declare const FluidTextAreaSkeleton: {
+    ({ className, ...other }: FluidTextAreaSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to be applied to the outer FluidForm wrapper
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default FluidTextAreaSkeleton;

package/lib/components/FluidTextArea/FluidTextArea.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 FluidTextAreaProps {
     /**
@@ -96,5 +97,98 @@ export interface FluidTextAreaProps {
      */
     readOnly?: boolean;
 }
-declare const FluidTextArea: React.FC<FluidTextAreaProps>;
+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
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify the `cols` attribute for the underlying `<textarea>` node
+         */
+        cols: PropTypes.Requireable<number>;
+        /**
+         * Optionally provide the default value of the `<textarea>`
+         */
+        defaultValue: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
+        /**
+         * Specify whether the control is disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * Specify whether to display the character counter
+         */
+        enableCounter: PropTypes.Requireable<boolean>;
+        /**
+         * Provide text that is used alongside the control label for additional help
+         */
+        helperText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify whether you want the underlying label to be visually hidden
+         */
+        hideLabel: PropTypes.Requireable<boolean>;
+        /**
+         * Provide a unique identifier for the control
+         */
+        id: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the control is currently invalid
+         */
+        invalid: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the control is in an invalid state
+         */
+        invalidText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide the text that will be read by a screen reader when visiting this
+         * control
+         */
+        labelText: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * `true` to use the light version. For use on $ui-01 backgrounds only.
+         * Don't use this to make tile background color same as container background color.
+         */
+        light: (props: Record<string, any>, propName: string, componentName: string, ...rest: any[]) => any;
+        /**
+         * Max character count allowed for the textarea. This is needed in order for enableCounter to display
+         */
+        maxCount: PropTypes.Requireable<number>;
+        /**
+         * Optionally provide an `onChange` handler that is called whenever `<textarea>`
+         * is updated
+         */
+        onChange: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optionally provide an `onClick` handler that is called whenever the
+         * `<textarea>` is clicked
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Specify the placeholder attribute for the `<textarea>`
+         */
+        placeholder: PropTypes.Requireable<string>;
+        /**
+         * Specify the rows attribute for the `<textarea>`
+         */
+        rows: PropTypes.Requireable<number>;
+        /**
+         * Provide the current value of the `<textarea>`
+         */
+        value: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
+        /**
+         * Specify whether the control is currently in warning state
+         */
+        warn: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the control is in warning state
+         */
+        warnText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Whether or not the component is readonly
+         */
+        readOnly: PropTypes.Requireable<boolean>;
+    };
+};
 export default FluidTextArea;

package/lib/components/FluidTextInput/FluidPasswordInput.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 FluidPasswordInputProps {
     /**
@@ -83,5 +84,85 @@ export interface FluidPasswordInputProps {
      */
     readOnly?: boolean;
 }
-declare const FluidPasswordInput: React.FC<FluidPasswordInputProps>;
+declare const FluidPasswordInput: {
+    ({ className, ...other }: FluidPasswordInputProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to be applied to the outer FluidForm wrapper
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Optionally provide the default value of the `<input>`
+         */
+        defaultValue: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
+        /**
+         * Specify whether the `<input>` should be disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * "Hide password" tooltip text on password visibility toggle
+         */
+        hidePasswordLabel: PropTypes.Requireable<string>;
+        /**
+         * Specify a custom `id` for the `<input>`
+         */
+        id: PropTypes.Validator<string>;
+        /**
+         * Specify whether the control is currently invalid
+         */
+        invalid: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the control is in an invalid state
+         */
+        invalidText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify whether the control is a password input
+         */
+        isPassword: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that will be read by a screen reader when visiting this
+         * control
+         */
+        labelText: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Optionally provide an `onChange` handler that is called whenever `<input>`
+         * is updated
+         */
+        onChange: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optionally provide an `onClick` handler that is called whenever the
+         * `<input>` is clicked
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Callback function that is called whenever the toggle password visibility
+         * button is clicked
+         */
+        onTogglePasswordVisibility: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Specify the placeholder attribute for the `<input>`
+         */
+        placeholder: PropTypes.Requireable<string>;
+        /**
+         * "Show password" tooltip text on password visibility toggle
+         */
+        showPasswordLabel: PropTypes.Requireable<string>;
+        /**
+         * Specify the value of the `<input>`
+         */
+        value: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
+        /**
+         * Specify whether the control is currently in warning state
+         */
+        warn: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the control is in warning state
+         */
+        warnText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Whether or not the component is readonly
+         */
+        readOnly: PropTypes.Requireable<boolean>;
+    };
+};
 export default FluidPasswordInput;

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

@@ -1,15 +1,23 @@
 /**
- * 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 from 'react';
+import PropTypes from 'prop-types';
 export interface FluidTextInputSkeletonProps {
     /**
      * Specify an optional className to be applied to the outer FluidForm wrapper
      */
     className?: string;
 }
-declare const FluidTextInputSkeleton: React.FC<FluidTextInputSkeletonProps>;
+declare const FluidTextInputSkeleton: {
+    ({ className, ...other }: FluidTextInputSkeletonProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to be applied to the outer FluidForm wrapper
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default FluidTextInputSkeleton;

package/lib/components/Grid/GridContext.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 type GridMode = 'flexbox' | 'css-grid';
 export interface GridSettingContext {
@@ -31,7 +32,24 @@ export interface GridSettingsProps {
      */
     subgrid?: boolean;
 }
-export declare const GridSettings: React.FC<GridSettingsProps>;
+export declare const GridSettings: {
+    ({ children, mode, subgrid, }: GridSettingsProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Pass in components which will be rendered within the `GridSettings`
+         * component
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the gutter mode for the GridContext
+         */
+        mode: PropTypes.Validator<NonNullable<GridMode>>;
+        /**
+         * Specify whether subgrid should be enabled
+         */
+        subgrid: PropTypes.Requireable<boolean>;
+    };
+};
 /**
  * Helper function for accessing the GridContext value
  */

package/lib/components/IconButton/index.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/InlineLoading/InlineLoading.js

@@ -56,7 +56,10 @@ const InlineLoading = ({
         className: `${prefix}--inline-loading__checkmark-container`
       }, /*#__PURE__*/React.createElement("title", null, iconLabel));
     }
-    if (status === 'active') {
+    if (status === 'inactive' || status === 'active') {
+      if (status === 'inactive') {
+        return undefined;
+      }
       if (!iconDescription) {
         iconLabel = 'loading';
       }
@@ -67,15 +70,6 @@ const InlineLoading = ({
         active: status === 'active'
       });
     }
-    if (status === 'inactive') {
-      if (!iconDescription) {
-        iconLabel = 'not loading';
-      }
-      return /*#__PURE__*/React.createElement("title", {
-        className: `${prefix}--inline-loading__inactive-status`
-      }, iconLabel);
-    }
-    return undefined;
   };
   const loadingText = description && /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--inline-loading__text`
@@ -87,7 +81,7 @@ const InlineLoading = ({
   return /*#__PURE__*/React.createElement("div", _rollupPluginBabelHelpers.extends({
     className: loadingClasses
   }, rest, {
-    "aria-live": rest['aria-live'] ?? 'assertive'
+    "aria-live": rest['aria-live'] ?? (status === 'inactive' ? 'off' : 'assertive')
   }), loadingAnimation, loadingText);
 };
 InlineLoading.propTypes = {

package/lib/components/Link/Link.js

@@ -76,7 +76,10 @@ const LinkBase = /*#__PURE__*/React.forwardRef(({
   }, /*#__PURE__*/React.createElement(Icon, null)));
 });
 const Link = LinkBase;
+
+// @ts-expect-error - `displayName` isn't typed.
 Link.displayName = 'Link';
+// @ts-expect-error - `propTypes` isn't typed.
 Link.propTypes = {
   /**
    * Provide a custom element or component to render the top-level node for the

package/lib/components/ListBox/ListBoxField.d.ts

@@ -4,13 +4,46 @@
  * 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 HTMLAttributes } from 'react';
+import { type HTMLAttributes } from 'react';
+import PropTypes from 'prop-types';
 export interface ListBoxFieldProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Specify if the parent <ListBox> is disabled
      */
     disabled?: boolean;
 }
-export type ListBoxFieldComponent = React.FC<ListBoxFieldProps>;
+/**
+ * `ListBoxField` is responsible for creating the containing node for valid
+ * elements inside of a field. It also provides a11y-related attributes like
+ * `role` to make sure a user can focus the given field.
+ */
+declare function ListBoxField({ children, disabled, tabIndex, ...rest }: ListBoxFieldProps): import("react/jsx-runtime").JSX.Element;
+declare namespace ListBoxField {
+    var propTypes: {
+        /**
+         * Typically set by `getToggleButtonProps`, this should specify whether the
+         * field has a popup.
+         */
+        'aria-haspopup': PropTypes.Requireable<NonNullable<string | boolean | null | undefined>>;
+        /**
+         * Provide the contents of your ListBoxField
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify if the parent <ListBox> is disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * The role for the component, should be set by `getToggleButtonProps` coming
+         * from Downshift
+         */
+        role: PropTypes.Requireable<string>;
+        /**
+         * Optional prop to specify the tabIndex of the <ListBox> trigger button
+         */
+        tabIndex: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
+    };
+}
+export type ListBoxFieldComponent = typeof ListBoxField;
 declare const _default: ListBoxFieldComponent;
 export default _default;

package/lib/components/ListBox/ListBoxMenuIcon.d.ts

@@ -4,7 +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 React from 'react';
+import PropTypes from 'prop-types';
 import type { TranslateWithId } from '../../types/common';
 declare const translationIds: {
     readonly 'close.menu': "close.menu";
@@ -18,10 +18,23 @@ export interface ListBoxMenuIconProps extends TranslateWithId<TranslationKey> {
      */
     isOpen: boolean;
 }
-export type ListBoxMenuIconComponent = React.FC<ListBoxMenuIconProps>;
+export type ListBoxMenuIconComponent = typeof ListBoxMenuIcon;
 /**
  * `ListBoxMenuIcon` is used to orient the icon up or down depending on the
  * state of the menu for a given `ListBox`
  */
-declare const ListBoxMenuIcon: ListBoxMenuIconComponent;
+declare const ListBoxMenuIcon: {
+    ({ isOpen, translateWithId: t, }: ListBoxMenuIconProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify whether the menu is currently open, which will influence the
+         * direction of the menu icon
+         */
+        isOpen: PropTypes.Validator<boolean>;
+        /**
+         * Translates component strings using your i18n tool.
+         */
+        translateWithId: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+};
 export default ListBoxMenuIcon;

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