@carbon/ibm-products 1.3.0 → 1.6.1

package/es/components/PageHeader/PageHeader.js

@@ -33,7 +33,7 @@ var componentName = 'PageHeader';
 import { blockClass, utilCheckUpdateVerticalSpace, utilGetBreadcrumbItemForTitle, utilSetCollapsed } from './PageHeaderUtils';
 import { PageHeaderTitle } from './PageHeaderTitle';
 export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
-  var _withoutBackground, _ref5, _cx2, _ref6, _cx4, _cx7;
+  var _withoutBackground, _ref6, _cx2, _ref7, _cx4, _cx7;
 
   var actionBarItems = _ref.actionBarItems,
       actionBarMenuOptionsClass = _ref.actionBarMenuOptionsClass,
@@ -83,17 +83,17 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var localHeaderRef = useRef(null);
   var headerRef = ref || localHeaderRef;
   var sizingContainerRef = useRef();
-  var offsetTopMeasuringRef = useRef(null); // utility functions
-
-  var checkUpdateVerticalSpace = function checkUpdateVerticalSpace() {
-    return utilCheckUpdateVerticalSpace(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, setMetrics);
-  }; // state based on props only
-
+  var offsetTopMeasuringRef = useRef(null); // state based on props only
 
   var hasActionBar = actionBarItems && actionBarItems.length > 0;
-  var hasBreadcrumbRow = breadcrumbs || actionBarItems; // NOTE: The buffer is used to add space between the bottom of the header and the last content
+  var hasBreadcrumbRow = !!breadcrumbs || !!actionBarItems; // utility functions
+
+  var checkUpdateVerticalSpace = function checkUpdateVerticalSpace() {
+    return utilCheckUpdateVerticalSpace(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, hasActionBar, widthIsNarrow, setMetrics);
+  }; // NOTE: The buffer is used to add space between the bottom of the header and the last content
   // Not pre-collapsed and (subtitle or children)
 
+
   var lastRowBufferActive = (title || pageActions) && !collapseTitle || subtitle || children; // state based on scroll/resize based effects
 
   var _useState5 = useState(false),
@@ -144,7 +144,12 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var _useState23 = useState(false),
       _useState24 = _slicedToArray(_useState23, 2),
       fullyCollapsed = _useState24[0],
-      setFullyCollapsed = _useState24[1]; // handlers
+      setFullyCollapsed = _useState24[1];
+
+  var _useState25 = useState(false),
+      _useState26 = _slicedToArray(_useState25, 2),
+      widthIsNarrow = _useState26[0],
+      setWidthIsNarrow = _useState26[1]; // handlers
 
 
   var handleActionBarWidthChange = function handleActionBarWidthChange(_ref2) {
@@ -216,8 +221,8 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     // Determine the location of the pageAction buttons
 
     /* istanbul ignore next */
-    setPageActionsInBreadcrumbRow(collapseTitle || scrollYValue > metrics.titleRowSpaceAbove && hasActionBar);
-  }, [hasActionBar, metrics.breadcrumbRowSpaceBelow, metrics.titleRowSpaceAbove, collapseTitle, scrollYValue]);
+    setPageActionsInBreadcrumbRow(collapseTitle || hasActionBar && scrollYValue > metrics.titleRowSpaceAbove || widthIsNarrow && scrollYValue > metrics.pageActionsSpaceAbove);
+  }, [hasActionBar, metrics.breadcrumbRowSpaceBelow, metrics.titleRowSpaceAbove, metrics.pageActionsSpaceAbove, collapseTitle, scrollYValue, widthIsNarrow]);
   useEffect(function () {
     // Assesses the size of the action bar and page action area and their required
     // space before setting their sizes
@@ -279,9 +284,11 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     document.documentElement.style.setProperty("--".concat(blockClass, "--tagset-tooltip-offset"), "".concat(tagsetTooltipOffset, "px"));
     setScrollYValue(current.scrollY);
   }, [metrics.headerHeight, metrics.headerTopValue, metrics.headerOffset, disableBreadcrumbScroll]);
-  useWindowResize(function () {
+  useWindowResize(function (_ref5) {
+    var current = _ref5.current;
     // on window resize and other updates some values may have changed
     checkUpdateVerticalSpace();
+    setWidthIsNarrow(current.innerWidth < 672); // small (below medium) media query
   }, [actionBarItems, children, breadcrumbs, disableBreadcrumbScroll, navigation, pageActions, subtitle, tags, title]);
   useEffect(function () {
     checkUpdateVerticalSpace(); // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -344,7 +351,7 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     className: "".concat(blockClass, "--offset-top-measuring-element"),
     ref: offsetTopMeasuringRef
   }), /*#__PURE__*/React.createElement("section", _extends({}, rest, {
-    className: cx([blockClass, "".concat(blockClass, "--no-margins-below-row"), className, (_ref5 = {}, _defineProperty(_ref5, "".concat(blockClass, "--has-navigation"), navigation || tags), _defineProperty(_ref5, "".concat(blockClass, "--has-navigation-tags-only"), !navigation && tags), _ref5)]),
+    className: cx([blockClass, "".concat(blockClass, "--no-margins-below-row"), className, (_ref6 = {}, _defineProperty(_ref6, "".concat(blockClass, "--has-navigation"), navigation || tags), _defineProperty(_ref6, "".concat(blockClass, "--has-navigation-tags-only"), !navigation && tags), _ref6)]),
     style: pageHeaderStyles,
     ref: headerRef
   }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(Grid, {
@@ -354,18 +361,19 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }, /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__non-navigation-row-content")
   }, hasBreadcrumbRow ? /*#__PURE__*/React.createElement(Row, {
-    className: cx("".concat(blockClass, "__breadcrumb-row"), (_cx2 = {}, _defineProperty(_cx2, "".concat(blockClass, "__breadcrumb-row--next-to-tabs"), nextToTabsCheck()), _defineProperty(_cx2, "".concat(blockClass, "__breadcrumb-row--has-breadcrumbs"), breadcrumbs), _defineProperty(_cx2, "".concat(blockClass, "__breadcrumb-row--has-action-bar"), hasActionBar), _defineProperty(_cx2, "".concat(blockClass, "__has-page-actions-without-action-bar"), !hasActionBar && pageActions), _cx2))
+    className: cx("".concat(blockClass, "__breadcrumb-row"), (_cx2 = {}, _defineProperty(_cx2, "".concat(blockClass, "__breadcrumb-row--next-to-tabs"), nextToTabsCheck()), _defineProperty(_cx2, "".concat(blockClass, "__breadcrumb-row--has-breadcrumbs"), breadcrumbs || breadcrumbItemForTitle), _defineProperty(_cx2, "".concat(blockClass, "__breadcrumb-row--has-action-bar"), hasActionBar || widthIsNarrow), _defineProperty(_cx2, "".concat(blockClass, "__has-page-actions-without-action-bar"), !hasActionBar && !widthIsNarrow && pageActions), _cx2))
   }, /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__breadcrumb-row--container")
   }, /*#__PURE__*/React.createElement(Column, {
-    className: cx("".concat(blockClass, "__breadcrumb-column"), _defineProperty({}, "".concat(blockClass, "__breadcrumb-column--background"), !!breadcrumbs || hasActionBar))
-  }, breadcrumbs ? /*#__PURE__*/React.createElement(BreadcrumbWithOverflow, {
+    className: cx("".concat(blockClass, "__breadcrumb-column"), _defineProperty({}, "".concat(blockClass, "__breadcrumb-column--background"), !!breadcrumbs || hasActionBar || widthIsNarrow))
+  }, breadcrumbs || breadcrumbItemForTitle ? /*#__PURE__*/React.createElement(BreadcrumbWithOverflow, {
     className: "".concat(blockClass, "__breadcrumb"),
     noTrailingSlash: !!title,
     overflowAriaLabel: breadcrumbOverflowAriaLabel,
-    breadcrumbs: breadcrumbs ? breadcrumbItemForTitle ? breadcrumbs.concat(breadcrumbItemForTitle) : breadcrumbs : null
+    breadcrumbs: breadcrumbs && breadcrumbItemForTitle ? breadcrumbs.concat(breadcrumbItemForTitle) : breadcrumbItemForTitle ? [breadcrumbItemForTitle] : breadcrumbs // breadcrumbs may be null or undefined
+
   }) : null), /*#__PURE__*/React.createElement(Column, {
-    className: cx(["".concat(blockClass, "__action-bar-column ").concat(blockClass, "__action-bar-column--background"), (_ref6 = {}, _defineProperty(_ref6, "".concat(blockClass, "__action-bar-column--has-page-actions"), pageActions), _defineProperty(_ref6, "".concat(blockClass, "__action-bar-column--influenced-by-collapse-button"), spaceForCollapseButton), _ref6)])
+    className: cx(["".concat(blockClass, "__action-bar-column ").concat(blockClass, "__action-bar-column--background"), (_ref7 = {}, _defineProperty(_ref7, "".concat(blockClass, "__action-bar-column--has-page-actions"), pageActions), _defineProperty(_ref7, "".concat(blockClass, "__action-bar-column--influenced-by-collapse-button"), spaceForCollapseButton), _ref7)])
   }, /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__action-bar-column-content"),
     ref: sizingContainerRef
@@ -379,8 +387,8 @@ export var PageHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     className: "".concat(blockClass, "__action-bar"),
     onWidthChange: handleActionBarWidthChange,
     rightAlign: true
-  })) : null)))) : null, !collapseTitle && (title || pageActions) ? /*#__PURE__*/React.createElement(Row, {
-    className: cx("".concat(blockClass, "__title-row"), (_cx4 = {}, _defineProperty(_cx4, "".concat(blockClass, "__title-row--no-breadcrumb-row"), !hasBreadcrumbRow), _defineProperty(_cx4, "".concat(blockClass, "__title-row--under-action-bar"), hasActionBar), _defineProperty(_cx4, "".concat(blockClass, "__title-row--has-page-actions"), !!pageActions), _defineProperty(_cx4, "".concat(blockClass, "__title-row--sticky"), !!pageActions && !actionBarItems && hasBreadcrumbRow), _cx4))
+  })) : widthIsNarrow && thePageActions(true, pageActionsInBreadcrumbRow))))) : null, !collapseTitle && (title || pageActions) ? /*#__PURE__*/React.createElement(Row, {
+    className: cx("".concat(blockClass, "__title-row"), (_cx4 = {}, _defineProperty(_cx4, "".concat(blockClass, "__title-row--no-breadcrumb-row"), !hasBreadcrumbRow), _defineProperty(_cx4, "".concat(blockClass, "__title-row--under-action-bar"), hasActionBar || widthIsNarrow), _defineProperty(_cx4, "".concat(blockClass, "__title-row--has-page-actions"), !!pageActions), _defineProperty(_cx4, "".concat(blockClass, "__title-row--sticky"), !!pageActions && !actionBarItems && hasBreadcrumbRow), _cx4))
   }, /*#__PURE__*/React.createElement(Column, {
     className: "".concat(blockClass, "__title-column")
   }, title ? /*#__PURE__*/React.createElement(PageHeaderTitle, {
@@ -510,8 +518,8 @@ PageHeader.propTypes = _objectSpread({
    *
    * NOTE: This prop is required if actionBarItems are supplied
    */
-  actionBarOverflowAriaLabel: PropTypes.string.isRequired.if(function (_ref8) {
-    var actionBarItems = _ref8.actionBarItems;
+  actionBarOverflowAriaLabel: PropTypes.string.isRequired.if(function (_ref9) {
+    var actionBarItems = _ref9.actionBarItems;
     return actionBarItems && actionBarItems.length > 0;
   }),
 
@@ -546,8 +554,8 @@ PageHeader.propTypes = _objectSpread({
    * If the user supplies breadcrumbs then this property is required.
    * It is used in an overflow menu when there is insufficient space to display all breadcrumbs inline.
    */
-  breadcrumbOverflowAriaLabel: PropTypes.string.isRequired.if(function (_ref9) {
-    var breadcrumbs = _ref9.breadcrumbs;
+  breadcrumbOverflowAriaLabel: PropTypes.string.isRequired.if(function (_ref10) {
+    var breadcrumbs = _ref10.breadcrumbs;
     return breadcrumbs && breadcrumbs.length > 0;
   }),
 
@@ -586,8 +594,8 @@ PageHeader.propTypes = _objectSpread({
     /**
      * A text version of the `label` for display, required if `label` is not a string.
      */
-    title: PropTypes.string.isRequired.if(function (_ref10) {
-      var label = _ref10.label;
+    title: PropTypes.string.isRequired.if(function (_ref11) {
+      var label = _ref11.label;
       return typeof label !== 'string';
     })
   })),
@@ -617,9 +625,9 @@ PageHeader.propTypes = _objectSpread({
    * If `hasCollapseHeaderToggle` is set and `withoutBackground` is unset/falsy then assistive text is
    * required for both the expend and collapse states of the button component used.
    */
-  collapseHeaderIconDescription: PropTypes.string.isRequired.if(function (_ref11) {
-    var withoutBackground = _ref11.withoutBackground,
-        hasCollapseHeaderToggle = _ref11.hasCollapseHeaderToggle;
+  collapseHeaderIconDescription: PropTypes.string.isRequired.if(function (_ref12) {
+    var withoutBackground = _ref12.withoutBackground,
+        hasCollapseHeaderToggle = _ref12.hasCollapseHeaderToggle;
     return !withoutBackground && hasCollapseHeaderToggle;
   }),
 
@@ -639,9 +647,9 @@ PageHeader.propTypes = _objectSpread({
    * If `hasCollapseHeaderToggle` is set and `withoutBackground` is unset/falsy then assistive text is
    * required for both the expend and collapse states of the button component used.
    */
-  expandHeaderIconDescription: PropTypes.string.isRequired.if(function (_ref12) {
-    var withoutBackground = _ref12.withoutBackground,
-        hasCollapseHeaderToggle = _ref12.hasCollapseHeaderToggle;
+  expandHeaderIconDescription: PropTypes.string.isRequired.if(function (_ref13) {
+    var withoutBackground = _ref13.withoutBackground,
+        hasCollapseHeaderToggle = _ref13.hasCollapseHeaderToggle;
     return !withoutBackground && hasCollapseHeaderToggle;
   }),
 
@@ -712,8 +720,8 @@ PageHeader.propTypes = _objectSpread({
    *
    * NOTE: This prop is required if pageActions are supplied
    */
-  pageActionsOverflowLabel: PropTypes.node.isRequired.if(function (_ref13) {
-    var pageActions = _ref13.pageActions;
+  pageActionsOverflowLabel: PropTypes.node.isRequired.if(function (_ref14) {
+    var pageActions = _ref14.pageActions;
     return pageActions && pageActions.length > 0 && !pageActions.content;
   }),
 
@@ -759,6 +767,11 @@ PageHeader.propTypes = _objectSpread({
    *    - text: title string
    *    - icon: optional icon
    *    - loading: boolean shows loading indicator if true
+   *    - onChange: function to process the live value (React change === HTML Input)
+   *    - onSave: function to process a confirmed change
+   *    - editableLabel: label for edit required if onChange supplied
+   *    - cancelDescription: label for edit cancel button
+   *    - saveDescription: label for edit save button
    * - Object containing user defined contents. These must fit within the area defined for the title in both main part of the header and the breadcrumb.
    *    - content: title or name of current location shown in main part of page header
    *    - breadcrumbContent: version of content used in the breadcrumb on scroll. If not supplied
@@ -768,7 +781,18 @@ PageHeader.propTypes = _objectSpread({
     // Update docgen if changed
     text: PropTypes.string.isRequired,
     icon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
-    loading: PropTypes.bool // Update docgen if changed
+    loading: PropTypes.bool,
+    // inline edit version properties
+    editableLabel: PropTypes.string,
+    // .isRequired.if(inlineEditRequired),
+    id: PropTypes.string,
+    // .isRequired.if(inlineEditRequired),
+    onChange: PropTypes.func,
+    onSave: PropTypes.func,
+    cancelDescription: PropTypes.string,
+    //.isRequired.if(inlineEditRequired),
+    saveDescription: PropTypes.string //.isRequired.if(inlineEditRequired),
+    // Update docgen if changed
 
   }), PropTypes.string, PropTypes.shape({
     content: PropTypes.node.isRequired,

package/es/components/PageHeader/PageHeaderTitle.js

@@ -1,7 +1,12 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _extends from "@babel/runtime/helpers/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["text", "content", "loading", "icon", "asText", "onChange", "onSave", "editDescription", "editableLabel", "revertDescription", "saveDescription"];
 import React from 'react';
+import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { SkeletonText } from 'carbon-components-react';
+import { InlineEdit } from '../';
 /**
  *
  * Utility component used by Page Header
@@ -14,14 +19,22 @@ export var PageHeaderTitle = function PageHeaderTitle(_ref) {
       title = _ref.title;
   var titleInnards; // eslint-disable-next-line
   // debugger;
-  // eslint-disable-next-line react/prop-types
 
   var text = title.text,
       content = title.content,
       loading = title.loading,
       icon = title.icon,
-      asText = title.asText;
+      asText = title.asText,
+      onChange = title.onChange,
+      onSave = title.onSave,
+      editDescription = title.editDescription,
+      editableLabel = title.editableLabel,
+      revertDescription = title.revertDescription,
+      saveDescription = title.saveDescription,
+      rest = _objectWithoutProperties(title, _excluded);
+
   var titleText;
+  var isEditable = !!onSave;
 
   if (text || !content) {
     if (text === undefined && typeof title === 'string') {
@@ -32,18 +45,80 @@ export var PageHeaderTitle = function PageHeaderTitle(_ref) {
     var TitleIcon = icon;
     titleInnards = /*#__PURE__*/React.createElement(React.Fragment, null, icon && !loading ? /*#__PURE__*/React.createElement(TitleIcon, {
       className: "".concat(blockClass, "__title-icon")
-    }) : null, /*#__PURE__*/React.createElement("span", {
-      title: !loading ? asText : null
-    }, loading ? /*#__PURE__*/React.createElement(SkeletonText, {
+    }) : null, loading ? /*#__PURE__*/React.createElement(SkeletonText, {
       className: "".concat(blockClass, "__title-skeleton")
-    }) : text));
+    }) : isEditable ? /*#__PURE__*/React.createElement(InlineEdit, _extends({
+      hideLabel: true,
+      value: text,
+      editDescription: editDescription,
+      onChange: onChange,
+      onSave: onSave,
+      labelText: editableLabel,
+      revertDescription: revertDescription,
+      saveDescription: saveDescription
+    }, rest)) : /*#__PURE__*/React.createElement("span", {
+      title: !loading ? asText : null
+    }, text));
   } else {
     titleInnards = content;
     titleText = asText;
   }
 
   return /*#__PURE__*/React.createElement("div", {
-    className: cx("".concat(blockClass, "__title"), _defineProperty({}, "".concat(blockClass, "__title--fades"), hasBreadcrumbRow)),
+    className: cx("".concat(blockClass, "__title"), _defineProperty({}, "".concat(blockClass, "__title--editable"), isEditable), _defineProperty({}, "".concat(blockClass, "__title--fades"), hasBreadcrumbRow)),
     title: titleText
   }, titleInnards);
+};
+export var inlineEditRequired = function inlineEditRequired(_ref2) {
+  var onSave = _ref2.onSave;
+  return !!onSave;
+};
+PageHeaderTitle.propTypes = {
+  // passed from page header
+  blockClass: PropTypes.string.isRequired,
+
+  /**
+   * controlled from within page header
+   */
+  hasBreadcrumbRow: PropTypes.bool,
+
+  /**
+   * An optional page title supplied as a string or object with the following attributes: text, icon, loading
+   *
+   * Can be supplied either as:
+   * - String
+   * - Object containing
+   *    - text: title string
+   *    - icon: optional icon
+   *    - loading: boolean shows loading indicator if true
+   *    - onChange: function to process the live value (React change === HTML Input)
+   *    - onSave: function to process a confirmed change
+   *    - editDescription: description for edit button
+   *    - editableLabel: label for edit required if onSave supplied
+   *    - revertDescription: description for edit revert button
+   *    - saveDescription: description for edit save button
+   * - Object containing user defined contents. These must fit within the area defined for the title in both main part of the header and the breadcrumb.
+   *    - content: title or name of current location shown in main part of page header
+   *    - breadcrumbContent: version of content used in the breadcrumb on scroll. If not supplied
+   *    - asText: String based representation of the title
+   */
+  title: PropTypes.oneOfType([PropTypes.shape({
+    // Update docgen if changed
+    text: PropTypes.string.isRequired,
+    icon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    loading: PropTypes.bool,
+    // inline edit version properties
+    editDescription: PropTypes.string.isRequired.if(inlineEditRequired),
+    editableLabel: PropTypes.string.isRequired.if(inlineEditRequired),
+    id: PropTypes.string.isRequired.if(inlineEditRequired),
+    onChange: PropTypes.func,
+    onSave: PropTypes.func,
+    revertDescription: PropTypes.string.isRequired.if(inlineEditRequired),
+    saveDescription: PropTypes.string.isRequired.if(inlineEditRequired) // Update docgen if changed
+
+  }), PropTypes.string, PropTypes.shape({
+    content: PropTypes.node.isRequired,
+    breadcrumbContent: PropTypes.node,
+    asText: PropTypes.string.isRequired
+  })])
 };

package/es/components/PageHeader/PageHeaderUtils.js

@@ -22,10 +22,12 @@ export var blockClass = "".concat(pkg.prefix, "--page-header");
  * @param {{}} offsetTopMeasuringRef
  * @param {{}} navigation
  * @param {boolean} disableBreadcrumbScroll
+ * @param {boolean} hasActionBar
+ * @param {boolean} widthIsNarrow
  * @param {()} setMetrics
  */
 
-export var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, setMetrics) {
+export var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, hasActionBar, widthIsNarrow, setMetrics) {
   var dynamicRefs = {};
 
   var getDynamicRef = function getDynamicRef(selector) {
@@ -60,6 +62,7 @@ export var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(
     var subtitleRowEl = getDynamicRef(".".concat(blockClass, "__subtitle-row"));
     var availableRowEl = getDynamicRef(".".concat(blockClass, "__available-row"));
     var navigationRowEl = getDynamicRef(".".concat(blockClass, "__navigation-row"));
+    var pageActionsEl = getDynamicRef(".".concat(blockClass, "__page-actions"));
     /* istanbul ignore next */
 
     update.headerHeight = headerRef.current ? headerRef.current.clientHeight : 0;
@@ -81,7 +84,8 @@ export var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(
     update.breadcrumbRowWidth = breadcrumbRowEl ? breadcrumbRowEl.offsetWidth : 0;
     /* istanbul ignore next */
 
-    update.breadcrumbTitleHeight = breadcrumbTitleEl ? breadcrumbTitleEl.clientHeight : 1;
+    update.breadcrumbTitleHeight = breadcrumbTitleEl ? breadcrumbTitleEl.offsetHeight // clientHeight returns 0 when window small
+    : 1;
     /* istanbul ignore next */
 
     update.titleRowHeight = titleRowEl ? titleRowEl.clientHeight : 0;
@@ -102,9 +106,19 @@ export var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(
       update.headerTopValue += update.navigationRowHeight;
     }
 
+    if (!hasActionBar && !widthIsNarrow) {
+      // Add difference between $spacing-08 and $spacing-07 to ensure space below breadcrumb is correct on scroll
+      // $spacing-07 is used as size for breadcrumb when no action bar otherwise $spacing-08
+      update.headerTopValue += 8;
+    }
+
     if (disableBreadcrumbScroll || !navigation) {
       // adjust sticky top if no navigation or breadcrumb is to stay on screen
       update.headerTopValue += update.breadcrumbRowHeight;
+    } else {
+      if (navigation && !widthIsNarrow) {
+        update.headerTopValue -= 8;
+      }
     }
 
     if (window) {
@@ -125,6 +139,11 @@ export var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(
       if (titleRowEl) {
         val = parseFloat(window.getComputedStyle(titleRowEl).getPropertyValue('margin-top'), 10);
         update.titleRowSpaceAbove = isNaN(val) ? 0 : val;
+
+        if (pageActionsEl) {
+          val = parseFloat(window.getComputedStyle(pageActionsEl).getPropertyValue('margin-top'), 10);
+          update.pageActionsSpaceAbove = titleRowEl.clientHeight - pageActionsEl.clientHeight + update.titleRowSpaceAbove - (isNaN(val) ? 0 : val);
+        }
       }
     } else {
       update.breadcrumbRowSpaceBelow = 0;

package/es/components/RemoveModal/RemoveModal.js

@@ -88,11 +88,13 @@ export var RemoveModal = /*#__PURE__*/forwardRef(function (_ref, ref) {
     labelText: inputLabelText,
     placeholder: inputPlaceholderText,
     onChange: onChangeHandler,
-    value: userInput
+    value: userInput,
+    "data-modal-primary-focus": true
   })), /*#__PURE__*/React.createElement(ModalFooter, null, /*#__PURE__*/React.createElement(Button, {
     type: "button",
     kind: "secondary",
-    onClick: onClose
+    onClick: onClose,
+    "data-modal-primary-focus": !textConfirmation
   }, secondaryButtonText), /*#__PURE__*/React.createElement(Button, {
     type: "submit",
     kind: "danger",

package/es/components/SidePanel/SidePanel.js

@@ -89,8 +89,12 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var sidePanelInnerRef = useRef();
   var sidePanelCloseRef = useRef();
   var previousState = usePreviousValue({
-    size: size
-  }); // scroll panel to top going between steps
+    size: size,
+    open: open
+  });
+  var reducedMotion = window && window.matchMedia ? window.matchMedia('(prefers-reduced-motion: reduce)') : {
+    matches: true
+  }; // scroll panel to top going between steps
 
   useEffect(function () {
     var panelRef = ref || sidePanelRef;
@@ -169,7 +173,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
 
 
   useEffect(function () {
-    if (open && animateTitle && animationComplete && title && title.length) {
+    if (open && animateTitle && animationComplete && title && title.length && !reducedMotion.matches) {
       var _document$querySelect2, _document$querySelect3, _document$querySelect4;
 
       var sidePanelOuter = document.querySelector("#".concat(blockClass, "-outer"));
@@ -261,7 +265,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       _sidePanelOuter === null || _sidePanelOuter === void 0 ? void 0 : _sidePanelOuter.style.setProperty("--".concat(blockClass, "--subtitle-container-height"), "".concat(_sidePanelSubtitleElementHeight, "px"));
       _sidePanelOuter === null || _sidePanelOuter === void 0 ? void 0 : _sidePanelOuter.style.setProperty("--".concat(blockClass, "--action-bar-container-height"), "".concat(sidePanelActionBarElementHeight, "px"));
     }
-  }, [open, animateTitle, animationComplete, shouldRender, panelHeight, title, size]); // click outside functionality if `includeOverlay` prop is set
+  }, [open, animateTitle, animationComplete, shouldRender, panelHeight, title, size, reducedMotion.matches]); // click outside functionality if `includeOverlay` prop is set
 
   useEffect(function () {
     var handleOutsideClick = function handleOutsideClick(event) {
@@ -287,7 +291,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     return function () {
       document.removeEventListener('click', handleOutsideClick);
     };
-  }, [includeOverlay, onRequestClose, open, preventCloseOnClickOutside, ref]); // initialize the side panel to open
+  }, [includeOverlay, onRequestClose, open, preventCloseOnClickOutside, ref, onUnmount]); // initialize the side panel to open
 
   useEffect(function () {
     if (open) {
@@ -297,14 +301,21 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
 
   var onAnimationEnd = function onAnimationEnd() {
     if (!open) {
-      onUnmount && onUnmount();
+      onUnmount === null || onUnmount === void 0 ? void 0 : onUnmount();
       setRender(false);
     }
 
     setAnimationComplete(true);
-  }; // initializes the side panel to open
+  }; // Set the internal state `animationComplete` to true if
+  // prefers reduced motion is true
 
 
+  useEffect(function () {
+    if (reducedMotion.matches) {
+      setAnimationComplete(true);
+    }
+  }, [reducedMotion.matches]); // initializes the side panel to open
+
   var _onAnimationStart = function onAnimationStart(event) {
     event.persist();
     var isPanelTarget = event.target.id === "".concat(blockClass, "-outer");
@@ -325,7 +336,13 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
         pageContentElement.style.marginLeft = 0;
       }
     }
-  }, [open, placement, selectorPageContent, slideIn]); // used to set margins of content for slide in panel version
+  }, [open, placement, selectorPageContent, slideIn]);
+  useEffect(function () {
+    if (!open && previousState !== null && previousState !== void 0 && previousState.open && reducedMotion.matches) {
+      setRender(false);
+      onUnmount === null || onUnmount === void 0 ? void 0 : onUnmount();
+    }
+  }, [open, onUnmount, reducedMotion.matches, previousState === null || previousState === void 0 ? void 0 : previousState.open]); // used to set margins of content for slide in panel version
 
   useEffect(function () {
     if (shouldRender && slideIn) {
@@ -333,15 +350,15 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
 
       if (placement && placement === 'right' && pageContentElement) {
         pageContentElement.style.marginRight = 0;
-        pageContentElement.style.transition = "margin-right ".concat(moderate02);
+        pageContentElement.style.transition = !reducedMotion.matches ? "margin-right ".concat(moderate02) : null;
         pageContentElement.style.marginRight = SIDE_PANEL_SIZES[size];
       } else if (pageContentElement) {
         pageContentElement.style.marginLeft = 0;
-        pageContentElement.style.transition = "margin-left ".concat(moderate02);
+        pageContentElement.style.transition = !reducedMotion.matches ? "margin-left ".concat(moderate02) : null;
         pageContentElement.style.marginLeft = SIDE_PANEL_SIZES[size];
       }
     }
-  }, [slideIn, selectorPageContent, placement, shouldRender, size]); // adds focus trap functionality
+  }, [slideIn, selectorPageContent, placement, shouldRender, size, reducedMotion.matches]); // adds focus trap functionality
 
   /* istanbul ignore next */
 
@@ -368,7 +385,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     var _cx, _cx2;
 
     return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
-      className: cx("".concat(blockClass, "__title-container"), (_cx = {}, _defineProperty(_cx, "".concat(blockClass, "__on-detail-step"), currentStep > 0), _defineProperty(_cx, "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), _defineProperty(_cx, "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), _defineProperty(_cx, "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), _defineProperty(_cx, "".concat(blockClass, "__title-container-without-title"), !title), _cx))
+      className: cx("".concat(blockClass, "__title-container"), (_cx = {}, _defineProperty(_cx, "".concat(blockClass, "__on-detail-step"), currentStep > 0), _defineProperty(_cx, "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), _defineProperty(_cx, "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), _defineProperty(_cx, "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), _defineProperty(_cx, "".concat(blockClass, "__title-container-without-title"), !title), _defineProperty(_cx, "".concat(blockClass, "__title-container--reduced-motion"), reducedMotion.matches), _cx))
     }, currentStep > 0 && /*#__PURE__*/React.createElement(Button, {
       "aria-label": navigationBackIconDescription,
       kind: "ghost",
@@ -426,7 +443,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       className: "".concat(blockClass, "__title-text"),
       title: title,
       "aria-hidden": false
-    }, title), animateTitle && title && title.length && /*#__PURE__*/React.createElement("h2", {
+    }, title), animateTitle && title && title.length && !reducedMotion.matches && /*#__PURE__*/React.createElement("h2", {
       className: "".concat(blockClass, "__collapsed-title-text"),
       title: title,
       "aria-hidden": true
@@ -443,7 +460,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     id: "".concat(blockClass, "-outer"),
     className: mainPanelClassNames,
     style: {
-      animation: "".concat(open ? placement === 'right' ? "sidePanelEntranceRight ".concat(moderate02) : "sidePanelEntranceLeft ".concat(moderate02) : placement === 'right' ? "sidePanelExitRight ".concat(moderate02) : "sidePanelExitLeft ".concat(moderate02))
+      animation: !reducedMotion.matches ? "".concat(open ? placement === 'right' ? "side-panel-entrance-right ".concat(moderate02) : "side-panel-entrance-left ".concat(moderate02) : placement === 'right' ? "side-panel-exit-right ".concat(moderate02) : "side-panel-exit-left ".concat(moderate02)) : null
     },
     onAnimationEnd: onAnimationEnd,
     onAnimationStart: function onAnimationStart(event) {
@@ -476,7 +493,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     ref: sidePanelOverlayRef,
     className: "".concat(blockClass, "__overlay"),
     style: {
-      animation: "".concat(open ? "sidePanelOverlayEntrance ".concat(moderate02) : "sidePanelOverlayExit ".concat(moderate02))
+      animation: !reducedMotion.matches ? "".concat(open ? "side-panel-overlay-entrance ".concat(moderate02) : "side-panel-overlay-exit ".concat(moderate02)) : null
     }
   }));
 }); // Return a placeholder if not released and not enabled by feature flag
@@ -508,7 +525,7 @@ SidePanel.propTypes = {
    * See https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
    */
   actions: allPropTypes([ActionSet.validateActions(), PropTypes.arrayOf(PropTypes.shape(_objectSpread(_objectSpread({}, Button.propTypes), {}, {
-    kind: PropTypes.oneOf(['ghost', 'secondary', 'primary']),
+    kind: PropTypes.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
     label: PropTypes.string,
     loading: PropTypes.bool,
     // we duplicate this Button prop to improve the DocGen here

package/es/components/SingleAddSelect/SingleAddSelect.js

@@ -0,0 +1,15 @@
+import _extends from "@babel/runtime/helpers/extends";
+import React, { forwardRef } from 'react'; // import PropTypes from 'prop-types';
+
+import { AddSelect } from '../AddSelect';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg } from '../../settings';
+var componentName = 'SingleAddSelect';
+export var SingleAddSelect = /*#__PURE__*/forwardRef(function (props, ref) {
+  return /*#__PURE__*/React.createElement(AddSelect, _extends({}, props, {
+    ref: ref
+  }, getDevtoolsProps(componentName)));
+});
+SingleAddSelect = pkg.checkComponentEnabled(SingleAddSelect, componentName);
+SingleAddSelect.propTypes = {};
+SingleAddSelect.displayName = componentName;

package/es/components/SingleAddSelect/index.js

@@ -0,0 +1 @@
+export { SingleAddSelect } from './SingleAddSelect';

package/es/components/TagSet/TagSet.js

@@ -3,7 +3,7 @@ import _extends from "@babel/runtime/helpers/extends";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 var _excluded = ["align", "className", "maxVisible", "overflowAlign", "overflowClassName", "overflowDirection", "allTagsModalTitle", "allTagsModalSearchLabel", "allTagsModalSearchPlaceholderText", "showAllTagsLabel", "tags"],
-    _excluded2 = ["label"],
+    _excluded2 = ["label", "id"],
     _excluded3 = ["label"];
 
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
@@ -84,6 +84,7 @@ export var TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
 
     setHiddenSizingTags(tags && tags.length > 0 ? tags.map(function (_ref2, index) {
       var label = _ref2.label,
+          id = _ref2.id,
           other = _objectWithoutProperties(_ref2, _excluded2);
 
       return /*#__PURE__*/React.createElement("div", {
@@ -93,6 +94,8 @@ export var TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
           return newSizingTags[index] = el;
         }
       }, /*#__PURE__*/React.createElement(Tag, _extends({}, other, {
+        // ensure id is not duplicated
+        "data-original-id": id,
         filter: false
       }), label));
     }) : []);

package/es/components/Tearsheet/Tearsheet.js

@@ -82,7 +82,7 @@ Tearsheet.propTypes = _objectSpread({
   actions: allPropTypes([ActionSet.validateActions(function () {
     return 'max';
   }), PropTypes.arrayOf(PropTypes.shape(_objectSpread(_objectSpread({}, Button.propTypes), {}, {
-    kind: PropTypes.oneOf(['ghost', 'secondary', 'primary']),
+    kind: PropTypes.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
     label: PropTypes.string,
     loading: PropTypes.bool,
     // we duplicate this Button prop to improve the DocGen here

package/es/components/Tearsheet/TearsheetNarrow.js

@@ -78,7 +78,7 @@ TearsheetNarrow.propTypes = _objectSpread({
   actions: allPropTypes([ActionSet.validateActions(function () {
     return 'lg';
   }), PropTypes.arrayOf(PropTypes.shape(_objectSpread(_objectSpread({}, Button.propTypes), {}, {
-    kind: PropTypes.oneOf(['ghost', 'secondary', 'primary']),
+    kind: PropTypes.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
     label: PropTypes.string,
     loading: PropTypes.bool,
     // we duplicate this Button prop to improve the DocGen here

package/es/components/Tearsheet/TearsheetShell.js

@@ -281,7 +281,7 @@ TearsheetShell.propTypes = _objectSpread({
   actions: PropTypes.arrayOf( // NB we don't include the validator here, as the component wrapping this
   // one should ensure appropriate validation is done.
   PropTypes.shape(_objectSpread(_objectSpread({}, Button.propTypes), {}, {
-    kind: PropTypes.oneOf(['ghost', 'secondary', 'primary']),
+    kind: PropTypes.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
     label: PropTypes.string,
     loading: PropTypes.bool,
     // we duplicate this Button prop to improve the DocGen here