@carbon/ibm-products 2.54.0-canary.8 → 2.54.0-canary.80

package/lib/components/APIKeyModal/APIKeyModal.js

@@ -20,9 +20,10 @@ var devtools = require('../../global/js/utils/devtools.js');
 var propsHelper = require('../../global/js/utils/props-helper.js');
 var uuidv4 = require('../../global/js/utils/uuidv4.js');
 var useFocus = require('../../global/js/hooks/useFocus.js');
+var usePreviousValue = require('../../global/js/hooks/usePreviousValue.js');
 
 var _ErrorFilled, _InformationFilled;
-var _excluded = ["apiKey", "apiKeyLabel", "apiKeyName", "body", "className", "closeButtonText", "copyButtonText", "copyErrorText", "copyIconDescription", "customSteps", "downloadBodyText", "downloadFileName", "downloadFileType", "downloadLinkText", "downloadLinkLabel", "editButtonText", "editSuccess", "editSuccessTitle", "editing", "error", "errorText", "generateButtonText", "generateSuccessBody", "generateSuccessTitle", "generateTitle", "hasAPIKeyVisibilityToggle", "hasDownloadLink", "hideAPIKeyLabel", "loading", "loadingText", "modalLabel", "nameHelperText", "nameLabel", "namePlaceholder", "nameRequired", "nextStepButtonText", "onClose", "onCopy", "onRequestEdit", "onRequestGenerate", "open", "portalTarget", "previousStepButtonText", "selectorPrimaryFocus", "showAPIKeyLabel"];
+var _excluded = ["apiKey", "apiKeyLabel", "apiKeyName", "body", "className", "closeButtonText", "copyButtonText", "copyErrorText", "copyIconDescription", "customSteps", "downloadBodyText", "downloadFileName", "downloadFileType", "downloadLinkText", "downloadLinkLabel", "editButtonText", "editSuccess", "editSuccessTitle", "editSuccessMessage", "editing", "error", "errorText", "generateButtonText", "generateSuccessBody", "generateSuccessTitle", "generateSuccessMessage", "generateTitle", "hasAPIKeyVisibilityToggle", "hasDownloadLink", "hideAPIKeyLabel", "launcherButtonRef", "loading", "loadingText", "modalLabel", "nameHelperText", "nameLabel", "namePlaceholder", "nameRequired", "nextStepButtonText", "onClose", "onCopy", "onRequestEdit", "onRequestGenerate", "open", "portalTarget", "previousStepButtonText", "selectorPrimaryFocus", "showAPIKeyLabel", "helperText"];
 var componentName = 'APIKeyModal';
 
 // Default values for props
@@ -53,16 +54,19 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     editButtonText = _ref.editButtonText,
     editSuccess = _ref.editSuccess,
     editSuccessTitle = _ref.editSuccessTitle,
+    editSuccessMessage = _ref.editSuccessMessage,
     editing = _ref.editing,
     error = _ref.error,
     errorText = _ref.errorText,
     generateButtonText = _ref.generateButtonText,
     generateSuccessBody = _ref.generateSuccessBody,
     generateSuccessTitle = _ref.generateSuccessTitle,
+    generateSuccessMessage = _ref.generateSuccessMessage,
     generateTitle = _ref.generateTitle,
     hasAPIKeyVisibilityToggle = _ref.hasAPIKeyVisibilityToggle,
     hasDownloadLink = _ref.hasDownloadLink,
     hideAPIKeyLabel = _ref.hideAPIKeyLabel,
+    launcherButtonRef = _ref.launcherButtonRef,
     loading = _ref.loading,
     loadingText = _ref.loadingText,
     modalLabel = _ref.modalLabel,
@@ -80,23 +84,28 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     previousStepButtonText = _ref.previousStepButtonText,
     selectorPrimaryFocus = _ref.selectorPrimaryFocus,
     showAPIKeyLabel = _ref.showAPIKeyLabel,
+    helperText = _ref.helperText,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
   var _useState = React.useState(null),
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
     title = _useState2[0],
     setTitle = _useState2[1];
-  var _useState3 = React.useState(false),
+  var _useState3 = React.useState(null),
     _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
-    copyError = _useState4[0],
-    setCopyError = _useState4[1];
-  var _useState5 = React.useState(apiKeyName),
+    successMessage = _useState4[0],
+    setSuccessMessage = _useState4[1];
+  var _useState5 = React.useState(false),
     _useState6 = _rollupPluginBabelHelpers.slicedToArray(_useState5, 2),
-    name = _useState6[0],
-    setName = _useState6[1];
-  var _useState7 = React.useState(0),
+    copyError = _useState6[0],
+    setCopyError = _useState6[1];
+  var _useState7 = React.useState(apiKeyName),
     _useState8 = _rollupPluginBabelHelpers.slicedToArray(_useState7, 2),
-    currentStep = _useState8[0],
-    setCurrentStep = _useState8[1];
+    name = _useState8[0],
+    setName = _useState8[1];
+  var _useState9 = React.useState(0),
+    _useState10 = _rollupPluginBabelHelpers.slicedToArray(_useState9, 2),
+    currentStep = _useState10[0],
+    setCurrentStep = _useState10[1];
   var copyRef = React.useRef(undefined);
   var apiKeyInputId = React.useRef(uuidv4.default());
   var nameInputId = React.useRef(uuidv4.default());
@@ -116,33 +125,33 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   };
   var blockClass = "".concat(settings.pkg.prefix, "--apikey-modal");
   var localRef = React.useRef(undefined);
+  var PasswordInputRef = React.useRef(null);
   var modalRef = ref || localRef;
   var _useFocus = useFocus.useFocus(modalRef, selectorPrimaryFocus),
     firstElement = _useFocus.firstElement,
     keyDownListener = _useFocus.keyDownListener;
+  var prevOpen = usePreviousValue.usePreviousValue(open);
   React.useEffect(function () {
     if (copyRef.current && open && apiKeyLoaded) {
       copyRef.current.focus();
     }
+    if (PasswordInputRef !== null && PasswordInputRef !== void 0 && PasswordInputRef.current) {
+      PasswordInputRef === null || PasswordInputRef === void 0 || PasswordInputRef.current.setAttribute('readOnly', 'true');
+    }
   }, [open, apiKeyLoaded]);
   React.useEffect(function () {
     if (open) {
       // Focusing the first element or selectorPrimaryFocus element
-      if (selectorPrimaryFocus && useFocus.getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus)) {
-        var _window;
-        var specifiedEl = useFocus.getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus);
-        if (specifiedEl && ((_window = window) === null || _window === void 0 || (_window = _window.getComputedStyle(specifiedEl)) === null || _window === void 0 ? void 0 : _window.display) !== 'none') {
-          setTimeout(function () {
-            return specifiedEl.focus();
-          }, 0);
-          return;
-        }
-      }
+      useFocus.claimFocus(firstElement, modalRef, selectorPrimaryFocus);
+    }
+  }, [firstElement, modalRef, open, selectorPrimaryFocus]);
+  React.useEffect(function () {
+    if (prevOpen && !open && launcherButtonRef) {
       setTimeout(function () {
-        firstElement === null || firstElement === void 0 || firstElement.focus();
+        launcherButtonRef.current.focus();
       }, 0);
     }
-  }, [firstElement, modalRef, open, selectorPrimaryFocus]);
+  }, [launcherButtonRef, open, prevOpen]);
   var isPrimaryButtonDisabled = function isPrimaryButtonDisabled() {
     if (loading) {
       return true;
@@ -176,16 +185,18 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   };
   React.useEffect(function () {
     if (editing && editSuccess) {
-      setTitle(editSuccessTitle);
+      setTitle(generateTitle);
+      setSuccessMessage(editSuccessMessage !== null && editSuccessMessage !== void 0 ? editSuccessMessage : editSuccessTitle);
     } else if (apiKeyLoaded) {
-      setTitle(generateSuccessTitle);
+      setTitle(generateTitle);
+      setSuccessMessage(generateSuccessMessage !== null && generateSuccessMessage !== void 0 ? generateSuccessMessage : generateSuccessTitle);
     } else if (hasSteps) {
       var _customSteps$currentS2;
       setTitle((_customSteps$currentS2 = customSteps[currentStep]) === null || _customSteps$currentS2 === void 0 ? void 0 : _customSteps$currentS2.title);
     } else {
       setTitle(generateTitle);
     }
-  }, [apiKeyLoaded, editing, editSuccess, editSuccessTitle, hasSteps, generateSuccessTitle, generateTitle, currentStep, customSteps]);
+  }, [apiKeyLoaded, loading, editing, editSuccess, editSuccessTitle, editSuccessMessage, hasSteps, generateSuccessTitle, generateSuccessMessage, generateTitle, currentStep, customSteps]);
   var setNameHandler = function setNameHandler(evt) {
     setName(evt.target.value);
   };
@@ -283,7 +294,9 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     id: apiKeyInputId.current,
     showPasswordLabel: showAPIKeyLabel,
     hidePasswordLabel: hideAPIKeyLabel,
-    tooltipPosition: "left"
+    tooltipPosition: "left",
+    helperText: helperText,
+    ref: PasswordInputRef
   }), !editing && apiKey && !hasAPIKeyVisibilityToggle && /*#__PURE__*/React.createElement(react.TextInput, {
     value: apiKey,
     labelText: apiKeyLabel,
@@ -311,7 +324,9 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }, _ErrorFilled || (_ErrorFilled = /*#__PURE__*/React.createElement(icons.ErrorFilled, {
     size: 16
   }))), /*#__PURE__*/React.createElement("p", {
-    className: "".concat(blockClass, "__messaging-text")
+    className: "".concat(blockClass, "__messaging-text"),
+    role: "alert",
+    "aria-live": "assertive"
   }, copyError ? copyErrorText : errorText)), apiKeyLoaded && /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__messaging")
   }, _InformationFilled || (_InformationFilled = /*#__PURE__*/React.createElement(icons.InformationFilled, {
@@ -324,8 +339,19 @@ exports.APIKeyModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     fileType: downloadFileType,
     downloadLinkLabel: downloadLinkLabel
   }) : /*#__PURE__*/React.createElement("div", {
-    className: "".concat(blockClass, "__messaging-text")
-  }, generateSuccessBody)))), /*#__PURE__*/React.createElement(react.ModalFooter, {
+    className: "".concat(blockClass, "__messaging-text"),
+    role: "alert",
+    "aria-live": "assertive"
+  }, generateSuccessBody)), (editSuccess || apiKeyLoaded && successMessage) && /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__messaging")
+  }, /*#__PURE__*/React.createElement(icons.CheckmarkFilled, {
+    size: 16,
+    className: "".concat(blockClass, "__checkmark-icon")
+  }), /*#__PURE__*/React.createElement("p", {
+    className: "".concat(blockClass, "__messaging-text"),
+    role: "alert",
+    "aria-live": "assertive"
+  }, successMessage)))), /*#__PURE__*/React.createElement(react.ModalFooter, {
     className: "".concat(blockClass, "__footer")
   }, /*#__PURE__*/React.createElement(react.Button, {
     type: "button",
@@ -359,7 +385,19 @@ var downloadRequiredProps = function downloadRequiredProps(type) {
 
 // Return a placeholder if not released and not enabled by feature flag
 exports.APIKeyModal = settings.pkg.checkComponentEnabled(exports.APIKeyModal, componentName);
-exports.APIKeyModal.propTypes = {
+var deprecatedProps = {
+  /**
+   * deprecated
+   * title for a successful edit
+   */
+  editSuccessTitle: index.default.string,
+  /**
+   * deprecated
+   * title for a successful key generation
+   */
+  generateSuccessTitle: index.default.string
+};
+exports.APIKeyModal.propTypes = _rollupPluginBabelHelpers.objectSpread2({
   /**
    * the api key that's displayed to the user when a request to create is fulfilled.
    */
@@ -417,7 +455,7 @@ exports.APIKeyModal.propTypes = {
   /**
    * the content that appears that indicates the key is downloadable
    */
-  downloadBodyText: downloadRequiredProps(index.default.string),
+  downloadBodyText: index.default.string,
   /**
    * designates the name of downloadable json file with the key. if not specified will default to 'apikey'
    */
@@ -445,7 +483,7 @@ exports.APIKeyModal.propTypes = {
   /**
    * title for a successful edit
    */
-  editSuccessTitle: editRequiredProps(index.default.string),
+  editSuccessMessage: editRequiredProps(index.default.string),
   /**
    * designates if the modal is in the edit mode
    */
@@ -471,7 +509,7 @@ exports.APIKeyModal.propTypes = {
   /**
    * title for a successful key generation
    */
-  generateSuccessTitle: index.default.string,
+  generateSuccessMessage: index.default.string,
   /**
    * default title for the modal in generate key mode
    */
@@ -484,10 +522,19 @@ exports.APIKeyModal.propTypes = {
    * designates if user is able to download the api key
    */
   hasDownloadLink: index.default.bool,
+  /**
+   * helper text for password input
+   */
+  helperText: index.default.string,
   /**
    * label text that's displayed when hovering over visibility toggler to hide key
    */
   hideAPIKeyLabel: index.default.string,
+  /**
+   * Provide a ref to return focus to once the tearsheet is closed.
+   */
+  /**@ts-ignore */
+  launcherButtonRef: index.default.any,
   /**
    * designates if the modal is in a loading state via a request or some other in progress operation
    */
@@ -558,5 +605,7 @@ exports.APIKeyModal.propTypes = {
    * label text that's displayed when hovering over visibility toggler to show key
    */
   showAPIKeyLabel: index.default.string
-};
+}, deprecatedProps);
 exports.APIKeyModal.displayName = componentName;
+
+exports.deprecatedProps = deprecatedProps;

package/lib/components/APIKeyModal/APIKeyModal.types.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 { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 interface APIKeyModalCommonProps {
     /**
      * the api key that's displayed to the user when a request to create is fulfilled.
@@ -73,9 +73,14 @@ interface APIKeyModalCommonProps {
      */
     generateSuccessBody?: ReactNode;
     /**
+     * * @deprecated use `generateSuccessMessage` instead
      * title for a successful key generation
      */
     generateSuccessTitle?: string;
+    /**
+     * success message for a successful key generation
+     */
+    generateSuccessMessage?: string;
     /**
      * default title for the modal in generate key mode
      */
@@ -92,6 +97,10 @@ interface APIKeyModalCommonProps {
      * label text that's displayed when hovering over visibility toggler to hide key
      */
     hideAPIKeyLabel?: string;
+    /**
+     * Provide a ref to return focus to once the tearsheet is closed.
+     */
+    launcherButtonRef?: RefObject<any>;
     /**
      * designates if the modal is in a loading state via a request or some other in progress operation
      */
@@ -154,6 +163,10 @@ interface APIKeyModalCommonProps {
      * label text that's displayed when hovering over visibility toggler to show key
      */
     showAPIKeyLabel?: string;
+    /**
+     * helper text for password input
+     */
+    helperText?: string;
 }
 type CustomStepConditionalProps = {
     /**
@@ -187,9 +200,14 @@ type EditingConditionalProps = {
      */
     editSuccess: boolean;
     /**
+     * * @deprecated use `editSuccessMessage` instead
      * title for a successful edit
      */
-    editSuccessTitle: string;
+    editSuccessTitle?: string;
+    /**
+     * success message for edit
+     */
+    editSuccessMessage: string;
 };
 type HasDownloadLinkProps = {
     /**
@@ -199,7 +217,7 @@ type HasDownloadLinkProps = {
     /**
      * the content that appears that indicates the key is downloadable
      */
-    downloadBodyText: string;
+    downloadBodyText?: string;
     /**
      * designates the name of downloadable json file with the key. if not specified will default to 'apikey'
      */

package/lib/components/AboutModal/AboutModal.js

@@ -64,12 +64,9 @@ exports.AboutModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }, [bodyRef]);
   React.useEffect(function () {
     if (open) {
-      setTimeout(function () {
-        return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
-      }, 0);
+      useFocus.claimFocus(firstElement, modalRef);
     }
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [open]);
+  }, [firstElement, modalRef, open]);
   return renderPortalUse( /*#__PURE__*/React.createElement(react.unstable_FeatureFlags, {
     enableExperimentalFocusWrapWithoutSentinels: true
   }, /*#__PURE__*/React.createElement(react.ComposedModal, _rollupPluginBabelHelpers.extends({}, rest, {

package/lib/components/AddSelect/hooks/useFocus.js

@@ -40,6 +40,5 @@ var useFocus = function useFocus(size) {
   }, [handleKeyDown]);
   return [currentFocus, setCurrentFocus];
 };
-var useFocus$1 = useFocus;
 
-exports.default = useFocus$1;
+exports.default = useFocus;

package/lib/components/AddSelect/hooks/useParentSelect.js

@@ -22,6 +22,5 @@ var useParentSelect = function useParentSelect() {
     setParentSelected: setParentSelected
   };
 };
-var useParentSelect$1 = useParentSelect;
 
-exports.default = useParentSelect$1;
+exports.default = useParentSelect;

package/lib/components/AddSelect/hooks/usePath.js

@@ -70,6 +70,5 @@ var usePath = function usePath() {
     resetPath: resetPath
   };
 };
-var usePath$1 = usePath;
 
-exports.default = usePath$1;
+exports.default = usePath;

package/lib/components/BreadcrumbWithOverflow/BreadcrumbWithOverflow.js

@@ -63,12 +63,20 @@ exports.BreadcrumbWithOverflow = function BreadcrumbWithOverflow(_ref) {
   // eslint-disable-next-line react/prop-types
   var BreadcrumbOverflowMenu = function BreadcrumbOverflowMenu(_ref2) {
     var overflowItems = _ref2.overflowItems;
+    var handleClick = function handleClick(evt, item) {
+      var _item$props, _item$props2, _item$props2$onClick;
+      if (item !== null && item !== void 0 && (_item$props = item.props) !== null && _item$props !== void 0 && _item$props.href) {
+        window.location.href = item.props.href;
+      }
+      item === null || item === void 0 || (_item$props2 = item.props) === null || _item$props2 === void 0 || (_item$props2$onClick = _item$props2.onClick) === null || _item$props2$onClick === void 0 || _item$props2$onClick.call(_item$props2, evt);
+    };
     return /*#__PURE__*/React.createElement(react.BreadcrumbItem, {
       key: "breadcrumb-overflow-".concat(internalId.current)
+    }, /*#__PURE__*/React.createElement(react.unstable_FeatureFlags, {
+      enableV12Overflowmenu: true
     }, /*#__PURE__*/React.createElement(react.OverflowMenu, {
-      align: overflowTooltipAlign,
       "aria-label": overflowAriaLabel,
-      iconDescription: overflowAriaLabel // also needs setting to avoid a11y "Accessible name does not match or contain the visible label text"
+      label: overflowAriaLabel // also needs setting to avoid a11y "Accessible name does not match or contain the visible label text"
       ,
       renderIcon: function renderIcon(props) {
         return /*#__PURE__*/React.createElement(icons.OverflowMenuHorizontal, _rollupPluginBabelHelpers.extends({
@@ -76,17 +84,18 @@ exports.BreadcrumbWithOverflow = function BreadcrumbWithOverflow(_ref) {
         }, props));
       },
       className: "".concat(blockClass, "__overflow-menu"),
-      menuOptionsClass: "".concat(blockClass, "__overflow-menu-options")
+      tooltipAlignment: overflowTooltipAlign
     },
     // eslint-disable-next-line react/prop-types
     overflowItems.map(function (item, index) {
-      return /*#__PURE__*/React.createElement(react.OverflowMenuItem, {
+      return /*#__PURE__*/React.createElement(react.MenuItem, {
         key: "breadcrumb-overflow-menu-item-".concat(internalId.current, "-").concat(index),
-        href: item.props.href,
-        onClick: item.props.onClick,
-        itemText: item.props.children
+        onClick: function onClick(evt) {
+          return handleClick(evt, item);
+        },
+        label: item.props.children
       });
-    })));
+    }))));
   };
 
   // create hidden sizing items

package/lib/components/Card/Card.d.ts

@@ -58,13 +58,13 @@ interface CardProp extends PropsWithChildren {
     iconDescription?: string;
     /**
      * Clickable tiles only accept a boolean value of true and display a hollow slug.
-     * @deprecated please use the `aiLabel` prop
+     * @deprecated please use the `decorator` prop
      */
     slug?: ReactNode | boolean;
     /**
-     * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
+     * Optional prop that allows you to pass any component.
      */
-    aiLabel?: ReactNode | boolean;
+    decorator?: ReactNode | boolean;
     status?: 'complete' | 'incomplete';
     title?: ReactNode;
     titleSize?: 'default' | 'large';

package/lib/components/Card/Card.js

@@ -18,7 +18,7 @@ var CardFooter = require('./CardFooter.js');
 var settings = require('../../settings.js');
 
 var _Incomplete, _CheckmarkOutline;
-var _excluded = ["actionIcons", "actionsPlacement", "aiLabel", "metadata", "children", "className", "clickZone", "description", "disabled", "footerActionIcon", "getStarted", "label", "media", "mediaPosition", "onClick", "onKeyDown", "onPrimaryButtonClick", "overflowActions", "overflowAriaLabel", "onSecondaryButtonClick", "pictogram", "primaryButtonDisabled", "primaryButtonHref", "primaryButtonIcon", "primaryButtonKind", "primaryButtonPlacement", "primaryButtonText", "productive", "secondaryButtonDisabled", "secondaryButtonHref", "secondaryButtonIcon", "secondaryButtonKind", "secondaryButtonPlacement", "secondaryButtonText", "slug", "status", "sequence", "title", "titleSize", "iconDescription"],
+var _excluded = ["actionIcons", "actionsPlacement", "decorator", "metadata", "children", "className", "clickZone", "description", "disabled", "footerActionIcon", "getStarted", "label", "media", "mediaPosition", "onClick", "onKeyDown", "onPrimaryButtonClick", "onSecondaryButtonClick", "overflowActions", "overflowAriaLabel", "pictogram", "primaryButtonDisabled", "primaryButtonHref", "primaryButtonIcon", "primaryButtonKind", "primaryButtonPlacement", "primaryButtonText", "productive", "secondaryButtonDisabled", "secondaryButtonHref", "secondaryButtonIcon", "secondaryButtonKind", "secondaryButtonPlacement", "secondaryButtonText", "slug", "status", "sequence", "title", "titleSize", "iconDescription"],
   _excluded2 = ["id", "itemText"],
   _excluded3 = ["id", "icon", "onClick", "iconDescription", "href"];
 var componentName = 'Card';
@@ -27,7 +27,7 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     actionIcons = _ref$actionIcons === void 0 ? Object.freeze([]) : _ref$actionIcons,
     _ref$actionsPlacement = _ref.actionsPlacement,
     actionsPlacement = _ref$actionsPlacement === void 0 ? 'bottom' : _ref$actionsPlacement,
-    aiLabel = _ref.aiLabel,
+    decorator = _ref.decorator,
     _ref$metadata = _ref.metadata,
     metadata = _ref$metadata === void 0 ? Object.freeze([]) : _ref$metadata,
     children = _ref.children,
@@ -45,10 +45,10 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     onClick = _ref.onClick,
     onKeyDown = _ref.onKeyDown,
     onPrimaryButtonClick = _ref.onPrimaryButtonClick,
+    onSecondaryButtonClick = _ref.onSecondaryButtonClick,
     _ref$overflowActions = _ref.overflowActions,
     overflowActions = _ref$overflowActions === void 0 ? Object.freeze([]) : _ref$overflowActions,
     overflowAriaLabel = _ref.overflowAriaLabel,
-    onSecondaryButtonClick = _ref.onSecondaryButtonClick,
     Pictogram = _ref.pictogram,
     primaryButtonDisabled = _ref.primaryButtonDisabled,
     primaryButtonHref = _ref.primaryButtonHref,
@@ -107,8 +107,7 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
         autoAlign: true,
         menuAlignment: pos,
         size: size,
-        "aria-label": overflowAriaLabel,
-        label: iconDescription
+        label: overflowAriaLabel || iconDescription
       }, overflowActions.map(function (_ref2) {
         var id = _ref2.id,
           itemText = _ref2.itemText,
@@ -170,10 +169,11 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     return icons;
   };
   var getCardProps = function getCardProps() {
+    var _decorator$type, _decorator$type2;
     var clickable = hasClickEvent && !productive || hasClickEvent && productive && clickZone === 'one';
     var cardProps = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, rest), {}, {
       ref: ref,
-      className: cx(blockClass, _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(blockClass, "__disabled"), disabled), "".concat(blockClass, "__get-started"), getStarted), "".concat(blockClass, "__productive"), productive), "".concat(blockClass, "__clickable"), clickable), "".concat(blockClass, "__media-left"), mediaPosition === 'left'), "".concat(blockClass, "--has-slug"), !!slug), "".concat(blockClass, "--has-ai-label"), !!aiLabel), className)
+      className: cx(blockClass, _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(blockClass, "__disabled"), disabled), "".concat(blockClass, "__get-started"), getStarted), "".concat(blockClass, "__productive"), productive), "".concat(blockClass, "__clickable"), clickable), "".concat(blockClass, "__media-left"), mediaPosition === 'left'), "".concat(blockClass, "--has-slug"), !!slug), "".concat(blockClass, "--has-decorator"), !!decorator && ((_decorator$type = decorator['type']) === null || _decorator$type === void 0 ? void 0 : _decorator$type.displayName) !== 'AILabel'), "".concat(blockClass, "--has-ai-label"), !!decorator && ((_decorator$type2 = decorator['type']) === null || _decorator$type2 === void 0 ? void 0 : _decorator$type2.displayName) === 'AILabel'), className)
     }, clickable && clickableProps);
     return cardProps;
   };
@@ -189,7 +189,7 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var getHeaderProps = function getHeaderProps() {
     return {
       actions: actionsPlacement === 'top' ? getActions() : '',
-      aiLabel: aiLabel,
+      decorator: decorator,
       noActionIcons: getIcons().length > 0 && actionsPlacement === 'top' ? false : true,
       actionsPlacement: actionsPlacement,
       onPrimaryButtonClick: onPrimaryButtonClick,
@@ -273,13 +273,13 @@ Card.propTypes = {
     href: index.default.string
   })),
   actionsPlacement: index.default.oneOf(['top', 'bottom']),
-  /**
-   * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
-   */
-  aiLabel: index.default.oneOfType([index.default.node, index.default.bool]),
   children: index.default.node,
   className: index.default.string,
   clickZone: index.default.oneOf(['one', 'two', 'three']),
+  /**
+   * Optional prop that allows you to pass any component.
+   */
+  decorator: index.default.oneOfType([index.default.node, index.default.bool]),
   /**@ts-ignore */
   description: index.default.oneOfType([index.default.string, index.default.node]),
   disabled: index.default.bool,
@@ -328,7 +328,7 @@ Card.propTypes = {
   /**
    * **Experimental:** For all cases a `Slug` component can be provided.
    * Clickable tiles only accept a boolean value of true and display a hollow slug.
-   * @deprecated please use the `aiLabel` prop
+   * @deprecated please use the `decorator` prop
    */
   slug: index.default.oneOfType([index.default.node, index.default.bool]),
   status: index.default.oneOf(['complete', 'incomplete']),

package/lib/components/Card/CardHeader.d.ts

@@ -3,9 +3,9 @@ import PropTypes from 'prop-types';
 interface CardHeaderProps {
     actions?: ReactNode;
     /**
-     * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
+     * Optional prop that allows you to pass any component.
      */
-    aiLabel?: ReactNode | boolean;
+    decorator?: ReactNode | boolean;
     description?: ReactNode;
     hasActions?: boolean;
     /**
@@ -29,21 +29,21 @@ interface CardHeaderProps {
     /**
      * **Experimental:** For all cases a `Slug` component can be provided.
      * Clickable tiles only accept a boolean value of true and display a hollow slug.
-     * @deprecated please use the `aiLabel` prop
+     * @deprecated please use the `decorator` prop
      */
     slug?: ReactNode;
     title?: ReactNode;
     titleSize?: 'default' | 'large';
 }
 export declare const CardHeader: {
-    ({ actions, aiLabel, noActionIcons, onPrimaryButtonClick, onSecondaryButtonClick, primaryButtonIcon, primaryButtonPlacement, primaryButtonText, primaryButtonDisabled, description, hasActions, inClickableCard, label, secondaryButtonDisabled, secondaryButtonHref, secondaryButtonIcon, secondaryButtonPlacement, secondaryButtonText, slug, title, titleSize, }: CardHeaderProps): React.JSX.Element;
+    ({ actions, decorator, noActionIcons, onPrimaryButtonClick, onSecondaryButtonClick, primaryButtonIcon, primaryButtonPlacement, primaryButtonText, primaryButtonDisabled, description, hasActions, inClickableCard, label, secondaryButtonDisabled, secondaryButtonHref, secondaryButtonIcon, secondaryButtonPlacement, secondaryButtonText, slug, title, titleSize, }: CardHeaderProps): React.JSX.Element;
     /**@ts-ignore */
     propTypes: {
         actions: PropTypes.Requireable<NonNullable<any[] | PropTypes.ReactNodeLike>>;
         /**
-         * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
+         * Optional prop that allows you to pass any component.
          */
-        aiLabel: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
+        decorator: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
         description: PropTypes.Requireable<NonNullable<object | PropTypes.ReactNodeLike>>;
         hasActions: PropTypes.Requireable<boolean>;
         /**
@@ -67,7 +67,7 @@ export declare const CardHeader: {
         /**
          * **Experimental:** For all cases a `Slug` component can be provided.
          * Clickable tiles only accept a boolean value of true and display a hollow slug.
-         * @deprecated please use the `aiLabel` prop
+         * @deprecated please use the `decorator` prop
          */
         slug: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
         title: PropTypes.Requireable<NonNullable<object | PropTypes.ReactNodeLike>>;

package/lib/components/Card/CardHeader.js

@@ -22,7 +22,7 @@ var defaults = {
 };
 var CardHeader = function CardHeader(_ref) {
   var actions = _ref.actions,
-    aiLabel = _ref.aiLabel,
+    decorator = _ref.decorator,
     noActionIcons = _ref.noActionIcons,
     onPrimaryButtonClick = _ref.onPrimaryButtonClick,
     onSecondaryButtonClick = _ref.onSecondaryButtonClick,
@@ -67,13 +67,13 @@ var CardHeader = function CardHeader(_ref) {
     d: "M13.2436 16H11.5996L10.9276 13.864H7.95164L7.29164 16H5.68364L8.49164 7.624H10.4596L13.2436 16ZM10.5436 12.508L9.46364 9.064H9.40364L8.33564 12.508H10.5436ZM17.9341 16H14.1301V14.728H15.2341V8.896H14.1301V7.624H17.9341V8.896H16.8181V14.728H17.9341V16Z",
     fill: "#161616"
   })));
-  var normalizedAiLabel = null;
-  if (aiLabel || slug) {
-    if (inClickableCard || typeof aiLabel === 'boolean' || typeof slug === 'boolean') {
-      normalizedAiLabel = hollowAiIcon;
+  var normalizedDecorator = null;
+  if (decorator || slug) {
+    if (inClickableCard || typeof decorator === 'boolean' || typeof slug === 'boolean') {
+      normalizedDecorator = hollowAiIcon;
     } else {
-      var element = aiLabel || slug;
-      normalizedAiLabel = /*#__PURE__*/React.cloneElement(element, {
+      var element = decorator || slug;
+      normalizedDecorator = /*#__PURE__*/React.cloneElement(element, {
         size: label && title || title && titleSize === 'large' ? 'sm' : 'xs'
       });
     }
@@ -81,7 +81,7 @@ var CardHeader = function CardHeader(_ref) {
   return /*#__PURE__*/React.createElement("div", {
     className: headerClasses
   }, /*#__PURE__*/React.createElement("div", {
-    className: cx(["".concat(headerClass, "-container"), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--has-slug"), !!slug), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--has-ai-label"), !!aiLabel), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--has-actions"), !!hasActions), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--large-tile-or-label"), title && (label || titleSize === 'large'))])
+    className: cx(["".concat(headerClass, "-container"), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--has-slug"), !!slug), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--has-decorator"), !!decorator), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--has-actions"), !!hasActions), _rollupPluginBabelHelpers.defineProperty({}, "".concat(headerClass, "-container--large-tile-or-label"), title && (label || titleSize === 'large'))])
   }, /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__title-container")
   }, label && /*#__PURE__*/React.createElement("p", {
@@ -107,15 +107,17 @@ var CardHeader = function CardHeader(_ref) {
     onClick: onPrimaryButtonClick,
     className: actionGhostButtonClass,
     disabled: primaryButtonDisabled
-  }, primaryButtonText)), normalizedAiLabel));
+  }, primaryButtonText)), slug ? normalizedDecorator : decorator ? /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__header__inner-wrapper--decorator")
+  }, normalizedDecorator) : ''));
 };
 /**@ts-ignore */
 CardHeader.propTypes = {
   actions: index.default.oneOfType([index.default.array, index.default.node]),
   /**
-   * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
+   * Optional prop that allows you to pass any component.
    */
-  aiLabel: index.default.oneOfType([index.default.node, index.default.bool]),
+  decorator: index.default.oneOfType([index.default.node, index.default.bool]),
   description: index.default.oneOfType([index.default.string, index.default.object, index.default.node]),
   hasActions: index.default.bool,
   /**
@@ -139,7 +141,7 @@ CardHeader.propTypes = {
   /**
    * **Experimental:** For all cases a `Slug` component can be provided.
    * Clickable tiles only accept a boolean value of true and display a hollow slug.
-   * @deprecated please use the `aiLabel` prop
+   * @deprecated please use the `decorator` prop
    */
   slug: index.default.oneOfType([index.default.node, index.default.bool]),
   title: index.default.oneOfType([index.default.string, index.default.object, index.default.node]),