@carbon/ibm-products 1.2.5 → 1.6.0

package/lib/components/PageHeader/PageHeader.js

@@ -64,7 +64,7 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 var componentName = 'PageHeader';
 
 var PageHeader = /*#__PURE__*/_react.default.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,
@@ -113,17 +113,17 @@ var PageHeader = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   var localHeaderRef = (0, _react.useRef)(null);
   var headerRef = ref || localHeaderRef;
   var sizingContainerRef = (0, _react.useRef)();
-  var offsetTopMeasuringRef = (0, _react.useRef)(null); // utility functions
-
-  var checkUpdateVerticalSpace = function checkUpdateVerticalSpace() {
-    return (0, _PageHeaderUtils.utilCheckUpdateVerticalSpace)(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, setMetrics);
-  }; // state based on props only
-
+  var offsetTopMeasuringRef = (0, _react.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 (0, _PageHeaderUtils.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 = (0, _react.useState)(false),
@@ -174,7 +174,12 @@ var PageHeader = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   var _useState23 = (0, _react.useState)(false),
       _useState24 = (0, _slicedToArray2.default)(_useState23, 2),
       fullyCollapsed = _useState24[0],
-      setFullyCollapsed = _useState24[1]; // handlers
+      setFullyCollapsed = _useState24[1];
+
+  var _useState25 = (0, _react.useState)(false),
+      _useState26 = (0, _slicedToArray2.default)(_useState25, 2),
+      widthIsNarrow = _useState26[0],
+      setWidthIsNarrow = _useState26[1]; // handlers
 
 
   var handleActionBarWidthChange = function handleActionBarWidthChange(_ref2) {
@@ -246,8 +251,8 @@ var PageHeader = /*#__PURE__*/_react.default.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]);
   (0, _react.useEffect)(function () {
     // Assesses the size of the action bar and page action area and their required
     // space before setting their sizes
@@ -309,9 +314,11 @@ var PageHeader = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     document.documentElement.style.setProperty("--".concat(_PageHeaderUtils.blockClass, "--tagset-tooltip-offset"), "".concat(tagsetTooltipOffset, "px"));
     setScrollYValue(current.scrollY);
   }, [metrics.headerHeight, metrics.headerTopValue, metrics.headerOffset, disableBreadcrumbScroll]);
-  (0, _hooks.useWindowResize)(function () {
+  (0, _hooks.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]);
   (0, _react.useEffect)(function () {
     checkUpdateVerticalSpace(); // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -374,7 +381,7 @@ var PageHeader = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     className: "".concat(_PageHeaderUtils.blockClass, "--offset-top-measuring-element"),
     ref: offsetTopMeasuringRef
   }), /*#__PURE__*/_react.default.createElement("section", (0, _extends2.default)({}, rest, {
-    className: (0, _classnames.default)([_PageHeaderUtils.blockClass, "".concat(_PageHeaderUtils.blockClass, "--no-margins-below-row"), className, (_ref5 = {}, (0, _defineProperty2.default)(_ref5, "".concat(_PageHeaderUtils.blockClass, "--has-navigation"), navigation || tags), (0, _defineProperty2.default)(_ref5, "".concat(_PageHeaderUtils.blockClass, "--has-navigation-tags-only"), !navigation && tags), _ref5)]),
+    className: (0, _classnames.default)([_PageHeaderUtils.blockClass, "".concat(_PageHeaderUtils.blockClass, "--no-margins-below-row"), className, (_ref6 = {}, (0, _defineProperty2.default)(_ref6, "".concat(_PageHeaderUtils.blockClass, "--has-navigation"), navigation || tags), (0, _defineProperty2.default)(_ref6, "".concat(_PageHeaderUtils.blockClass, "--has-navigation-tags-only"), !navigation && tags), _ref6)]),
     style: pageHeaderStyles,
     ref: headerRef
   }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Grid, {
@@ -384,18 +391,19 @@ var PageHeader = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   }, /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(_PageHeaderUtils.blockClass, "__non-navigation-row-content")
   }, hasBreadcrumbRow ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Row, {
-    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row"), (_cx2 = {}, (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--next-to-tabs"), nextToTabsCheck()), (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--has-breadcrumbs"), breadcrumbs), (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--has-action-bar"), hasActionBar), (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__has-page-actions-without-action-bar"), !hasActionBar && pageActions), _cx2))
+    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row"), (_cx2 = {}, (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--next-to-tabs"), nextToTabsCheck()), (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--has-breadcrumbs"), breadcrumbs || breadcrumbItemForTitle), (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--has-action-bar"), hasActionBar || widthIsNarrow), (0, _defineProperty2.default)(_cx2, "".concat(_PageHeaderUtils.blockClass, "__has-page-actions-without-action-bar"), !hasActionBar && !widthIsNarrow && pageActions), _cx2))
   }, /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-row--container")
   }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Column, {
-    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__breadcrumb-column"), (0, _defineProperty2.default)({}, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-column--background"), !!breadcrumbs || hasActionBar))
-  }, breadcrumbs ? /*#__PURE__*/_react.default.createElement(_BreadcrumbWithOverflow.BreadcrumbWithOverflow, {
+    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__breadcrumb-column"), (0, _defineProperty2.default)({}, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-column--background"), !!breadcrumbs || hasActionBar || widthIsNarrow))
+  }, breadcrumbs || breadcrumbItemForTitle ? /*#__PURE__*/_react.default.createElement(_BreadcrumbWithOverflow.BreadcrumbWithOverflow, {
     className: "".concat(_PageHeaderUtils.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.default.createElement(_carbonComponentsReact.Column, {
-    className: (0, _classnames.default)(["".concat(_PageHeaderUtils.blockClass, "__action-bar-column ").concat(_PageHeaderUtils.blockClass, "__action-bar-column--background"), (_ref6 = {}, (0, _defineProperty2.default)(_ref6, "".concat(_PageHeaderUtils.blockClass, "__action-bar-column--has-page-actions"), pageActions), (0, _defineProperty2.default)(_ref6, "".concat(_PageHeaderUtils.blockClass, "__action-bar-column--influenced-by-collapse-button"), spaceForCollapseButton), _ref6)])
+    className: (0, _classnames.default)(["".concat(_PageHeaderUtils.blockClass, "__action-bar-column ").concat(_PageHeaderUtils.blockClass, "__action-bar-column--background"), (_ref7 = {}, (0, _defineProperty2.default)(_ref7, "".concat(_PageHeaderUtils.blockClass, "__action-bar-column--has-page-actions"), pageActions), (0, _defineProperty2.default)(_ref7, "".concat(_PageHeaderUtils.blockClass, "__action-bar-column--influenced-by-collapse-button"), spaceForCollapseButton), _ref7)])
   }, /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(_PageHeaderUtils.blockClass, "__action-bar-column-content"),
     ref: sizingContainerRef
@@ -409,8 +417,8 @@ var PageHeader = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     className: "".concat(_PageHeaderUtils.blockClass, "__action-bar"),
     onWidthChange: handleActionBarWidthChange,
     rightAlign: true
-  })) : null)))) : null, !collapseTitle && (title || pageActions) ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Row, {
-    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__title-row"), (_cx4 = {}, (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--no-breadcrumb-row"), !hasBreadcrumbRow), (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--under-action-bar"), hasActionBar), (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--has-page-actions"), !!pageActions), (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--sticky"), !!pageActions && !actionBarItems && hasBreadcrumbRow), _cx4))
+  })) : widthIsNarrow && thePageActions(true, pageActionsInBreadcrumbRow))))) : null, !collapseTitle && (title || pageActions) ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Row, {
+    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__title-row"), (_cx4 = {}, (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--no-breadcrumb-row"), !hasBreadcrumbRow), (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--under-action-bar"), hasActionBar || widthIsNarrow), (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--has-page-actions"), !!pageActions), (0, _defineProperty2.default)(_cx4, "".concat(_PageHeaderUtils.blockClass, "__title-row--sticky"), !!pageActions && !actionBarItems && hasBreadcrumbRow), _cx4))
   }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Column, {
     className: "".concat(_PageHeaderUtils.blockClass, "__title-column")
   }, title ? /*#__PURE__*/_react.default.createElement(_PageHeaderTitle.PageHeaderTitle, {
@@ -543,8 +551,8 @@ PageHeader.propTypes = _objectSpread({
    *
    * NOTE: This prop is required if actionBarItems are supplied
    */
-  actionBarOverflowAriaLabel: _propTypes.default.string.isRequired.if(function (_ref8) {
-    var actionBarItems = _ref8.actionBarItems;
+  actionBarOverflowAriaLabel: _propTypes.default.string.isRequired.if(function (_ref9) {
+    var actionBarItems = _ref9.actionBarItems;
     return actionBarItems && actionBarItems.length > 0;
   }),
 
@@ -579,8 +587,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.default.string.isRequired.if(function (_ref9) {
-    var breadcrumbs = _ref9.breadcrumbs;
+  breadcrumbOverflowAriaLabel: _propTypes.default.string.isRequired.if(function (_ref10) {
+    var breadcrumbs = _ref10.breadcrumbs;
     return breadcrumbs && breadcrumbs.length > 0;
   }),
 
@@ -619,8 +627,8 @@ PageHeader.propTypes = _objectSpread({
     /**
      * A text version of the `label` for display, required if `label` is not a string.
      */
-    title: _propTypes.default.string.isRequired.if(function (_ref10) {
-      var label = _ref10.label;
+    title: _propTypes.default.string.isRequired.if(function (_ref11) {
+      var label = _ref11.label;
       return typeof label !== 'string';
     })
   })),
@@ -650,9 +658,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.default.string.isRequired.if(function (_ref11) {
-    var withoutBackground = _ref11.withoutBackground,
-        hasCollapseHeaderToggle = _ref11.hasCollapseHeaderToggle;
+  collapseHeaderIconDescription: _propTypes.default.string.isRequired.if(function (_ref12) {
+    var withoutBackground = _ref12.withoutBackground,
+        hasCollapseHeaderToggle = _ref12.hasCollapseHeaderToggle;
     return !withoutBackground && hasCollapseHeaderToggle;
   }),
 
@@ -672,9 +680,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.default.string.isRequired.if(function (_ref12) {
-    var withoutBackground = _ref12.withoutBackground,
-        hasCollapseHeaderToggle = _ref12.hasCollapseHeaderToggle;
+  expandHeaderIconDescription: _propTypes.default.string.isRequired.if(function (_ref13) {
+    var withoutBackground = _ref13.withoutBackground,
+        hasCollapseHeaderToggle = _ref13.hasCollapseHeaderToggle;
     return !withoutBackground && hasCollapseHeaderToggle;
   }),
 
@@ -745,8 +753,8 @@ PageHeader.propTypes = _objectSpread({
    *
    * NOTE: This prop is required if pageActions are supplied
    */
-  pageActionsOverflowLabel: _propTypes.default.node.isRequired.if(function (_ref13) {
-    var pageActions = _ref13.pageActions;
+  pageActionsOverflowLabel: _propTypes.default.node.isRequired.if(function (_ref14) {
+    var pageActions = _ref14.pageActions;
     return pageActions && pageActions.length > 0 && !pageActions.content;
   }),
 
@@ -792,6 +800,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
+   *    - revertDescription: label for edit revert 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
@@ -801,7 +814,18 @@ PageHeader.propTypes = _objectSpread({
     // Update docgen if changed
     text: _propTypes.default.string.isRequired,
     icon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
-    loading: _propTypes.default.bool // Update docgen if changed
+    loading: _propTypes.default.bool,
+    // inline edit version properties
+    editableLabel: _propTypes.default.string,
+    // .isRequired.if(inlineEditRequired),
+    id: _propTypes.default.string,
+    // .isRequired.if(inlineEditRequired),
+    onChange: _propTypes.default.func,
+    onSave: _propTypes.default.func,
+    revertDescription: _propTypes.default.string,
+    //.isRequired.if(inlineEditRequired),
+    saveDescription: _propTypes.default.string //.isRequired.if(inlineEditRequired),
+    // Update docgen if changed
 
   }), _propTypes.default.string, _propTypes.default.shape({
     content: _propTypes.default.node.isRequired,

package/lib/components/PageHeader/PageHeaderTitle.js

@@ -5,16 +5,26 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.PageHeaderTitle = void 0;
+exports.inlineEditRequired = exports.PageHeaderTitle = void 0;
 
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+
 var _react = _interopRequireDefault(require("react"));
 
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
 var _classnames = _interopRequireDefault(require("classnames"));
 
 var _carbonComponentsReact = require("carbon-components-react");
 
+var _ = require("../");
+
+var _excluded = ["text", "content", "loading", "icon", "asText", "onChange", "onSave", "editDescription", "editableLabel", "revertDescription", "saveDescription"];
+
 /**
  *
  * Utility component used by Page Header
@@ -26,14 +36,21 @@ 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 = (0, _objectWithoutProperties2.default)(title, _excluded);
   var titleText;
+  var isEditable = !!onSave;
 
   if (text || !content) {
     if (text === undefined && typeof title === 'string') {
@@ -44,20 +61,85 @@ var PageHeaderTitle = function PageHeaderTitle(_ref) {
     var TitleIcon = icon;
     titleInnards = /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, icon && !loading ? /*#__PURE__*/_react.default.createElement(TitleIcon, {
       className: "".concat(blockClass, "__title-icon")
-    }) : null, /*#__PURE__*/_react.default.createElement("span", {
-      title: !loading ? asText : null
-    }, loading ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.SkeletonText, {
+    }) : null, loading ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.SkeletonText, {
       className: "".concat(blockClass, "__title-skeleton")
-    }) : text));
+    }) : isEditable ? /*#__PURE__*/_react.default.createElement(_.InlineEdit, (0, _extends2.default)({
+      hideLabel: true,
+      value: text,
+      editDescription: editDescription,
+      onChange: onChange,
+      onSave: onSave,
+      labelText: editableLabel,
+      revertDescription: revertDescription,
+      saveDescription: saveDescription
+    }, rest)) : /*#__PURE__*/_react.default.createElement("span", {
+      title: !loading ? asText : null
+    }, text));
   } else {
     titleInnards = content;
     titleText = asText;
   }
 
   return /*#__PURE__*/_react.default.createElement("div", {
-    className: (0, _classnames.default)("".concat(blockClass, "__title"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__title--fades"), hasBreadcrumbRow)),
+    className: (0, _classnames.default)("".concat(blockClass, "__title"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__title--editable"), isEditable), (0, _defineProperty2.default)({}, "".concat(blockClass, "__title--fades"), hasBreadcrumbRow)),
     title: titleText
   }, titleInnards);
 };
 
-exports.PageHeaderTitle = PageHeaderTitle;
+exports.PageHeaderTitle = PageHeaderTitle;
+
+var inlineEditRequired = function inlineEditRequired(_ref2) {
+  var onSave = _ref2.onSave;
+  return !!onSave;
+};
+
+exports.inlineEditRequired = inlineEditRequired;
+PageHeaderTitle.propTypes = {
+  // passed from page header
+  blockClass: _propTypes.default.string.isRequired,
+
+  /**
+   * controlled from within page header
+   */
+  hasBreadcrumbRow: _propTypes.default.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.default.oneOfType([_propTypes.default.shape({
+    // Update docgen if changed
+    text: _propTypes.default.string.isRequired,
+    icon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+    loading: _propTypes.default.bool,
+    // inline edit version properties
+    editDescription: _propTypes.default.string.isRequired.if(inlineEditRequired),
+    editableLabel: _propTypes.default.string.isRequired.if(inlineEditRequired),
+    id: _propTypes.default.string.isRequired.if(inlineEditRequired),
+    onChange: _propTypes.default.func,
+    onSave: _propTypes.default.func,
+    revertDescription: _propTypes.default.string.isRequired.if(inlineEditRequired),
+    saveDescription: _propTypes.default.string.isRequired.if(inlineEditRequired) // Update docgen if changed
+
+  }), _propTypes.default.string, _propTypes.default.shape({
+    content: _propTypes.default.node.isRequired,
+    breadcrumbContent: _propTypes.default.node,
+    asText: _propTypes.default.string.isRequired
+  })])
+};

package/lib/components/PageHeader/PageHeaderUtils.js

@@ -30,12 +30,14 @@ var blockClass = "".concat(_settings.pkg.prefix, "--page-header");
  * @param {{}} offsetTopMeasuringRef
  * @param {{}} navigation
  * @param {boolean} disableBreadcrumbScroll
+ * @param {boolean} hasActionBar
+ * @param {boolean} widthIsNarrow
  * @param {()} setMetrics
  */
 
 exports.blockClass = blockClass;
 
-var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, setMetrics) {
+var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerRef, offsetTopMeasuringRef, navigation, disableBreadcrumbScroll, hasActionBar, widthIsNarrow, setMetrics) {
   var dynamicRefs = {};
 
   var getDynamicRef = function getDynamicRef(selector) {
@@ -70,6 +72,7 @@ var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerR
     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;
@@ -91,7 +94,8 @@ var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerR
     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;
@@ -112,9 +116,19 @@ var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerR
       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) {
@@ -135,6 +149,11 @@ var utilCheckUpdateVerticalSpace = function utilCheckUpdateVerticalSpace(headerR
       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/lib/components/RemoveModal/RemoveModal.js

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

package/lib/components/SidePanel/SidePanel.js

@@ -113,8 +113,12 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   var sidePanelInnerRef = (0, _react.useRef)();
   var sidePanelCloseRef = (0, _react.useRef)();
   var previousState = (0, _hooks.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
 
   (0, _react.useEffect)(function () {
     var panelRef = ref || sidePanelRef;
@@ -193,7 +197,7 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
 
 
   (0, _react.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"));
@@ -285,7 +289,7 @@ var SidePanel = /*#__PURE__*/_react.default.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
 
   (0, _react.useEffect)(function () {
     var handleOutsideClick = function handleOutsideClick(event) {
@@ -311,7 +315,7 @@ var SidePanel = /*#__PURE__*/_react.default.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
 
   (0, _react.useEffect)(function () {
     if (open) {
@@ -321,14 +325,21 @@ var SidePanel = /*#__PURE__*/_react.default.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
 
 
+  (0, _react.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");
@@ -349,7 +360,13 @@ var SidePanel = /*#__PURE__*/_react.default.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]);
+  (0, _react.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
 
   (0, _react.useEffect)(function () {
     if (shouldRender && slideIn) {
@@ -357,15 +374,15 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
 
       if (placement && placement === 'right' && pageContentElement) {
         pageContentElement.style.marginRight = 0;
-        pageContentElement.style.transition = "margin-right ".concat(_motion.moderate02);
+        pageContentElement.style.transition = !reducedMotion.matches ? "margin-right ".concat(_motion.moderate02) : null;
         pageContentElement.style.marginRight = _constants.SIDE_PANEL_SIZES[size];
       } else if (pageContentElement) {
         pageContentElement.style.marginLeft = 0;
-        pageContentElement.style.transition = "margin-left ".concat(_motion.moderate02);
+        pageContentElement.style.transition = !reducedMotion.matches ? "margin-left ".concat(_motion.moderate02) : null;
         pageContentElement.style.marginLeft = _constants.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 */
 
@@ -392,7 +409,7 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     var _cx, _cx2;
 
     return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement("div", {
-      className: (0, _classnames.default)("".concat(blockClass, "__title-container"), (_cx = {}, (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__on-detail-step"), currentStep > 0), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container-without-title"), !title), _cx))
+      className: (0, _classnames.default)("".concat(blockClass, "__title-container"), (_cx = {}, (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__on-detail-step"), currentStep > 0), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container-without-title"), !title), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container--reduced-motion"), reducedMotion.matches), _cx))
     }, currentStep > 0 && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
       "aria-label": navigationBackIconDescription,
       kind: "ghost",
@@ -449,7 +466,7 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       className: "".concat(blockClass, "__title-text"),
       title: title,
       "aria-hidden": false
-    }, title), animateTitle && title && title.length && /*#__PURE__*/_react.default.createElement("h2", {
+    }, title), animateTitle && title && title.length && !reducedMotion.matches && /*#__PURE__*/_react.default.createElement("h2", {
       className: "".concat(blockClass, "__collapsed-title-text"),
       title: title,
       "aria-hidden": true
@@ -466,7 +483,7 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     id: "".concat(blockClass, "-outer"),
     className: mainPanelClassNames,
     style: {
-      animation: "".concat(open ? placement === 'right' ? "sidePanelEntranceRight ".concat(_motion.moderate02) : "sidePanelEntranceLeft ".concat(_motion.moderate02) : placement === 'right' ? "sidePanelExitRight ".concat(_motion.moderate02) : "sidePanelExitLeft ".concat(_motion.moderate02))
+      animation: !reducedMotion.matches ? "".concat(open ? placement === 'right' ? "side-panel-entrance-right ".concat(_motion.moderate02) : "side-panel-entrance-left ".concat(_motion.moderate02) : placement === 'right' ? "side-panel-exit-right ".concat(_motion.moderate02) : "side-panel-exit-left ".concat(_motion.moderate02)) : null
     },
     onAnimationEnd: onAnimationEnd,
     onAnimationStart: function onAnimationStart(event) {
@@ -499,7 +516,7 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     ref: sidePanelOverlayRef,
     className: "".concat(blockClass, "__overlay"),
     style: {
-      animation: "".concat(open ? "sidePanelOverlayEntrance ".concat(_motion.moderate02) : "sidePanelOverlayExit ".concat(_motion.moderate02))
+      animation: !reducedMotion.matches ? "".concat(open ? "side-panel-overlay-entrance ".concat(_motion.moderate02) : "side-panel-overlay-exit ".concat(_motion.moderate02)) : null
     }
   }));
 }); // Return a placeholder if not released and not enabled by feature flag
@@ -533,7 +550,7 @@ SidePanel.propTypes = {
    * See https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
    */
   actions: (0, _propsHelper.allPropTypes)([_ActionSet.ActionSet.validateActions(), _propTypes.default.arrayOf(_propTypes.default.shape(_objectSpread(_objectSpread({}, _carbonComponentsReact.Button.propTypes), {}, {
-    kind: _propTypes.default.oneOf(['ghost', 'secondary', 'primary']),
+    kind: _propTypes.default.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
     label: _propTypes.default.string,
     loading: _propTypes.default.bool,
     // we duplicate this Button prop to improve the DocGen here

package/lib/components/SingleAddSelect/SingleAddSelect.js

@@ -0,0 +1,36 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SingleAddSelect = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _AddSelect = require("../AddSelect");
+
+var _devtools = require("../../global/js/utils/devtools");
+
+var _settings = require("../../settings");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+// import PropTypes from 'prop-types';
+var componentName = 'SingleAddSelect';
+var SingleAddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
+  return /*#__PURE__*/_react.default.createElement(_AddSelect.AddSelect, (0, _extends2.default)({}, props, {
+    ref: ref
+  }, (0, _devtools.getDevtoolsProps)(componentName)));
+});
+exports.SingleAddSelect = SingleAddSelect;
+exports.SingleAddSelect = SingleAddSelect = _settings.pkg.checkComponentEnabled(SingleAddSelect, componentName);
+SingleAddSelect.propTypes = {};
+SingleAddSelect.displayName = componentName;

package/lib/components/SingleAddSelect/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "SingleAddSelect", {
+  enumerable: true,
+  get: function get() {
+    return _SingleAddSelect.SingleAddSelect;
+  }
+});
+
+var _SingleAddSelect = require("./SingleAddSelect");