@carbon/ibm-products 2.17.1 → 2.18.0

package/es/components/Datagrid/useFocusRowExpander.js

@@ -0,0 +1,40 @@
+/**
+ * Copyright IBM Corp. 2023, 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 { useEffect } from 'react';
+
+// Focuses the row expander after a nested/expandable row state change.
+// We have to add this workaround because react-table is re-rendering the entire row
+// which removes the focus from the expander and interrupts the keyboard navigation
+// flow.
+export var useFocusRowExpander = function useFocusRowExpander(_ref) {
+  var instance = _ref.instance,
+    _ref$lastExpandedRowI = _ref.lastExpandedRowIndex,
+    lastExpandedRowIndex = _ref$lastExpandedRowI === void 0 ? 0 : _ref$lastExpandedRowI,
+    blockClass = _ref.blockClass,
+    activeElement = _ref.activeElement;
+  useEffect(function () {
+    // We need to return at this point so that the focus is not stolen from
+    // other interactive elements in the Datagrid
+    if (!activeElement.classList.contains("".concat(blockClass, "__row-expander"))) {
+      return;
+    }
+    var tableId = instance === null || instance === void 0 ? void 0 : instance.tableId;
+    var rowElements = document.querySelectorAll("#".concat(tableId, " tbody tr"));
+    var rowElementsArray = Array.from(rowElements);
+    var activeRow = rowElementsArray.filter(function (r) {
+      if (r.getAttribute('data-nested-row-id') === lastExpandedRowIndex) {
+        return r;
+      }
+      return null;
+    });
+    if (activeRow.length) {
+      var rowExpander = activeRow[0].querySelector(".".concat(blockClass, "__row-expander"));
+      rowExpander.focus();
+    }
+  }, [instance === null || instance === void 0 ? void 0 : instance.tableId, instance === null || instance === void 0 ? void 0 : instance.expandedRows, lastExpandedRowIndex, blockClass, activeElement]);
+};

package/es/components/Datagrid/useNestedRowExpander.js

@@ -15,12 +15,20 @@ import React, { useRef } from 'react';
 import { ChevronRight } from '@carbon/react/icons';
 import cx from 'classnames';
 import { pkg, carbon } from '../../settings';
+import { useFocusRowExpander } from './useFocusRowExpander';
 var blockClass = "".concat(pkg.prefix, "--datagrid");
 var useNestedRowExpander = function useNestedRowExpander(hooks) {
   var tempState = useRef();
+  var lastExpandedRowIndex = useRef();
   var useInstance = function useInstance(instance) {
     tempState.current = instance;
   };
+  useFocusRowExpander({
+    instance: tempState === null || tempState === void 0 ? void 0 : tempState.current,
+    lastExpandedRowIndex: lastExpandedRowIndex === null || lastExpandedRowIndex === void 0 ? void 0 : lastExpandedRowIndex.current,
+    blockClass: blockClass,
+    activeElement: document.activeElement
+  });
   var visibleColumns = function visibleColumns(columns) {
     var expanderColumn = {
       id: 'expander',
@@ -32,6 +40,7 @@ var useNestedRowExpander = function useNestedRowExpander(hooks) {
             // Prevents `onRowClick` from being called if `useOnRowClick` is included
             event.stopPropagation();
             row.toggleRowExpanded();
+            lastExpandedRowIndex.current = row.id;
           }
         });
         var _ref2 = (tempState === null || tempState === void 0 ? void 0 : tempState.current) || {},

package/es/components/Datagrid/useNestedRows.js

@@ -6,15 +6,11 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
  * LICENSE file in the root directory of this source tree.
  */
 
-import { useEffect } from 'react';
-import { pkg } from '../../settings';
 import cx from 'classnames';
+import { pkg } from '../../settings';
 import useNestedRowExpander from './useNestedRowExpander';
 var blockClass = "".concat(pkg.prefix, "--datagrid");
 var useNestedRows = function useNestedRows(hooks) {
-  useEffect(function () {
-    pkg.checkReportFeatureEnabled('Datagrid.useNestedRows');
-  }, []);
   useNestedRowExpander(hooks);
   var marginLeft = 24;
   var getRowProps = function getRowProps(props, _ref) {

package/es/components/Datagrid/useRowExpander.js

@@ -15,12 +15,20 @@ import React, { useRef } from 'react';
 import { ChevronDown, ChevronUp } from '@carbon/react/icons';
 import { pkg, carbon } from '../../settings';
 import cx from 'classnames';
+import { useFocusRowExpander } from './useFocusRowExpander';
 var blockClass = "".concat(pkg.prefix, "--datagrid");
 var useRowExpander = function useRowExpander(hooks) {
   var tempState = useRef();
+  var lastExpandedRowIndex = useRef();
   var useInstance = function useInstance(instance) {
     tempState.current = instance;
   };
+  useFocusRowExpander({
+    instance: tempState === null || tempState === void 0 ? void 0 : tempState.current,
+    lastExpandedRowIndex: lastExpandedRowIndex === null || lastExpandedRowIndex === void 0 ? void 0 : lastExpandedRowIndex.current,
+    blockClass: blockClass,
+    activeElement: document.activeElement
+  });
   var visibleColumns = function visibleColumns(columns) {
     var expanderColumn = {
       id: 'expander',
@@ -31,6 +39,7 @@ var useRowExpander = function useRowExpander(hooks) {
             // Prevents `onRowClick` from being called if `useOnRowClick` is included
             event.stopPropagation();
             row.toggleRowExpanded();
+            lastExpandedRowIndex.current = row.id;
           }
         });
         var _ref2 = (tempState === null || tempState === void 0 ? void 0 : tempState.current) || {},

package/es/components/Datagrid/useSelectRows.js

@@ -42,7 +42,14 @@ var useSelectRows = function useSelectRows(hooks) {
     });
   });
   hooks.visibleColumns.push(function (columns) {
-    return [{
+    // Ensures that the first column is the row expander in the
+    // case of selected rows and expandable rows being used together
+    var newColOrder = _toConsumableArray(columns);
+    var expanderColumnIndex = newColOrder.findIndex(function (col) {
+      return col.id === 'expander';
+    });
+    var expanderCol = expanderColumnIndex > -1 ? newColOrder.splice(expanderColumnIndex, 1) : [];
+    return [].concat(_toConsumableArray(expanderColumnIndex > -1 && expanderCol && expanderCol.length ? expanderCol : []), [{
       id: selectionColumnId,
       Header: function Header(gridState) {
         return /*#__PURE__*/React.createElement(SelectAll, gridState);
@@ -50,7 +57,7 @@ var useSelectRows = function useSelectRows(hooks) {
       Cell: function Cell(gridState) {
         return /*#__PURE__*/React.createElement(SelectRow, gridState);
       }
-    }].concat(_toConsumableArray(columns));
+    }], _toConsumableArray(newColOrder));
   });
 };
 var useHighlightSelection = function useHighlightSelection(hooks) {

package/es/components/Datagrid/utils/handleFilterTagLabelText.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+
+// Example usage for custom filter tag labels, in practice this
+// is where a translation service would be utilized. This
+// utility is for storybook demonstration purposes only.
+export var handleFilterTagLabelText = function handleFilterTagLabelText(key, value) {
+  switch (key) {
+    case 'role':
+      return "Role: ".concat(value);
+    case 'joined':
+      return "Joined: ".concat(value);
+    case 'visits':
+      return "Visits: ".concat(value);
+    case 'passwordStrength':
+      return "Password strength: ".concat(value);
+    case 'status':
+      return "Status: ".concat(value);
+    default:
+      return "".concat(key, ": ").concat(value);
+  }
+};

package/es/components/EditSidePanel/EditSidePanel.js

@@ -1,7 +1,7 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["children", "className", "disableSubmit", "formTitle", "formDescription", "onRequestClose", "onRequestSubmit", "open", "placement", "primaryButtonText", "secondaryButtonText", "selectorPrimaryFocus", "selectorPageContent", "size", "slideIn", "subtitle", "title"];
+var _excluded = ["children", "className", "disableSubmit", "id", "formTitle", "formDescription", "onRequestClose", "onRequestSubmit", "open", "placement", "primaryButtonText", "secondaryButtonText", "selectorPrimaryFocus", "selectorPageContent", "size", "slideIn", "subtitle", "title"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /**
@@ -45,6 +45,7 @@ export var EditSidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var children = _ref.children,
     className = _ref.className,
     disableSubmit = _ref.disableSubmit,
+    id = _ref.id,
     formTitle = _ref.formTitle,
     formDescription = _ref.formDescription,
     onRequestClose = _ref.onRequestClose,
@@ -84,7 +85,8 @@ export var EditSidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     onRequestClose: onRequestClose,
     title: title,
     subtitle: subtitle,
-    selectorPrimaryFocus: selectorPrimaryFocus
+    selectorPrimaryFocus: selectorPrimaryFocus,
+    id: id
   }, getDevtoolsProps(componentName)), {
     placement: placement,
     slideIn: slideIn,
@@ -136,6 +138,10 @@ EditSidePanel.propTypes = {
    * Specifies a required field that provides a title for a form
    */
   formTitle: PropTypes.node.isRequired,
+  /**
+   * Unique identifier
+   */
+  id: PropTypes.string,
   /**
    * Specifies an optional handler which is called when the CreateSidePanel
    * is closed.

package/es/components/FilterSummary/FilterSummary.js

@@ -4,19 +4,21 @@ var _excluded = ["key", "value"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /**
- * Copyright IBM Corp. 2022, 2022
+ * Copyright IBM Corp. 2022, 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 { Button } from '@carbon/react';
-import React from 'react';
+import React, { useRef } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { TagSet } from '../TagSet';
 import { pkg } from '../../settings';
+import uuidv4 from '../../global/js/utils/uuidv4';
 var blockClass = "".concat(pkg.prefix, "--filter-summary");
 var FilterSummary = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var _filterSummaryClearBu;
   var _ref$className = _ref.className,
     className = _ref$className === void 0 ? '' : _ref$className,
     _ref$clearFiltersText = _ref.clearFiltersText,
@@ -28,7 +30,10 @@ var FilterSummary = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _ref$renderLabel = _ref.renderLabel,
     renderLabel = _ref$renderLabel === void 0 ? null : _ref$renderLabel,
     _ref$overflowType = _ref.overflowType,
-    overflowType = _ref$overflowType === void 0 ? 'default' : _ref$overflowType;
+    overflowType = _ref$overflowType === void 0 ? 'default' : _ref$overflowType,
+    _ref$clearButtonInlin = _ref.clearButtonInline,
+    clearButtonInline = _ref$clearButtonInlin === void 0 ? true : _ref$clearButtonInlin;
+  var filterSummaryId = "".concat(blockClass, "__").concat(uuidv4());
   var tagFilters = filters.map(function (_ref2) {
     var _renderLabel;
     var key = _ref2.key,
@@ -39,26 +44,35 @@ var FilterSummary = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       label: (_renderLabel = renderLabel === null || renderLabel === void 0 ? void 0 : renderLabel(key, value)) !== null && _renderLabel !== void 0 ? _renderLabel : "".concat(key, ": ").concat(value)
     });
   });
+  var filterSummaryClearButton = useRef();
+  var filterSummaryRef = useRef();
+  var localRef = filterSummaryRef || ref;
   return /*#__PURE__*/React.createElement("div", {
-    ref: ref,
-    className: cx([blockClass, className])
+    ref: localRef,
+    className: cx([blockClass, className]),
+    id: filterSummaryId
   }, /*#__PURE__*/React.createElement(TagSet, {
     allTagsModalSearchLabel: "Search all tags",
     allTagsModalSearchPlaceholderText: "Search all tags",
     allTagsModalTitle: "All tags",
     showAllTagsLabel: "View all tags",
     tags: tagFilters,
-    overflowType: overflowType
+    overflowType: overflowType,
+    className: cx(_defineProperty({}, "".concat(blockClass, "__clear-button-inline"), clearButtonInline)),
+    containingElementRef: localRef,
+    measurementOffset: filterSummaryClearButton === null || filterSummaryClearButton === void 0 || (_filterSummaryClearBu = filterSummaryClearButton.current) === null || _filterSummaryClearBu === void 0 ? void 0 : _filterSummaryClearBu.offsetWidth
   }), /*#__PURE__*/React.createElement(Button, {
     kind: "ghost",
     size: "sm",
-    onClick: clearFilters
+    onClick: clearFilters,
+    ref: filterSummaryClearButton
   }, clearFiltersText));
 });
 var componentName = 'FilterSummary';
 FilterSummary.displayName = componentName;
 FilterSummary.propTypes = {
   className: PropTypes.string,
+  clearButtonInline: PropTypes.bool,
   clearFilters: PropTypes.func.isRequired,
   clearFiltersText: PropTypes.string,
   filters: PropTypes.arrayOf(PropTypes.object).isRequired,

package/es/components/Guidebanner/Guidebanner.docs-page.js

@@ -0,0 +1,15 @@
+import React from 'react';
+import { StoryDocsPage } from '../../global/js/utils/StoryDocsPage';
+import * as stories from './Guidebanner.stories';
+var DocsPage = function DocsPage() {
+  return /*#__PURE__*/React.createElement(StoryDocsPage, {
+    blocks: [{
+      story: stories.collapsible
+    }, {
+      story: stories.manyInsights
+    }, {
+      story: stories.fewInsights
+    }]
+  });
+};
+export default DocsPage;

package/es/components/Guidebanner/Guidebanner.js

@@ -0,0 +1,221 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["children", "className", "collapsible", "onClose", "closeIconDescription", "collapseButtonLabel", "expandButtonLabel", "nextIconDescription", "previousIconDescription", "title"];
+/**
+ * Copyright IBM Corp. 2023, 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 portions of React that are needed.
+import React, { useRef, useState } from 'react';
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { blue90, purple70 } from '@carbon/colors';
+import { CaretLeft, CaretRight, Close, Idea } from '@carbon/react/icons';
+import { Button, IconButton } from '@carbon/react';
+import { Carousel } from '../Carousel';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg } from '../../settings';
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(pkg.prefix, "--guidebanner");
+var componentName = 'Guidebanner';
+var defaults = {
+  collapsible: false,
+  // Labels
+  closeIconDescription: 'Close',
+  collapseButtonLabel: 'Read less',
+  expandButtonLabel: 'Read more',
+  nextIconDescription: 'Next',
+  previousIconDescription: 'Back'
+};
+
+/**
+ * The guide banner sits at the top of a page, or page-level tab,
+ * to introduce foundational concepts related to the page's content.
+ */
+export var Guidebanner = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var children = _ref.children,
+    className = _ref.className,
+    _ref$collapsible = _ref.collapsible,
+    collapsible = _ref$collapsible === void 0 ? defaults.collapsible : _ref$collapsible,
+    onClose = _ref.onClose,
+    _ref$closeIconDescrip = _ref.closeIconDescription,
+    closeIconDescription = _ref$closeIconDescrip === void 0 ? defaults.closeIconDescription : _ref$closeIconDescrip,
+    _ref$collapseButtonLa = _ref.collapseButtonLabel,
+    collapseButtonLabel = _ref$collapseButtonLa === void 0 ? defaults.collapseButtonLabel : _ref$collapseButtonLa,
+    _ref$expandButtonLabe = _ref.expandButtonLabel,
+    expandButtonLabel = _ref$expandButtonLabe === void 0 ? defaults.expandButtonLabel : _ref$expandButtonLabe,
+    _ref$nextIconDescript = _ref.nextIconDescription,
+    nextIconDescription = _ref$nextIconDescript === void 0 ? defaults.nextIconDescription : _ref$nextIconDescript,
+    _ref$previousIconDesc = _ref.previousIconDescription,
+    previousIconDescription = _ref$previousIconDesc === void 0 ? defaults.previousIconDescription : _ref$previousIconDesc,
+    title = _ref.title,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var scrollRef = useRef();
+  var toggleRef = useRef();
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    scrollPosition = _useState2[0],
+    setScrollPosition = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    showNavigation = _useState4[0],
+    setShowNavigation = _useState4[1];
+  var _useState5 = useState(collapsible ? true : false),
+    _useState6 = _slicedToArray(_useState5, 2),
+    isCollapsed = _useState6[0],
+    setIsCollapsed = _useState6[1];
+  var handleClickToggle = function handleClickToggle() {
+    setIsCollapsed(function (prevState) {
+      return !prevState;
+    });
+  };
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    "aria-expanded": !isCollapsed,
+    className: cx(blockClass, className, [collapsible ? "".concat(blockClass, "__collapsible") : null], [isCollapsed ? "".concat(blockClass, "__collapsible-collapsed") : null]),
+    ref: ref
+  }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(Idea, {
+    size: 20,
+    className: "".concat(blockClass, "__icon-idea")
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__title")
+  }, title), /*#__PURE__*/React.createElement(Carousel, {
+    className: "".concat(blockClass, "__carousel")
+    // These colors are to match the Carousel's faded edges
+    // against the Guidebanner's gradient background.
+    ,
+    fadedEdgeColor: {
+      left: blue90,
+      right: purple70
+    },
+    ref: scrollRef,
+    onChangeIsScrollable: function onChangeIsScrollable(value) {
+      setShowNavigation(value);
+    },
+    onScroll: function onScroll(scrollPercent) {
+      setScrollPosition(scrollPercent);
+    }
+  }, children), /*#__PURE__*/React.createElement("div", {
+    className: cx([collapsible || showNavigation ? "".concat(blockClass, "__navigation") : null])
+  }, collapsible && /*#__PURE__*/React.createElement(Button, {
+    kind: "ghost",
+    size: "md",
+    className: "".concat(blockClass, "__toggle-button"),
+    onClick: handleClickToggle,
+    ref: toggleRef
+  }, isCollapsed ? expandButtonLabel : collapseButtonLabel), showNavigation && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
+    className: cx("".concat(blockClass, "__back-button"), [scrollPosition === 0 ? "".concat(blockClass, "__back-button--disabled") : null])
+  }, /*#__PURE__*/React.createElement(IconButton, {
+    align: "top",
+    disabled: scrollPosition === 0,
+    kind: "ghost",
+    label: previousIconDescription,
+    onClick: function onClick() {
+      scrollRef.current.scrollPrev();
+    },
+    size: "md"
+  }, /*#__PURE__*/React.createElement(CaretLeft, {
+    size: 16
+  }))), /*#__PURE__*/React.createElement("span", {
+    className: cx("".concat(blockClass, "__next-button"), [scrollPosition === 1 ? "".concat(blockClass, "__next-button--disabled") : null])
+  }, /*#__PURE__*/React.createElement(IconButton, {
+    align: "top-right",
+    disabled: scrollPosition === 1,
+    kind: "ghost",
+    label: nextIconDescription,
+    onClick: function onClick() {
+      scrollRef.current.scrollNext();
+    },
+    size: "md"
+  }, /*#__PURE__*/React.createElement(CaretRight, {
+    size: 16
+  }))))), onClose && /*#__PURE__*/React.createElement("span", {
+    className: "".concat(blockClass, "__close-button")
+  }, /*#__PURE__*/React.createElement(IconButton, {
+    align: "bottom-right",
+    kind: "ghost",
+    label: closeIconDescription,
+    onClick: onClose,
+    size: "md"
+  }, /*#__PURE__*/React.createElement(Close, {
+    size: 16
+  }))));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+Guidebanner = pkg.checkComponentEnabled(Guidebanner, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+Guidebanner.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+Guidebanner.propTypes = {
+  /**
+   * Provide the contents of the Guidebanner.
+   * One or more GuidebannerElement components are required.
+   */
+  children: function children(props, propName) {
+    var error;
+    var prop = props[propName];
+    if (!prop) {
+      error = new Error('`Guidebanner` requires one or more children of type `GuidebannerElement`.');
+    }
+    React.Children.forEach(prop, function (child) {
+      if (child.type.displayName !== 'GuidebannerElement') {
+        var _child$type, _child$type2;
+        // If not GuidebannerElement, then show:
+        // React component name(child.type?.name) or
+        // HTML element name(child.type).
+        error = new Error("`Guidebanner` only accepts children of type `GuidebannerElement`, found `".concat(((_child$type = child.type) === null || _child$type === void 0 ? void 0 : _child$type.displayName) || ((_child$type2 = child.type) === null || _child$type2 === void 0 ? void 0 : _child$type2.name) || child.type, "` instead."));
+      }
+    });
+    return error;
+  },
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: PropTypes.string,
+  /**
+   * Tooltip text and aria label for the Close button icon.
+   */
+  closeIconDescription: PropTypes.string,
+  /**
+   * Text label for the Collapse button.
+   */
+  collapseButtonLabel: PropTypes.string,
+  /**
+   * When true, the Guidebanner will initialize in a collapsed state,
+   * showing the title and the Expand button.
+   *
+   * When expanded, it will show the GuidebannerElement child components and the Collapse button.
+   */
+  collapsible: PropTypes.bool,
+  /**
+   * Text label for the Expand button.
+   */
+  expandButtonLabel: PropTypes.string,
+  /**
+   * Tooltip text and aria label for the Next button icon.
+   */
+  nextIconDescription: PropTypes.string,
+  /**
+   * If defined, a Close button will render in the top-right corner and a
+   * callback function will be triggered when button is clicked.
+   */
+  onClose: PropTypes.func,
+  /**
+   * Tooltip text and aria label for the Back button icon.
+   */
+  previousIconDescription: PropTypes.string,
+  /**
+   * Title text.
+   */
+  title: PropTypes.string.isRequired
+};

package/es/components/Guidebanner/GuidebannerElement.js

@@ -0,0 +1,72 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["button", "className", "description", "title"];
+/**
+ * Copyright IBM Corp. 2023, 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 portions of React that are needed.
+import React from 'react';
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg } from '../../settings';
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(pkg.prefix, "--guidebanner__element");
+var componentName = 'GuidebannerElement';
+
+/**
+ * The GuidebannerElement is a required child component of the Guidebanner,
+ * and acts as a container for a CarouselItem.
+ */
+export var GuidebannerElement = function GuidebannerElement(_ref) {
+  var button = _ref.button,
+    className = _ref.className,
+    description = _ref.description,
+    title = _ref.title,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: cx(blockClass, className)
+  }, getDevtoolsProps(componentName)), title && /*#__PURE__*/React.createElement("h2", {
+    className: "".concat(blockClass, "-title")
+  }, title), description && /*#__PURE__*/React.createElement("p", {
+    className: "".concat(blockClass, "-content")
+  }, description), button && /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "-buttons")
+  }, button));
+};
+
+// Return a placeholder if not released and not enabled by feature flag
+GuidebannerElement = pkg.checkComponentEnabled(GuidebannerElement, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+GuidebannerElement.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+GuidebannerElement.propTypes = {
+  /**
+   * An optional button can be rendered below the description.
+   * This can be a link, button, Coachmark button, etc.
+   */
+  button: PropTypes.node,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: PropTypes.string,
+  /**
+   * The description of the element.
+   */
+
+  description: PropTypes.oneOfType([PropTypes.string, PropTypes.node]).isRequired,
+  /**
+   * The title of the element.
+   */
+  title: PropTypes.string
+};