@carbon/react 1.80.0 → 1.81.0-rc.0

package/lib/components/UIShell/SideNavMenu.js

@@ -122,7 +122,6 @@ SideNavMenu.propTypes = {
   /**
    * A component used to render an icon.
    */
-  // @ts-expect-error - PropTypes are unable to cover this case.
   renderIcon: PropTypes__default["default"].oneOfType([PropTypes__default["default"].func, PropTypes__default["default"].object]),
   /**
    * Optional prop to specify the tabIndex of the button. If undefined, it will be applied default validation

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

@@ -30,53 +30,5 @@ export type SideNavMenuItemProps = ComponentProps<typeof Link> & {
      */
     as?: ElementType;
 };
-declare const SideNavMenuItem: React.ForwardRefExoticComponent<((import("./HeaderMenuItem").HeaderMenuItemBaseProps & {
-    /**
-     * Specify the children to be rendered inside of the `SideNavMenuItem`
-     */
-    children?: React.ReactNode;
-    /**
-     * Provide an optional class to be applied to the containing node
-     */
-    className?: string;
-    /**
-     * Optionally specify whether the link is "active". An active link is one that
-     * has an href that is the same as the current page. Can also pass in
-     * `aria-current="page"`, as well.
-     */
-    isActive?: boolean;
-    /**
-     * Optionally provide an href for the underlying li`
-     */
-    href?: string;
-    /**
-     * Optional component to render instead of default Link
-     */
-    as?: ElementType;
-}) | Omit<import("./Link").LinkBaseProps & Omit<any, "as"> & {
-    as?: React.ElementType | undefined;
-} & {
-    /**
-     * Specify the children to be rendered inside of the `SideNavMenuItem`
-     */
-    children?: React.ReactNode;
-    /**
-     * Provide an optional class to be applied to the containing node
-     */
-    className?: string;
-    /**
-     * Optionally specify whether the link is "active". An active link is one that
-     * has an href that is the same as the current page. Can also pass in
-     * `aria-current="page"`, as well.
-     */
-    isActive?: boolean;
-    /**
-     * Optionally provide an href for the underlying li`
-     */
-    href?: string;
-    /**
-     * Optional component to render instead of default Link
-     */
-    as?: ElementType;
-}, "ref">) & React.RefAttributes<HTMLElement>>;
+declare const SideNavMenuItem: React.ForwardRefExoticComponent<Omit<SideNavMenuItemProps, "ref"> & React.RefAttributes<HTMLElement>>;
 export default SideNavMenuItem;

package/lib/components/UIShell/SideNavMenuItem.js

@@ -28,7 +28,7 @@ const SideNavMenuItem = /*#__PURE__*/React__default["default"].forwardRef(functi
   const {
     children,
     className: customClassName,
-    as: Component = Link.Link,
+    as: Component = Link["default"],
     isActive,
     ...rest
   } = props;

package/lib/components/UIShell/SideNavSwitcher.js

@@ -83,7 +83,6 @@ SideNavSwitcher.propTypes = {
    * `<option>`. The text value will be what is displayed to the user and is set
    * as the `value` prop for each `<option>`.
    */
-  // @ts-expect-error
   options: PropTypes__default["default"].arrayOf(PropTypes__default["default"].string).isRequired
 };
 

package/lib/components/UIShell/SwitcherItem.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, { HTMLAttributeAnchorTarget, KeyboardEvent } from 'react';
+import React, { HTMLAttributeAnchorTarget, KeyboardEvent, MouseEvent } from 'react';
 export interface BaseSwitcherItemProps {
     /**
      * Specify the text content for the link
@@ -32,7 +32,7 @@ export interface BaseSwitcherItemProps {
     /**
      * event handlers
      */
-    onClick?: (event: MouseEvent) => void;
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
     /**
      * Specify the tab index of the Link
      */

package/lib/components/UIShell/SwitcherItem.js

@@ -71,7 +71,7 @@ const SwitcherItem = /*#__PURE__*/React.forwardRef(function SwitcherItem(props,
   }
   return /*#__PURE__*/React__default["default"].createElement("li", {
     className: classNames
-  }, /*#__PURE__*/React__default["default"].createElement(Link.Link, _rollupPluginBabelHelpers["extends"]({
+  }, /*#__PURE__*/React__default["default"].createElement(Link["default"], _rollupPluginBabelHelpers["extends"]({
     onKeyDown: evt => {
       setTabFocus(evt);
       onKeyDown(evt);

package/lib/index.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.
@@ -35,7 +35,6 @@ export { FeatureFlags, useFeatureFlag, useFeatureFlags, FeatureFlags as unstable
 useFeatureFlag as unstable_useFeatureFlag, // this export can be removed in v12
 useFeatureFlags as unstable_useFeatureFlags, } from './components/FeatureFlags';
 export * from './components/FileUploader';
-export * from './components/FilterableMultiSelect';
 export * from './components/FluidForm';
 export * from './components/Form';
 export * from './components/FormGroup';
@@ -108,6 +107,7 @@ export { FluidSelect as unstable__FluidSelect, FluidSelectSkeleton as unstable__
 export { FluidSearch as unstable__FluidSearch, FluidSearchSkeleton as unstable__FluidSearchSkeleton, } from './components/FluidSearch';
 export { FluidTextArea as unstable__FluidTextArea, FluidTextAreaSkeleton as unstable__FluidTextAreaSkeleton, } from './components/FluidTextArea';
 export { FluidTextInput as unstable__FluidTextInput, FluidTextInputSkeleton as unstable__FluidTextInputSkeleton, } from './components/FluidTextInput';
+export { FluidNumberInput as unstable__FluidNumberInput, FluidNumberInputSkeleton as unstable__FluidNumberInputSkeleton, } from './components/FluidNumberInput';
 export { FluidTimePicker as unstable__FluidTimePicker, FluidTimePickerSkeleton as unstable__FluidTimePickerSkeleton, } from './components/FluidTimePicker';
 export { FluidTimePickerSelect as unstable__FluidTimePickerSelect } from './components/FluidTimePickerSelect';
 export * from './components/Heading';

package/lib/index.js

@@ -77,7 +77,8 @@ var MenuItem = require('./components/Menu/MenuItem.js');
 var index$b = require('./components/MenuButton/index.js');
 var Modal = require('./components/Modal/Modal.js');
 var ModalWrapper = require('./components/ModalWrapper/ModalWrapper.js');
-require('./components/MultiSelect/index.js');
+var FilterableMultiSelect = require('./components/MultiSelect/FilterableMultiSelect.js');
+var MultiSelect = require('./components/MultiSelect/MultiSelect.js');
 var Notification = require('./components/Notification/Notification.js');
 var NumberInput_Skeleton = require('./components/NumberInput/NumberInput.Skeleton.js');
 var NumberInput = require('./components/NumberInput/NumberInput.js');
@@ -125,7 +126,8 @@ var SelectableTag = require('./components/Tag/SelectableTag.js');
 var Tag_Skeleton = require('./components/Tag/Tag.Skeleton.js');
 var TextArea = require('./components/TextArea/TextArea.js');
 var TextArea_Skeleton = require('./components/TextArea/TextArea.Skeleton.js');
-require('./components/TextInput/index.js');
+var TextInput = require('./components/TextInput/TextInput.js');
+var TextInput_Skeleton = require('./components/TextInput/TextInput.Skeleton.js');
 var Tile = require('./components/Tile/Tile.js');
 var TileGroup = require('./components/TileGroup/TileGroup.js');
 var TimePicker = require('./components/TimePicker/TimePicker.js');
@@ -184,6 +186,8 @@ var FluidTextArea_Skeleton = require('./components/FluidTextArea/FluidTextArea.S
 var FluidTextInput = require('./components/FluidTextInput/FluidTextInput.js');
 require('./components/FluidTextInput/FluidPasswordInput.js');
 var FluidTextInput_Skeleton = require('./components/FluidTextInput/FluidTextInput.Skeleton.js');
+var FluidNumberInput = require('./components/FluidNumberInput/FluidNumberInput.js');
+var FluidNumberInput_Skeleton = require('./components/FluidNumberInput/FluidNumberInput.Skeleton.js');
 var FluidTimePicker = require('./components/FluidTimePicker/FluidTimePicker.js');
 var FluidTimePicker_Skeleton = require('./components/FluidTimePicker/FluidTimePicker.Skeleton.js');
 var FluidTimePickerSelect = require('./components/FluidTimePickerSelect/FluidTimePickerSelect.js');
@@ -212,10 +216,7 @@ var PageSelector = require('./components/Pagination/experimental/PageSelector.js
 var Pagination = require('./components/Pagination/experimental/Pagination.js');
 var ContainedListItem = require('./components/ContainedList/ContainedListItem/ContainedListItem.js');
 var ContainedList = require('./components/ContainedList/ContainedList.js');
-var MultiSelect = require('./components/MultiSelect/MultiSelect.js');
 var Slider_Skeleton = require('./components/Slider/Slider.Skeleton.js');
-var TextInput_Skeleton = require('./components/TextInput/TextInput.Skeleton.js');
-var TextInput = require('./components/TextInput/TextInput.js');
 var LayoutDirection = require('./components/LayoutDirection/LayoutDirection.js');
 var useLayoutDirection = require('./components/LayoutDirection/useLayoutDirection.js');
 var Text = require('./components/Text/Text.js');
@@ -243,7 +244,6 @@ var TableToolbarAction = require('./components/DataTable/TableToolbarAction.js')
 var TableToolbarContent = require('./components/DataTable/TableToolbarContent.js');
 var TableToolbarSearch = require('./components/DataTable/TableToolbarSearch.js');
 var TableToolbarMenu = require('./components/DataTable/TableToolbarMenu.js');
-var FilterableMultiSelect = require('./components/MultiSelect/FilterableMultiSelect.js');
 
 
 
@@ -326,6 +326,8 @@ exports.MenuItemSelectable = MenuItem.MenuItemSelectable;
 exports.MenuButton = index$b.MenuButton;
 exports.Modal = Modal["default"];
 exports.ModalWrapper = ModalWrapper["default"];
+exports.FilterableMultiSelect = FilterableMultiSelect.FilterableMultiSelect;
+exports.MultiSelect = MultiSelect.MultiSelect;
 exports.ActionableNotification = Notification.ActionableNotification;
 exports.Callout = Notification.Callout;
 exports.InlineNotification = Notification.InlineNotification;
@@ -392,6 +394,8 @@ exports.SelectableTag = SelectableTag["default"];
 exports.TagSkeleton = Tag_Skeleton["default"];
 exports.TextArea = TextArea["default"];
 exports.TextAreaSkeleton = TextArea_Skeleton["default"];
+exports.TextInput = TextInput["default"];
+exports.TextInputSkeleton = TextInput_Skeleton["default"];
 exports.ClickableTile = Tile.ClickableTile;
 exports.ExpandableTile = Tile.ExpandableTile;
 exports.SelectableTile = Tile.SelectableTile;
@@ -403,7 +407,7 @@ exports.TimePicker = TimePicker["default"];
 exports.TimePickerSelect = TimePickerSelect["default"];
 exports.Toggle = Toggle.Toggle;
 exports.ToggleSkeleton = Toggle_Skeleton["default"];
-exports.ToggleSmallSkeleton = ToggleSmall_Skeleton["default"];
+exports.ToggleSmallSkeleton = ToggleSmall_Skeleton.ToggleSmallSkeleton;
 exports.Toggletip = index$e.Toggletip;
 exports.ToggletipActions = index$e.ToggletipActions;
 exports.ToggletipButton = index$e.ToggletipButton;
@@ -458,6 +462,8 @@ exports.unstable__FluidTextArea = FluidTextArea["default"];
 exports.unstable__FluidTextAreaSkeleton = FluidTextArea_Skeleton["default"];
 exports.unstable__FluidTextInput = FluidTextInput["default"];
 exports.unstable__FluidTextInputSkeleton = FluidTextInput_Skeleton["default"];
+exports.unstable__FluidNumberInput = FluidNumberInput["default"];
+exports.unstable__FluidNumberInputSkeleton = FluidNumberInput_Skeleton["default"];
 exports.unstable__FluidTimePicker = FluidTimePicker["default"];
 exports.unstable__FluidTimePickerSkeleton = FluidTimePicker_Skeleton["default"];
 exports.unstable__FluidTimePickerSelect = FluidTimePickerSelect["default"];
@@ -502,10 +508,7 @@ exports.unstable_PageSelector = PageSelector["default"];
 exports.unstable_Pagination = Pagination["default"];
 exports.ContainedListItem = ContainedListItem["default"];
 exports.ContainedList = ContainedList["default"];
-exports.MultiSelect = MultiSelect["default"];
 exports.SliderSkeleton = Slider_Skeleton["default"];
-exports.TextInputSkeleton = TextInput_Skeleton["default"];
-exports.TextInput = TextInput["default"];
 exports.unstable_LayoutDirection = LayoutDirection.LayoutDirection;
 exports.unstable_useLayoutDirection = useLayoutDirection.useLayoutDirection;
 exports.unstable_Text = Text.Text;
@@ -533,4 +536,3 @@ exports.TableToolbarAction = TableToolbarAction["default"];
 exports.TableToolbarContent = TableToolbarContent["default"];
 exports.TableToolbarSearch = TableToolbarSearch["default"];
 exports.TableToolbarMenu = TableToolbarMenu["default"];
-exports.FilterableMultiSelect = FilterableMultiSelect["default"];

package/lib/internal/FloatingMenu.js

@@ -259,7 +259,8 @@ const FloatingMenu = _ref2 => {
       visibility: 'hidden',
       top: '0px'
     };
-    return /*#__PURE__*/React.cloneElement(children, {
+    const child = children;
+    return /*#__PURE__*/React.cloneElement(child, {
       ref: handleMenuRef,
       style: {
         ...styles,

package/lib/internal/clamp.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright IBM Corp. 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.
+ */
+/**
+ * Clamps a number between a minimum and maximum value (inclusive).
+ */
+export declare const clamp: <T extends number>(num: number, min: T, max: T) => T;

package/lib/internal/clamp.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 });
+
+/**
+ * Clamps a number between a minimum and maximum value (inclusive).
+ */
+const clamp = (num, min, max) => Math.min(max, Math.max(min, num));
+
+exports.clamp = clamp;

package/lib/internal/useEvent.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 { type MutableRefObject } from 'react';
+export declare const useEvent: <E extends keyof GlobalEventHandlersEventMap>(elementOrRef: HTMLElement | MutableRefObject<HTMLElement | null>, eventName: E, callback: (event: GlobalEventHandlersEventMap[E]) => void) => void;
+export declare const useWindowEvent: <E extends keyof WindowEventMap>(eventName: E, callback: (event: WindowEventMap[E]) => void) => void;

package/lib/internal/useEvent.js

@@ -11,82 +11,41 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var React = require('react');
 
-// @ts-check
-
-/**
- * @template {keyof GlobalEventHandlersEventMap} E
- * @typedef {(event: GlobalEventHandlersEventMap[E]) => void} GlobalEventCallback
- */
-
-/**
- * @template T
- * @typedef {import('react').MutableRefObject<T>} MutableRefObject<T>
- */
-
-/**
- * @template {keyof GlobalEventHandlersEventMap} E
- * @param {HTMLElement | MutableRefObject<HTMLElement | null>} elementOrRef
- * @param {E} eventName
- * @param {GlobalEventCallback<E>} callback
- */
-function useEvent(elementOrRef, eventName, callback) {
-  /**
-   * @type {MutableRefObject<GlobalEventCallback<E> | null>}
-   */
+const useEvent = (elementOrRef, eventName, callback) => {
   const savedCallback = React.useRef(null);
   React.useEffect(() => {
     savedCallback.current = callback;
   }, [callback]);
   React.useEffect(() => {
-    /**
-     * @type {GlobalEventCallback<E>}
-     */
     const handler = event => {
       if (savedCallback.current) {
         savedCallback.current(event);
       }
     };
     const element = 'current' in elementOrRef ? elementOrRef.current : elementOrRef;
-    element?.addEventListener?.(eventName, handler);
+    element?.addEventListener(eventName, handler);
     return () => {
-      element?.removeEventListener?.(eventName, handler);
+      element?.removeEventListener(eventName, handler);
     };
   }, [elementOrRef, eventName]);
-}
-
-/**
- * @template {keyof WindowEventMap} E
- * @typedef {(event: WindowEventMap[E]) => void} WindowEventCallback
- */
-
-/**
- * @template {keyof WindowEventMap} E
- * @param {E} eventName
- * @param {WindowEventCallback<E>} callback
- */
-function useWindowEvent(eventName, callback) {
-  /**
-   * @type {MutableRefObject<WindowEventCallback<E> | null>}
-   */
+};
+const useWindowEvent = (eventName, callback) => {
   const savedCallback = React.useRef(null);
   React.useEffect(() => {
     savedCallback.current = callback;
   }, [callback]);
   React.useEffect(() => {
-    /**
-     * @type {WindowEventCallback<E>}
-     */
-    function handler(event) {
+    const handler = event => {
       if (savedCallback.current) {
         savedCallback.current(event);
       }
-    }
+    };
     window.addEventListener(eventName, handler);
     return () => {
       window.removeEventListener(eventName, handler);
     };
   }, [eventName]);
-}
+};
 
 exports.useEvent = useEvent;
 exports.useWindowEvent = useWindowEvent;

package/lib/internal/useId.js

@@ -27,7 +27,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 const _React = {
   ...React__default["default"]
 };
-const instanceId = setupGetInstanceId["default"]();
+const instanceId = setupGetInstanceId.setupGetInstanceId();
 const useIsomorphicLayoutEffect = environment.canUseDOM ? React.useLayoutEffect : React.useEffect;
 let serverHandoffCompleted = false;
 const defaultId = 'id';

package/lib/internal/useMatchMedia.d.ts

@@ -4,5 +4,10 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/** Listens to changes in a media query and returns whether it matches. */
-export declare const useMatchMedia: (mediaQuery: string) => boolean;
+/**
+ * Listens to changes in a media query and returns whether it matches.
+ * @param mediaQuery - The media query to listen to. For example, `(min-width: 600px)`.
+ * @param defaultState - The initial state to return before the media query is evaluated. Defaults to `false`.
+ * @returns Whether the media query matches.
+ */
+export declare const useMatchMedia: (mediaQuery: string, defaultState?: boolean) => boolean;

package/lib/internal/useMatchMedia.js

@@ -10,17 +10,16 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var React = require('react');
-var environment = require('./environment.js');
 
-/** Listens to changes in a media query and returns whether it matches. */
-const useMatchMedia = mediaQuery => {
-  const [matches, setMatches] = React.useState(() => {
-    if (environment.canUseDOM) {
-      const mediaQueryList = window.matchMedia(mediaQuery);
-      return mediaQueryList.matches;
-    }
-    return false;
-  });
+/**
+ * Listens to changes in a media query and returns whether it matches.
+ * @param mediaQuery - The media query to listen to. For example, `(min-width: 600px)`.
+ * @param defaultState - The initial state to return before the media query is evaluated. Defaults to `false`.
+ * @returns Whether the media query matches.
+ */
+const useMatchMedia = function (mediaQuery) {
+  let defaultState = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+  const [matches, setMatches] = React.useState(defaultState);
   React.useEffect(() => {
     const listener = event => {
       setMatches(event.matches);

package/lib/internal/useNoInteractiveChildren.js

@@ -18,9 +18,11 @@ function useNoInteractiveChildren(ref) {
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node) {
-        throw new Error(`Error: ${message}.\n\nInstead found: ${node.outerHTML}`);
+        const errorMessage = `Error: ${message}.\n\nInstead found: ${node.outerHTML}`;
+        console.error(errorMessage);
+        throw new Error(errorMessage);
       }
-    });
+    }, []);
   }
 }
 function useInteractiveChildrenNeedDescription(ref) {

package/lib/internal/useOutsideClick.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { type RefObject } from 'react';
-export declare const useOutsideClick: <T extends HTMLElement>(ref: RefObject<T>, callback: (event: MouseEvent) => void) => void;
+export declare const useOutsideClick: <T extends HTMLElement | null>(ref: RefObject<T>, callback: (event: MouseEvent) => void) => void;

package/lib/prop-types/AriaPropTypes.js

@@ -16,7 +16,7 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
-const AriaLabelPropType = isRequiredOneOf["default"]({
+const AriaLabelPropType = isRequiredOneOf.isRequiredOneOf({
   'aria-label': PropTypes__default["default"].string,
   'aria-labelledby': PropTypes__default["default"].string
 });

package/lib/prop-types/isRequiredOneOf.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 type { Validator, ValidationMap } from 'prop-types';
+/**
+ * Returns a set of prop-type validators that enforce at least one of the
+ * specified props must be provided.
+ *
+ * @param propTypes - An object of prop-type validators. The keys of the object
+ *    are the names of the props, and the values are the prop-type validators.
+ * @returns A new object of wrapped prop-type validators.
+ */
+export declare const isRequiredOneOf: <T extends Record<string, Validator<any>>>(propTypes: T) => ValidationMap<any>;

package/lib/prop-types/isRequiredOneOf.js

@@ -10,12 +10,14 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * @param {[key: string]: Function)} propTypes The list of type checkers, keyed by prop names.
- * @returns {[key: string]: Function}
- *   The new prop type checkers that checks if one of the given props exist,
- *   in addition to the original type checkings.
+ * Returns a set of prop-type validators that enforce at least one of the
+ * specified props must be provided.
+ *
+ * @param propTypes - An object of prop-type validators. The keys of the object
+ *    are the names of the props, and the values are the prop-type validators.
+ * @returns A new object of wrapped prop-type validators.
  */
-function isRequiredOneOf(propTypes) {
+const isRequiredOneOf = propTypes => {
   const names = Object.keys(propTypes);
   const checker = propType => function (props, propName, componentName) {
     if (process.env.NODE_ENV !== 'production' && names.every(name => typeof props[name] === 'undefined')) {
@@ -26,10 +28,10 @@ function isRequiredOneOf(propTypes) {
     }
     return propType(props, propName, componentName, ...rest);
   };
-  return names.reduce((o, name) => ({
-    ...o,
+  return names.reduce((acc, name) => ({
+    ...acc,
     [name]: checker(propTypes[name])
   }), {});
-}
+};
 
-exports["default"] = isRequiredOneOf;
+exports.isRequiredOneOf = isRequiredOneOf;

package/lib/tools/setupGetInstanceId.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+/**
+ * Creates an instance ID generator.
+ *
+ * @returns A function that returns a unique sequential ID on each call.
+ */
+export declare const setupGetInstanceId: () => () => number;

package/lib/tools/setupGetInstanceId.js

@@ -10,14 +10,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * Generic utility to initialize a method that will return a unique instance id
- * for a component.
+ * Creates an instance ID generator.
+ *
+ * @returns A function that returns a unique sequential ID on each call.
  */
-function setupGetInstanceId() {
+const setupGetInstanceId = () => {
   let instanceId = 0;
-  return function getInstanceId() {
-    return ++instanceId;
-  };
-}
+  return () => ++instanceId;
+};
 
-exports["default"] = setupGetInstanceId;
+exports.setupGetInstanceId = setupGetInstanceId;

package/lib/tools/toggleClass.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright IBM Corp. 2019, 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.
+ */
+/**
+ * Toggles a class on an element.
+ *
+ * @param element - The target element.
+ * @param className - The class to toggle.
+ * @param add - `true` to add the class, `false` to remove it.
+ */
+export declare const toggleClass: (element: Element, className: string, add: boolean) => void;

package/lib/tools/toggleClass.js

@@ -10,15 +10,14 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * Adds or removes a CSS class to an element.
- * @param {Element} element An element.
- * @param {string} name A CSS class name.
- * @param {boolean} add `true` to add the given CSS class to given the element. Otherwise to remove.
+ * Toggles a class on an element.
+ *
+ * @param element - The target element.
+ * @param className - The class to toggle.
+ * @param add - `true` to add the class, `false` to remove it.
  */
-function toggleClass(element, name, add) {
-  if (element.classList.contains(name) === !add) {
-    element.classList[add ? 'add' : 'remove'](name);
-  }
-}
+const toggleClass = (element, className, add) => {
+  element.classList.toggle(className, add);
+};
 
-exports["default"] = toggleClass;
+exports.toggleClass = toggleClass;

package/lib/tools/wrapComponent.d.ts

@@ -16,5 +16,5 @@ type WrapComponentArgs<T extends HTMLTagName> = {
  * @param {{ name: string, type: string, className?: string | (prefix: string) => string }} props
  * @returns
  */
-declare const wrapComponent: <T extends HTMLTagName>({ name, className: getClassName, type, }: WrapComponentArgs<T>) => ((props: ReactAttr<T>) => React.ReactElement);
+declare const wrapComponent: <T extends HTMLTagName>({ name, className: getClassName, type, }: WrapComponentArgs<T>) => ((props: ReactAttr<T>) => React.ReactElement<any>);
 export default wrapComponent;

package/lib/types/common.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2023, 2024
+ * Copyright IBM Corp. 2023, 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.
@@ -22,8 +22,3 @@ export interface TranslateWithId<MID = string, ARGS = Record<string, unknown>> {
      */
     translateWithId?(messageId: MID, args?: ARGS): string;
 }
-/**
- * Alias of TranslateWithId. Will be removed in v12
- * @deprecated Use TranslateWithId instead
- */
-export type InternationalProps<MID = string, ARGS = Record<string, unknown>> = TranslateWithId<MID, ARGS>;