@carbon/ibm-products 1.2.3 → 1.4.0

package/lib/components/OptionsTile/OptionsTile.js

@@ -35,7 +35,7 @@ var _iconsReact = require("@carbon/icons-react");
 
 var carbonMotion = _interopRequireWildcard(require("@carbon/motion"));
 
-var _excluded = ["children", "className", "enabled", "heading", "headingId", "invalid", "invalidText", "locked", "lockedText", "onToggle", "size", "summary", "warn", "warnText"];
+var _excluded = ["children", "className", "enabled", "heading", "headingId", "invalid", "invalidText", "locked", "lockedText", "onToggle", "open", "size", "summary", "warn", "warnText"];
 
 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); }
 
@@ -60,22 +60,27 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       locked = _ref.locked,
       lockedText = _ref.lockedText,
       onToggle = _ref.onToggle,
-      _ref$size = _ref.size,
-      size = _ref$size === void 0 ? 'xl' : _ref$size,
+      open = _ref.open,
+      size = _ref.size,
       summary = _ref.summary,
       warn = _ref.warn,
       warnText = _ref.warnText,
       rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
 
-  var _useState = (0, _react.useState)(false),
+  var _useState = (0, _react.useState)(open),
       _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-      open = _useState2[0],
-      setOpen = _useState2[1];
+      isOpen = _useState2[0],
+      setIsOpen = _useState2[1];
 
-  var _useState3 = (0, _react.useState)(false),
+  var _useState3 = (0, _react.useState)(open),
       _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
-      closing = _useState4[0],
-      setClosing = _useState4[1];
+      prevIsOpen = _useState4[0],
+      setPrevIsOpen = _useState4[1];
+
+  var _useState5 = (0, _react.useState)(false),
+      _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+      closing = _useState6[0],
+      setClosing = _useState6[1];
 
   var detailsRef = (0, _react.useRef)(null);
   var contentRef = (0, _react.useRef)(null);
@@ -89,9 +94,19 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     matches: true
   };
 
+  if (open !== prevIsOpen) {
+    if (isOpen && !open) {
+      collapse();
+    } else if (!isOpen && open) {
+      expand();
+    }
+
+    setPrevIsOpen(open);
+  }
+
   function expand() {
     if (detailsRef.current && contentRef.current && !reducedMotion.matches) {
-      setOpen(true);
+      setIsOpen(true);
       detailsRef.current.open = true;
 
       var _getComputedStyle = getComputedStyle(contentRef.current),
@@ -117,7 +132,7 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       });
     } else {
       // in case the refs are not set or the user prefers reduced motion, skip the animation
-      setOpen(true);
+      setIsOpen(true);
     }
   }
 
@@ -146,7 +161,7 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       });
 
       var callback = function callback() {
-        setOpen(false);
+        setIsOpen(false);
         setClosing(false);
       };
 
@@ -154,14 +169,14 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       animation.oncancel = callback;
     } else {
       // in case the ref is not set or the user prefers reduced motion, skip the animation
-      setOpen(false);
+      setIsOpen(false);
     }
   }
 
   function toggle(e) {
     e.preventDefault();
 
-    if (open) {
+    if (isOpen) {
       collapse();
     } else {
       expand();
@@ -218,7 +233,7 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     size: "sm",
     disabled: isLocked
   })), isExpandable ? /*#__PURE__*/_react.default.createElement("details", {
-    open: open,
+    open: isOpen,
     ref: detailsRef
   }, /*#__PURE__*/_react.default.createElement("summary", {
     className: "".concat(blockClass, "__header"),
@@ -298,6 +313,11 @@ OptionsTile.propTypes = {
    */
   onToggle: _propTypes.default.func,
 
+  /**
+   * Whether the OptionsTile is in open state.
+   */
+  open: _propTypes.default.bool,
+
   /**
    * Define the size of the OptionsTile.
    */
@@ -323,5 +343,6 @@ OptionsTile.propTypes = {
 // component needs to make a choice or assumption when a prop is not supplied.
 
 OptionsTile.defaultProps = {
+  open: false,
   size: 'xl'
 };

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,18 @@ 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), (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))
+    className: (0, _classnames.default)("".concat(_PageHeaderUtils.blockClass, "__breadcrumb-column"), (0, _defineProperty2.default)({}, "".concat(_PageHeaderUtils.blockClass, "__breadcrumb-column--background"), !!breadcrumbs || hasActionBar || widthIsNarrow))
   }, breadcrumbs ? /*#__PURE__*/_react.default.createElement(_BreadcrumbWithOverflow.BreadcrumbWithOverflow, {
     className: "".concat(_PageHeaderUtils.blockClass, "__breadcrumb"),
     noTrailingSlash: !!title,
     overflowAriaLabel: breadcrumbOverflowAriaLabel,
     breadcrumbs: breadcrumbs ? breadcrumbItemForTitle ? breadcrumbs.concat(breadcrumbItemForTitle) : breadcrumbs : null
   }) : 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 +416,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 +550,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 +586,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 +626,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 +657,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 +679,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 +752,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 +799,10 @@ PageHeader.propTypes = _objectSpread({
    *    - text: title string
    *    - icon: optional icon
    *    - loading: boolean shows loading indicator if true
+   *    - onChange: function to process edits only supply if in place edit is desired
+   *    - 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 +812,17 @@ 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,
+    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", "editDescription", "editableLabel", "revertDescription", "saveDescription"];
+
 /**
  *
  * Utility component used by Page Header
@@ -26,14 +36,20 @@ 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,
+      editDescription = title.editDescription,
+      editableLabel = title.editableLabel,
+      revertDescription = title.revertDescription,
+      saveDescription = title.saveDescription,
+      rest = (0, _objectWithoutProperties2.default)(title, _excluded);
   var titleText;
+  var isEditable = !!onChange;
 
   if (text || !content) {
     if (text === undefined && typeof title === 'string') {
@@ -44,20 +60,82 @@ 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,
+      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 onChange = _ref2.onChange;
+  return !!onChange;
+};
+
+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 edits only supply if in place edit is desired
+   *    - editDescription: description for edit button
+   *    - editableLabel: label for edit required if onChange 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,
+    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/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");

package/lib/components/TagSet/TagSet.js

@@ -38,7 +38,7 @@ var _propsHelper = require("../../global/js/utils/props-helper");
 var _settings = require("../../settings");
 
 var _excluded = ["align", "className", "maxVisible", "overflowAlign", "overflowClassName", "overflowDirection", "allTagsModalTitle", "allTagsModalSearchLabel", "allTagsModalSearchPlaceholderText", "showAllTagsLabel", "tags"],
-    _excluded2 = ["label"],
+    _excluded2 = ["label", "id"],
     _excluded3 = ["label"];
 
 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); }
@@ -108,6 +108,7 @@ var TagSet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
 
     setHiddenSizingTags(tags && tags.length > 0 ? tags.map(function (_ref2, index) {
       var label = _ref2.label,
+          id = _ref2.id,
           other = (0, _objectWithoutProperties2.default)(_ref2, _excluded2);
       return /*#__PURE__*/_react.default.createElement("div", {
         key: index,
@@ -116,6 +117,8 @@ var TagSet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
           return newSizingTags[index] = el;
         }
       }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Tag, (0, _extends2.default)({}, other, {
+        // ensure id is not duplicated
+        "data-original-id": id,
         filter: false
       }), label));
     }) : []);