@carbon/react 1.25.0 → 1.26.0-rc.0

package/es/components/MultiSelect/MultiSelect.js

@@ -35,7 +35,6 @@ var _ref = useSelect.stateChangeTypes,
     MenuBlur = _ref.MenuBlur,
     MenuKeyDownArrowDown = _ref.MenuKeyDownArrowDown,
     MenuKeyDownArrowUp = _ref.MenuKeyDownArrowUp,
-    MenuKeyDownEnter = _ref.MenuKeyDownEnter,
     MenuKeyDownEscape = _ref.MenuKeyDownEscape,
     MenuKeyDownSpaceButton = _ref.MenuKeyDownSpaceButton,
     ToggleButtonClick = _ref.ToggleButtonClick;
@@ -235,7 +234,6 @@ var MultiSelect = /*#__PURE__*/React__default.forwardRef(function MultiSelect(_r
     switch (type) {
       case ItemClick:
       case MenuKeyDownSpaceButton:
-      case MenuKeyDownEnter:
         if (changes.selectedItem === undefined) {
           break;
         }

package/es/components/NumberInput/NumberInput.js

@@ -515,13 +515,21 @@ function disableWheel(e) {
 }
 /**
  * Clamp the given value between the upper bound `max` and the lower bound `min`
+ *
+ * 16 digit min/max more precise than Infinity. Somewhere in 9 quadrillion,
+ * there will be integer display issues at runtime. 9quad is a safe cutoff.
  * @param {number} max
  * @param {number} min
  * @param {number} value
  */
 
 
-function clamp(max, min, value) {
+var boundLimit = 9000000000000000; // 16 digit, 9 quadrillion
+
+function clamp() {
+  var max = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : boundLimit;
+  var min = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : -boundLimit;
+  var value = arguments.length > 2 ? arguments[2] : undefined;
   return Math.min(max, Math.max(min, value));
 }
 

package/es/components/RadioButton/RadioButton.Skeleton.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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.
+ */
+import PropTypes from 'prop-types';
+import React from 'react';
+export interface RadioButtonSkeletonProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+}
+declare function RadioButtonSkeleton(props: RadioButtonSkeletonProps): JSX.Element;
+declare namespace RadioButtonSkeleton {
+    var propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+}
+export default RadioButtonSkeleton;
+export { RadioButtonSkeleton };

package/es/components/RadioButton/RadioButton.Skeleton.js

@@ -13,9 +13,9 @@ import { usePrefix } from '../../internal/usePrefix.js';
 
 var _excluded = ["className"];
 
-function RadioButtonSkeleton(_ref) {
-  var className = _ref.className,
-      rest = _objectWithoutProperties(_ref, _excluded);
+function RadioButtonSkeleton(props) {
+  var className = props.className,
+      rest = _objectWithoutProperties(props, _excluded);
 
   var prefix = usePrefix();
   return /*#__PURE__*/React__default.createElement("div", _extends({

package/es/components/RadioButton/RadioButton.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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.
+ */
+import { ReactNodeLike } from 'prop-types';
+import React from 'react';
+type ExcludedAttributes = 'onChange';
+export interface RadioButtonProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, ExcludedAttributes> {
+    /**
+     * Specify whether the `<RadioButton>` is currently checked
+     */
+    checked?: boolean;
+    /**
+     * Provide an optional className to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Specify whether the `<RadioButton>` should be checked by default
+     */
+    defaultChecked?: boolean;
+    /**
+     * Specify whether the control is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify whether the label should be hidden, or not
+     */
+    hideLabel?: boolean;
+    /**
+     * Provide a unique id for the underlying `<input>` node
+     */
+    id?: string;
+    /**
+     * Provide where label text should be placed
+     * NOTE: `top`/`bottom` are deprecated
+     */
+    labelPosition?: 'left' | 'right';
+    /**
+     * Provide label text to be read by screen readers when interacting with the
+     * control
+     */
+    labelText: ReactNodeLike;
+    /**
+     * Provide a name for the underlying `<input>` node
+     */
+    name?: string;
+    /**
+     * Provide an optional `onChange` hook that is called each time the value of
+     * the underlying `<input>` changes
+     */
+    onChange?: (value: string | number, name: string | undefined, event: any) => void;
+    /**
+     * Provide a handler that is invoked when a user clicks on the control
+     */
+    onClick?: (evt: React.MouseEvent<HTMLInputElement>) => void;
+    /**
+     * Specify the value of the `<RadioButton>`
+     */
+    value?: string | number;
+}
+declare const RadioButton: React.ForwardRefExoticComponent<RadioButtonProps & React.RefAttributes<unknown>>;
+export default RadioButton;

package/es/components/RadioButton/RadioButton.js

@@ -7,29 +7,30 @@
 
 import { objectWithoutProperties as _objectWithoutProperties, defineProperty as _defineProperty, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default from 'react';
+import React__default, { useRef } from 'react';
 import cx from 'classnames';
 import '../Text/index.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { useId } from '../../internal/useId.js';
+import mergeRefs from '../../tools/mergeRefs.js';
 import { Text } from '../Text/Text.js';
 
 var _excluded = ["className", "disabled", "hideLabel", "id", "labelPosition", "labelText", "name", "onChange", "value"];
-var RadioButton = /*#__PURE__*/React__default.forwardRef(function RadioButton(_ref, ref) {
-  var className = _ref.className,
-      disabled = _ref.disabled,
-      hideLabel = _ref.hideLabel,
-      id = _ref.id,
-      _ref$labelPosition = _ref.labelPosition,
-      labelPosition = _ref$labelPosition === void 0 ? 'right' : _ref$labelPosition,
-      _ref$labelText = _ref.labelText,
-      labelText = _ref$labelText === void 0 ? '' : _ref$labelText,
-      name = _ref.name,
-      _ref$onChange = _ref.onChange,
-      onChange = _ref$onChange === void 0 ? function () {} : _ref$onChange,
-      _ref$value = _ref.value,
-      value = _ref$value === void 0 ? '' : _ref$value,
-      rest = _objectWithoutProperties(_ref, _excluded);
+var RadioButton = /*#__PURE__*/React__default.forwardRef(function (props, ref) {
+  var className = props.className,
+      disabled = props.disabled,
+      hideLabel = props.hideLabel,
+      id = props.id,
+      _props$labelPosition = props.labelPosition,
+      labelPosition = _props$labelPosition === void 0 ? 'right' : _props$labelPosition,
+      _props$labelText = props.labelText,
+      labelText = _props$labelText === void 0 ? '' : _props$labelText,
+      name = props.name,
+      _props$onChange = props.onChange,
+      onChange = _props$onChange === void 0 ? function () {} : _props$onChange,
+      _props$value = props.value,
+      value = _props$value === void 0 ? '' : _props$value,
+      rest = _objectWithoutProperties(props, _excluded);
 
   var prefix = usePrefix();
   var uid = useId('radio-button');
@@ -41,6 +42,7 @@ var RadioButton = /*#__PURE__*/React__default.forwardRef(function RadioButton(_r
 
   var innerLabelClasses = cx("".concat(prefix, "--radio-button__label-text"), _defineProperty({}, "".concat(prefix, "--visually-hidden"), hideLabel));
   var wrapperClasses = cx(className, "".concat(prefix, "--radio-button-wrapper"), _defineProperty({}, "".concat(prefix, "--radio-button-wrapper--label-").concat(labelPosition), labelPosition !== 'right'));
+  var inputRef = useRef(null);
   return /*#__PURE__*/React__default.createElement("div", {
     className: wrapperClasses
   }, /*#__PURE__*/React__default.createElement("input", _extends({}, rest, {
@@ -48,7 +50,7 @@ var RadioButton = /*#__PURE__*/React__default.forwardRef(function RadioButton(_r
     className: "".concat(prefix, "--radio-button"),
     onChange: handleOnChange,
     id: uniqueId,
-    ref: ref,
+    ref: mergeRefs(inputRef, ref),
     disabled: disabled,
     value: value,
     name: name

package/es/components/RadioButtonGroup/RadioButtonGroup.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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.
+ */
+import { ReactNodeLike } from 'prop-types';
+import React from 'react';
+export declare const RadioButtonGroupContext: React.Context<null>;
+type ExcludedAttributes = 'onChange';
+export interface RadioButtonGroupProps extends Omit<React.InputHTMLAttributes<HTMLFieldSetElement>, ExcludedAttributes> {
+    /**
+     * Provide a collection of `<RadioButton>` components to render in the group
+     */
+    children?: ReactNodeLike;
+    /**
+     * Provide an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Specify the `<RadioButton>` to be selected by default
+     */
+    defaultSelected?: string | number;
+    /**
+     * Specify whether the group is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Provide text that is used alongside the control label for additional help
+     */
+    helperText?: ReactNodeLike;
+    /**
+     * Specify whether the control is currently invalid
+     */
+    invalid?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in an invalid state
+     */
+    invalidText?: ReactNodeLike;
+    /**
+     * Provide where label text should be placed
+     */
+    labelPosition?: 'left' | 'right';
+    /**
+     * Provide a legend to the RadioButtonGroup input that you are
+     * exposing to the user
+     */
+    legendText?: ReactNodeLike;
+    /**
+     * Specify the name of the underlying `<input>` nodes
+     */
+    name: string;
+    /**
+     * Provide an optional `onChange` hook that is called whenever the value of
+     * the group changes
+     */
+    onChange?: (selection: unknown, name: string, evt: unknown) => void;
+    /**
+     * Provide where radio buttons should be placed
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * Whether the RadioButtonGroup should be read-only
+     */
+    readOnly?: boolean;
+    /**
+     * Specify whether the control is currently in warning state
+     */
+    warn?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in warning state
+     */
+    warnText?: ReactNodeLike;
+    /**
+     * Specify the value that is currently selected in the group
+     */
+    valueSelected?: string | number;
+}
+declare const RadioButtonGroup: React.ForwardRefExoticComponent<RadioButtonGroupProps & React.RefAttributes<unknown>>;
+export default RadioButtonGroup;

package/es/components/RadioButtonGroup/RadioButtonGroup.js

@@ -7,30 +7,39 @@
 
 import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, defineProperty as _defineProperty, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default, { useState } from 'react';
+import React__default, { useState, useRef } from 'react';
 import cx from 'classnames';
 import { Legend } from '../Text/index.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
+import mergeRefs from '../../tools/mergeRefs.js';
 
-var _excluded = ["children", "className", "defaultSelected", "disabled", "labelPosition", "legendText", "name", "onChange", "orientation", "readOnly", "valueSelected"];
-var RadioButtonGroup = /*#__PURE__*/React__default.forwardRef(function RadioButtonGroup(_ref, ref) {
+var _excluded = ["children", "className", "defaultSelected", "disabled", "helperText", "invalid", "invalidText", "labelPosition", "legendText", "name", "onChange", "orientation", "readOnly", "valueSelected", "warn", "warnText"];
+var RadioButtonGroup = /*#__PURE__*/React__default.forwardRef(function (props, ref) {
   var _classNames;
 
-  var children = _ref.children,
-      className = _ref.className,
-      defaultSelected = _ref.defaultSelected,
-      disabled = _ref.disabled,
-      _ref$labelPosition = _ref.labelPosition,
-      labelPosition = _ref$labelPosition === void 0 ? 'right' : _ref$labelPosition,
-      legendText = _ref.legendText,
-      name = _ref.name,
-      _ref$onChange = _ref.onChange,
-      onChange = _ref$onChange === void 0 ? function () {} : _ref$onChange,
-      _ref$orientation = _ref.orientation,
-      orientation = _ref$orientation === void 0 ? 'horizontal' : _ref$orientation,
-      readOnly = _ref.readOnly,
-      valueSelected = _ref.valueSelected,
-      rest = _objectWithoutProperties(_ref, _excluded);
+  var children = props.children,
+      className = props.className,
+      defaultSelected = props.defaultSelected,
+      disabled = props.disabled,
+      helperText = props.helperText,
+      _props$invalid = props.invalid,
+      invalid = _props$invalid === void 0 ? false : _props$invalid,
+      invalidText = props.invalidText,
+      _props$labelPosition = props.labelPosition,
+      labelPosition = _props$labelPosition === void 0 ? 'right' : _props$labelPosition,
+      legendText = props.legendText,
+      name = props.name,
+      _props$onChange = props.onChange,
+      onChange = _props$onChange === void 0 ? function () {} : _props$onChange,
+      _props$orientation = props.orientation,
+      orientation = _props$orientation === void 0 ? 'horizontal' : _props$orientation,
+      readOnly = props.readOnly,
+      valueSelected = props.valueSelected,
+      _props$warn = props.warn,
+      warn = _props$warn === void 0 ? false : _props$warn,
+      warnText = props.warnText,
+      rest = _objectWithoutProperties(props, _excluded);
 
   var prefix = usePrefix();
 
@@ -56,7 +65,11 @@ var RadioButtonGroup = /*#__PURE__*/React__default.forwardRef(function RadioButt
 
   function getRadioButtons() {
     var mappedChildren = React__default.Children.map(children, function (radioButton) {
-      var value = radioButton.props.value;
+      var _props;
+
+      var _ref = (_props = radioButton === null || radioButton === void 0 ? void 0 : radioButton.props) !== null && _props !== void 0 ? _props : undefined,
+          value = _ref.value;
+
       var newProps = {
         name: name,
         key: value,
@@ -65,11 +78,13 @@ var RadioButtonGroup = /*#__PURE__*/React__default.forwardRef(function RadioButt
         checked: value === selected
       };
 
-      if (!selected && radioButton.props.checked) {
+      if (!selected && radioButton !== null && radioButton !== void 0 && radioButton.props.checked) {
         newProps.checked = true;
       }
 
-      return /*#__PURE__*/React__default.cloneElement(radioButton, newProps);
+      if (radioButton) {
+        return /*#__PURE__*/React__default.cloneElement(radioButton, newProps);
+      }
     });
     return mappedChildren;
   }
@@ -83,18 +98,36 @@ var RadioButtonGroup = /*#__PURE__*/React__default.forwardRef(function RadioButt
     }
   }
 
-  var fieldsetClasses = cx("".concat(prefix, "--radio-button-group"), (_classNames = {}, _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--").concat(orientation), orientation === 'vertical'), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--label-").concat(labelPosition), labelPosition), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--readonly"), readOnly), _classNames));
+  var showWarning = !readOnly && !invalid && warn;
+  var showHelper = !invalid && !disabled && !warn;
   var wrapperClasses = cx("".concat(prefix, "--form-item"), className);
+  var fieldsetClasses = cx("".concat(prefix, "--radio-button-group"), (_classNames = {}, _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--").concat(orientation), orientation === 'vertical'), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--label-").concat(labelPosition), labelPosition), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--readonly"), readOnly), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--invalid"), !readOnly && invalid), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--warning"), showWarning), _classNames));
+  var helperClasses = cx("".concat(prefix, "--form__helper-text"), _defineProperty({}, "".concat(prefix, "--form__helper-text--disabled"), disabled));
+  var helper = helperText ? /*#__PURE__*/React__default.createElement("div", {
+    className: helperClasses
+  }, helperText) : null;
+  var divRef = useRef(null);
   return /*#__PURE__*/React__default.createElement("div", {
     className: wrapperClasses,
-    ref: ref
+    ref: mergeRefs(divRef, ref)
   }, /*#__PURE__*/React__default.createElement("fieldset", _extends({
     className: fieldsetClasses,
     disabled: disabled,
+    "data-invalid": invalid ? true : undefined,
     "aria-readonly": readOnly
   }, rest), legendText && /*#__PURE__*/React__default.createElement(Legend, {
     className: "".concat(prefix, "--label")
-  }, legendText), getRadioButtons()));
+  }, legendText), getRadioButtons()), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(prefix, "--radio-button__validation-msg")
+  }, !readOnly && invalid && /*#__PURE__*/React__default.createElement(React__default.Fragment, null, /*#__PURE__*/React__default.createElement(WarningFilled, {
+    className: "".concat(prefix, "--radio-button__invalid-icon")
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(prefix, "--form-requirement")
+  }, invalidText)), showWarning && /*#__PURE__*/React__default.createElement(React__default.Fragment, null, /*#__PURE__*/React__default.createElement(WarningAltFilled, {
+    className: "".concat(prefix, "--radio-button__invalid-icon ").concat(prefix, "--radio-button__invalid-icon--warning")
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(prefix, "--form-requirement")
+  }, warnText)), showHelper && helper));
 });
 RadioButtonGroup.propTypes = {
   /**
@@ -117,6 +150,21 @@ RadioButtonGroup.propTypes = {
    */
   disabled: PropTypes.bool,
 
+  /**
+   * Provide text that is used alongside the control label for additional help
+   */
+  helperText: PropTypes.node,
+
+  /**
+   * Specify whether the control is currently invalid
+   */
+  invalid: PropTypes.bool,
+
+  /**
+   * Provide the text that is displayed when the control is in an invalid state
+   */
+  invalidText: PropTypes.node,
+
   /**
    * Provide where label text should be placed
    */
@@ -152,8 +200,19 @@ RadioButtonGroup.propTypes = {
   /**
    * Specify the value that is currently selected in the group
    */
-  valueSelected: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
+  valueSelected: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+
+  /**
+   * Specify whether the control is currently in warning state
+   */
+  warn: PropTypes.bool,
+
+  /**
+   * Provide the text that is displayed when the control is in warning state
+   */
+  warnText: PropTypes.node
 };
+RadioButtonGroup.displayName = 'RadioButtonGroup';
 var RadioButtonGroup$1 = RadioButtonGroup;
 
 export { RadioButtonGroup$1 as default };

package/es/components/Search/Search.Skeleton.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ */
+import PropTypes from 'prop-types';
+import React from 'react';
+export interface SearchSkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+    /**
+     * Specify whether the Search should be a small variant.
+     */
+    small?: boolean;
+}
+declare const SearchSkeleton: {
+    ({ small, className, ...rest }: SearchSkeletonProps): JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the Search should be a small variant
+         */
+        small: PropTypes.Requireable<boolean>;
+    };
+    defaultProps: {
+        small: boolean;
+    };
+};
+export default SearchSkeleton;
+export { SearchSkeleton };

package/es/components/Search/Search.js

@@ -44,7 +44,7 @@ var Search = /*#__PURE__*/React__default.forwardRef(function Search(_ref, forwar
       onKeyDown = _ref.onKeyDown,
       onExpand = _ref.onExpand,
       _ref$placeholder = _ref.placeholder,
-      placeholder = _ref$placeholder === void 0 ? '' : _ref$placeholder,
+      placeholder = _ref$placeholder === void 0 ? 'Search' : _ref$placeholder,
       renderIcon = _ref.renderIcon,
       _ref$role = _ref.role,
       role = _ref$role === void 0 ? 'searchbox' : _ref$role,
@@ -115,9 +115,10 @@ var Search = /*#__PURE__*/React__default.forwardRef(function Search(_ref, forwar
 
   return /*#__PURE__*/React__default.createElement("div", {
     role: "search",
-    "aria-labelledby": searchId,
+    "aria-label": placeholder,
     className: searchClasses
   }, /*#__PURE__*/React__default.createElement("div", {
+    "aria-labelledby": uniqueId,
     role: onExpand ? 'button' : null,
     className: "".concat(prefix, "--search-magnifier"),
     onClick: onExpand

package/es/components/Search/index.js

@@ -7,3 +7,4 @@
 
 import Search from './Search.js';
 export { default as Search, default } from './Search.js';
+export { default as SearchSkeleton } from './Search.Skeleton.js';

package/es/components/StructuredList/StructuredList.js

@@ -246,7 +246,7 @@ StructuredListInput.propTypes = {
   /**
    * Provide an optional hook that is called each time the input is updated
    */
-  onChange: deprecate(PropTypes.func, "\nThe prop `onChange` will be removed in the next major version of Carbon."),
+  onChange: PropTypes.func,
 
   /**
    * Provide a `title` for the input

package/es/components/Tabs/Tabs.js

@@ -28,7 +28,7 @@ import { ArrowRight, ArrowLeft, Home, End } from '../../internal/keyboard/keys.j
 var _ChevronLeft, _ChevronRight;
 
 var _excluded = ["activation", "aria-label", "children", "className", "contained", "iconSize", "leftOverflowButtonProps", "light", "rightOverflowButtonProps", "scrollDebounceWait", "scrollIntoView"],
-    _excluded2 = ["as", "children", "className", "disabled", "onClick", "onKeyDown"],
+    _excluded2 = ["as", "children", "className", "disabled", "onClick", "onKeyDown", "secondaryLabel", "hasSecondaryLabel"],
     _excluded3 = ["children", "className", "defaultOpen", "enterDelayMs", "leaveDelayMs", "label"],
     _excluded4 = ["children", "className"];
 
@@ -166,7 +166,10 @@ function TabList(_ref2) {
       scrollLeft = _useState6[0],
       setScrollLeft = _useState6[1];
 
-  var className = cx("".concat(prefix, "--tabs"), customClassName, (_cx = {}, _defineProperty(_cx, "".concat(prefix, "--tabs--contained"), contained), _defineProperty(_cx, "".concat(prefix, "--tabs--light"), light), _defineProperty(_cx, "".concat(prefix, "--tabs__icon--default"), iconSize === 'default'), _defineProperty(_cx, "".concat(prefix, "--tabs__icon--lg"), iconSize === 'lg'), _cx)); // Previous Button
+  var hasSecondaryLabelTabs = contained && !!React__default.Children.toArray(children).filter(function (child) {
+    return child.props.secondaryLabel;
+  }).length;
+  var className = cx("".concat(prefix, "--tabs"), customClassName, (_cx = {}, _defineProperty(_cx, "".concat(prefix, "--tabs--contained"), contained), _defineProperty(_cx, "".concat(prefix, "--tabs--light"), light), _defineProperty(_cx, "".concat(prefix, "--tabs__icon--default"), iconSize === 'default'), _defineProperty(_cx, "".concat(prefix, "--tabs__icon--lg"), iconSize === 'lg'), _defineProperty(_cx, "".concat(prefix, "--tabs--tall"), hasSecondaryLabelTabs), _cx)); // Previous Button
   // VISIBLE IF:
   //   SCROLLABLE
   //   AND SCROLL_LEFT > 0
@@ -326,7 +329,8 @@ function TabList(_ref2) {
     }, /*#__PURE__*/React__default.cloneElement(child, {
       ref: function ref(node) {
         tabs.current[index] = node;
-      }
+      },
+      hasSecondaryLabel: hasSecondaryLabelTabs
     }));
   })), /*#__PURE__*/React__default.createElement("button", _extends({
     "aria-hidden": "true",
@@ -451,6 +455,8 @@ var Tab = /*#__PURE__*/React__default.forwardRef(function Tab(_ref5, ref) {
       disabled = _ref5.disabled,
       _onClick = _ref5.onClick,
       onKeyDown = _ref5.onKeyDown,
+      secondaryLabel = _ref5.secondaryLabel,
+      hasSecondaryLabel = _ref5.hasSecondaryLabel,
       rest = _objectWithoutProperties(_ref5, _excluded2);
 
   var prefix = usePrefix();
@@ -487,7 +493,11 @@ var Tab = /*#__PURE__*/React__default.forwardRef(function Tab(_ref5, ref) {
     onKeyDown: onKeyDown,
     tabIndex: selectedIndex === index ? '0' : '-1',
     type: "button"
-  }), children);
+  }), /*#__PURE__*/React__default.createElement("span", {
+    className: "".concat(prefix, "--tabs__nav-item-label")
+  }, children), hasSecondaryLabel && /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(prefix, "--tabs__nav-item-secondary-label")
+  }, secondaryLabel));
 });
 Tab.propTypes = {
   /**
@@ -510,6 +520,11 @@ Tab.propTypes = {
    */
   disabled: PropTypes.bool,
 
+  /*
+   * Internal use only, determines wether a tab should render as a secondary label tab
+   **/
+  hasSecondaryLabel: PropTypes.bool,
+
   /**
    * Provide a handler that is invoked when a user clicks on the control
    */
@@ -525,7 +540,13 @@ Tab.propTypes = {
    * Useful for using Tab along with react-router or other client
    * side router libraries.
    **/
-  renderButton: PropTypes.func
+  renderButton: PropTypes.func,
+
+  /*
+   * An optional label to render under the primary tab label.
+  /* This prop is only useful for conained tabs
+   **/
+  secondaryLabel: PropTypes.string
 };
 var IconTab = /*#__PURE__*/React__default.forwardRef(function IconTab(_ref6, ref) {
   var children = _ref6.children,

package/es/components/TextInput/TextInput.Skeleton.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+import PropTypes from 'prop-types';
+import React from 'react';
+export interface TextInputSkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Specify an optional className to add to the form item wrapper.
+     */
+    className?: string;
+    /**
+     * Specify whether the label should be hidden or not.
+     */
+    hideLabel?: boolean;
+}
+declare const TextInputSkeleton: {
+    ({ hideLabel, className, ...rest }: TextInputSkeletonProps): JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to add to the form item wrapper.
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the label should be hidden, or not
+         */
+        hideLabel: PropTypes.Requireable<boolean>;
+    };
+};
+export default TextInputSkeleton;
+export { TextInputSkeleton };

package/es/components/TextInput/index.js

@@ -10,6 +10,7 @@ import ControlledPasswordInput from './ControlledPasswordInput.js';
 import PasswordInput from './PasswordInput.js';
 import TextInput from './TextInput.js';
 export { default as TextInput, default } from './TextInput.js';
+export { default as TextInputSkeleton } from './TextInput.Skeleton.js';
 
 TextInput.ControlledPasswordInput = ControlledPasswordInput;
 TextInput.PasswordInput = PasswordInput;