@carbon/ibm-products 1.8.0 → 1.11.0

package/es/components/DataSpreadsheet/utils/createCellSelectionArea.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { px } from '@carbon/layout';
+import { deepCloneObject } from '../../../global/js/utils/deepCloneObject';
+export var createCellSelectionArea = function createCellSelectionArea(_ref) {
+  var area = _ref.area,
+      blockClass = _ref.blockClass,
+      defaultColumn = _ref.defaultColumn,
+      selectionAreas = _ref.selectionAreas,
+      setSelectionAreas = _ref.setSelectionAreas;
+  var greatestRow = Math.max(area.point1.row, area.point2.row);
+  var greatestColumn = Math.max(area.point1.column, area.point2.column);
+  var lowestRowIndex = Math.min(area.point1.row, area.point2.row);
+  var lowestColumnIndex = Math.min(area.point1.column, area.point2.column);
+  var point1Element = document.querySelector("[data-row-index=\"".concat(area.point1.row, "\"][data-column-index=\"").concat(area.point1.column, "\"]")) || document.querySelector(".".concat(blockClass, "__body--td")); // if we can't find the point1 element (this can happen in the case where a virtualized row is not present anymore in the DOM), we get the default height/width of the first body cell we find
+
+  var selectionAreaCellWidth = point1Element.offsetWidth;
+  var selectionAreaCellHeight = point1Element.offsetHeight;
+  var selectionAreaTotalWidth = selectionAreaCellWidth * (greatestColumn - lowestColumnIndex + 1);
+  var selectionAreaTotalHeight = selectionAreaCellHeight * (greatestRow - lowestRowIndex + 1);
+  var bodyContainer = document.querySelector(".".concat(blockClass, "__list--container")).firstElementChild;
+  var placementElement = bodyContainer.querySelector("[data-row-index=\"".concat(lowestRowIndex, "\"][data-column-index=\"").concat(lowestColumnIndex, "\"]"));
+  var relativePosition = {
+    top: placementElement ? placementElement.getBoundingClientRect().top - bodyContainer.getBoundingClientRect().top : lowestRowIndex === 0 ? 0 : selectionAreaCellHeight * lowestRowIndex,
+    // calculate top value here if virtualized row is not in DOM
+    left: placementElement ? placementElement.getBoundingClientRect().left - bodyContainer.getBoundingClientRect().left : lowestColumnIndex === 0 ? 0 + (defaultColumn.rowHeaderWidth - 4) : selectionAreaCellWidth * lowestColumnIndex + (defaultColumn.rowHeaderWidth - 4) // calculate left value here if virtualized row is not in DOM, accounting for row header cell width (including borders)
+
+  };
+  var selectionAreaElement = document.querySelector("[data-matcher-id=\"".concat(area.matcher, "\"]")) || document.createElement('div');
+  selectionAreaElement.classList.add("".concat(blockClass, "__selection-area--element"));
+  selectionAreaElement.setAttribute('data-matcher-id', area.matcher);
+  selectionAreaElement.style.width = px(selectionAreaTotalWidth);
+  selectionAreaElement.style.height = px(selectionAreaTotalHeight);
+  selectionAreaElement.style.left = px(relativePosition.left);
+  selectionAreaElement.style.top = px(relativePosition.top);
+  bodyContainer.appendChild(selectionAreaElement);
+  var selectionAreasClone = deepCloneObject(selectionAreas);
+  var indexOfCurrentArea = selectionAreasClone.findIndex(function (item) {
+    return item.matcher === area.matcher;
+  }); // We need to add another property to the selectionAreas object array to
+  // let us know if an area has been created for each item already, ie createdArea: true
+
+  selectionAreasClone[indexOfCurrentArea].areaCreated = true;
+  setSelectionAreas(selectionAreasClone);
+};

package/es/components/DataSpreadsheet/{generateData.js → utils/generateData.js}

@@ -4,6 +4,12 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 // cspell:disable
 var pets = ['dog', 'cat', 'bird', 'lizard', 'frog', 'hamster', 'fish', 'rabbit', 'snake'];
 var petNames = ['Bruno', 'Willow', 'Kona', 'Heidi', 'Rusty', 'Bonnie', 'Cash', 'Gucci', 'Brody', 'Emma', 'Loki', 'Angel', 'Astro', 'Sherman', 'Layla', 'Peanut', 'Grace', 'Mickey', 'Sasha', 'Finn', 'Tucker', 'Bear', 'Mocha', 'Roscoe']; // cspell:enable

package/es/components/DataSpreadsheet/utils/handleHeaderCellSelection.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import uuidv4 from '../../../global/js/utils/uuidv4';
+import { removeCellSelections } from './removeCellSelections';
+export var handleHeaderCellSelection = function handleHeaderCellSelection(_ref) {
+  var type = _ref.type,
+      activeCellCoordinates = _ref.activeCellCoordinates,
+      rows = _ref.rows,
+      columns = _ref.columns,
+      setActiveCellCoordinates = _ref.setActiveCellCoordinates,
+      setCurrentMatcher = _ref.setCurrentMatcher,
+      setSelectionAreas = _ref.setSelectionAreas,
+      spreadsheetRef = _ref.spreadsheetRef,
+      index = _ref.index,
+      isKeyboard = _ref.isKeyboard;
+  var rowValue = isKeyboard ? activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row : index;
+  var columnValue = isKeyboard ? activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column : index;
+  var point1 = {
+    row: type === 'column' ? 0 : rowValue,
+    column: type === 'column' ? columnValue : 0
+  };
+  var point2 = {
+    row: type === 'column' ? rows.length - 1 : rowValue,
+    // going to always be the last row
+    column: type === 'column' ? columnValue : columns.length - 1
+  };
+  var tempMatcher = uuidv4();
+  setActiveCellCoordinates({
+    row: type === 'column' ? 0 : rowValue,
+    column: type === 'column' ? columnValue : 0
+  });
+  setCurrentMatcher(tempMatcher);
+  removeCellSelections({
+    spreadsheetRef: spreadsheetRef
+  });
+  setSelectionAreas([{
+    point1: point1,
+    point2: point2,
+    areaCreated: false,
+    matcher: tempMatcher
+  }]);
+};

package/es/components/DataSpreadsheet/utils/handleMultipleKeys.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { deepCloneObject } from '../../../global/js/utils/deepCloneObject';
+export var handleMultipleKeys = function handleMultipleKeys(_ref) {
+  var _selectionAreasClone$;
+
+  var activeKeys = _ref.activeKeys,
+      selectionAreas = _ref.selectionAreas,
+      currentMatcher = _ref.currentMatcher,
+      rows = _ref.rows,
+      setSelectionAreas = _ref.setSelectionAreas,
+      columns = _ref.columns;
+  var activeKeyValues = activeKeys.current;
+  var selectionAreasClone = deepCloneObject(selectionAreas);
+  var indexOfCurrentArea = selectionAreasClone.findIndex(function (item) {
+    return item.matcher === currentMatcher;
+  });
+  var pointToUpdate = (_selectionAreasClone$ = selectionAreasClone[indexOfCurrentArea]) !== null && _selectionAreasClone$ !== void 0 && _selectionAreasClone$.point2 ? selectionAreasClone[indexOfCurrentArea].point2 : selectionAreasClone[indexOfCurrentArea].point1; // Down + Shift
+
+  if (activeKeyValues.includes('Shift') && activeKeyValues.includes('ArrowDown')) {
+    if (rows.length - 1 === pointToUpdate.row) {
+      return;
+    }
+
+    var newPoint = {
+      row: pointToUpdate.row + 1,
+      column: pointToUpdate.column
+    };
+    selectionAreasClone[indexOfCurrentArea].point2 = newPoint;
+    selectionAreasClone[indexOfCurrentArea].areaCreated = false;
+    setSelectionAreas(selectionAreasClone);
+  } // Right + Shift
+
+
+  if (activeKeyValues.includes('Shift') && activeKeyValues.includes('ArrowRight')) {
+    if (columns.length - 1 === pointToUpdate.column) {
+      return;
+    }
+
+    var _newPoint = {
+      row: pointToUpdate.row,
+      column: pointToUpdate.column + 1
+    };
+    selectionAreasClone[indexOfCurrentArea].point2 = _newPoint;
+    selectionAreasClone[indexOfCurrentArea].areaCreated = false;
+    setSelectionAreas(selectionAreasClone);
+  } // Up + Shift
+
+
+  if (activeKeyValues.includes('Shift') && activeKeyValues.includes('ArrowUp')) {
+    if (pointToUpdate.row === 0) {
+      return;
+    }
+
+    var _newPoint2 = {
+      row: pointToUpdate.row - 1,
+      column: pointToUpdate.column
+    };
+    selectionAreasClone[indexOfCurrentArea].point2 = _newPoint2;
+    selectionAreasClone[indexOfCurrentArea].areaCreated = false;
+    setSelectionAreas(selectionAreasClone);
+  } // Left + Shift
+
+
+  if (activeKeyValues.includes('Shift') && activeKeyValues.includes('ArrowLeft')) {
+    if (pointToUpdate.column === 0) {
+      return;
+    }
+
+    var _newPoint3 = {
+      row: pointToUpdate.row,
+      column: pointToUpdate.column - 1
+    };
+    selectionAreasClone[indexOfCurrentArea].point2 = _newPoint3;
+    selectionAreasClone[indexOfCurrentArea].areaCreated = false;
+    setSelectionAreas(selectionAreasClone);
+  }
+};

package/es/components/DataSpreadsheet/utils/removeCellSelections.js

@@ -0,0 +1,30 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { pkg } from '../../../settings'; // Removes the cell selection elements
+
+export var removeCellSelections = function removeCellSelections(_ref) {
+  var matcher = _ref.matcher,
+      spreadsheetRef = _ref.spreadsheetRef,
+      _ref$blockClass = _ref.blockClass,
+      blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass;
+
+  if (matcher && typeof matcher === 'string') {
+    var selectionToRemove = spreadsheetRef.current.querySelector("[data-matcher-id=\"".concat(matcher, "\"]"));
+
+    if (selectionToRemove) {
+      selectionToRemove.remove();
+    }
+  } else {
+    var cellSelections = spreadsheetRef.current.querySelectorAll(".".concat(blockClass, "__selection-area--element"));
+
+    _toConsumableArray(cellSelections).forEach(function (element) {
+      return element.remove();
+    });
+  }
+};

package/es/components/InlineEdit/InlineEdit.js

@@ -1,8 +1,9 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _typeof from "@babel/runtime/helpers/typeof";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["cancelDescription", "className", "disabled", "editDescription", "editVisibleOnHoverOnly", "id", "invalid", "invalidText", "labelText", "light", "onCancel", "onSave", "onChange", "placeholder", "saveDescription", "size", "value", "warn", "warnText"];
+var _excluded = ["buttonTooltipAlignment", "buttonTooltipPosition", "cancelDescription", "className", "disabled", "editAlwaysVisible", "editDescription", "id", "invalid", "invalidText", "labelText", "light", "onCancel", "onSave", "onChange", "placeholder", "saveDescription", "size", "value"];
 
 /**
  * Copyright IBM Corp. 2022, 2022
@@ -21,16 +22,19 @@ import { pkg, carbon } from '../../settings'; // Carbon and package components w
 /* TODO: @import(s) of carbon components and other package components. */
 
 import { Button } from 'carbon-components-react';
-import { Close16, Edit16, EditOff16, Checkmark16, WarningFilled16, WarningAltFilled16 } from '@carbon/icons-react'; // The block part of our conventional BEM class names (blockClass__E--M).
+import { Close16, Edit16, EditOff16, Checkmark16, WarningFilled16 } from '@carbon/icons-react'; // The block part of our conventional BEM class names (blockClass__E--M).
 
 var blockClass = "".concat(pkg.prefix, "--inline-edit");
 var componentName = 'InlineEdit'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
 
 var defaults = {
+  buttonTooltipAlignment: 'center',
+  buttonTooltipPosition: 'top',
   light: true,
   // defaults to true to reflect design
   size: 'md'
 };
+var buttons = ['cancel', 'edit', 'save'];
 /**
  * TODO: A description of the component.
  */
@@ -38,11 +42,13 @@ var defaults = {
 export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
   var _cx, _refInput$current, _refInput$current$inn, _cx3;
 
-  var cancelDescription = _ref.cancelDescription,
+  var buttonTooltipAlignment = _ref.buttonTooltipAlignment,
+      buttonTooltipPosition = _ref.buttonTooltipPosition,
+      cancelDescription = _ref.cancelDescription,
       className = _ref.className,
       disabled = _ref.disabled,
+      editAlwaysVisible = _ref.editAlwaysVisible,
       editDescription = _ref.editDescription,
-      editVisibleOnHoverOnly = _ref.editVisibleOnHoverOnly,
       id = _ref.id,
       invalid = _ref.invalid,
       invalidText = _ref.invalidText,
@@ -57,8 +63,6 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
       _ref$size = _ref.size,
       size = _ref$size === void 0 ? defaults.size : _ref$size,
       value = _ref.value,
-      warn = _ref.warn,
-      warnText = _ref.warnText,
       rest = _objectWithoutProperties(_ref, _excluded);
 
   var refInput = useRef(null);
@@ -75,9 +79,25 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
       internalValue = _useState4[0],
       setInternalValue = _useState4[1];
 
-  var showValidation = invalid || warn;
-  var validationText = invalidText || warnText;
-  var validationIcon = showValidation ? invalid ? /*#__PURE__*/React.createElement(WarningFilled16, null) : /*#__PURE__*/React.createElement(WarningAltFilled16, null) : null;
+  var showValidation = invalid; // || warn;
+
+  var validationText = invalidText; // || warnText;
+
+  var validationIcon = showValidation ? /*#__PURE__*/React.createElement(WarningFilled16, null) : null; // sanitize the tooltip values
+
+  var alignIsObject = _typeof(buttonTooltipAlignment) === 'object';
+  var directionIsObject = _typeof(buttonTooltipPosition) === 'object';
+  var tipPositions = buttons.reduce(function (acc, button) {
+    var _ref2, _ref3;
+
+    var tooltipAlignment = (_ref2 = alignIsObject ? buttonTooltipAlignment[button] : buttonTooltipAlignment) !== null && _ref2 !== void 0 ? _ref2 : defaults.buttonTooltipAlignment;
+    var tooltipPosition = (_ref3 = directionIsObject ? buttonTooltipPosition[button] : buttonTooltipPosition) !== null && _ref3 !== void 0 ? _ref3 : defaults.buttonTooltipPosition;
+    acc[button] = {
+      tooltipAlignment: tooltipAlignment,
+      tooltipPosition: tooltipPosition
+    };
+    return acc;
+  }, {});
 
   var doSetEditing = function doSetEditing(value) {
     if (value === false) {
@@ -89,6 +109,7 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
   };
 
   var handleEdit = function handleEdit(ev) {
+    /* istanbul ignore else */
     if (!disabled) {
       var rightOfInput = ev.currentTarget.classList.contains("".concat(blockClass, "__edit")) || ev.target.classList.contains("".concat(blockClass, "__after-input-elements"));
       var leftOfInput = ev.currentTarget = ev.target.classList.contains("".concat(blockClass)); // clicking on the content editable element should not set either of these to true
@@ -135,9 +156,12 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
     if (onChange) {
       onChange(refInput.current.innerText);
     }
-  };
+  }; // pasting into contentEditable not supported by userEvent
+
 
-  var handlePaste = function handlePaste(ev) {
+  var handlePaste =
+  /* istanbul ignore next */
+  function handlePaste(ev) {
     ev.preventDefault(); // Get clipboard as plain text
 
     var text = (ev.clipboardData || window.clipboardData).getData('text/plain'); // remove \n
@@ -182,9 +206,16 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
   };
 
   var handleKeyDown = function handleKeyDown(ev) {
-    if (ev.key === 'Enter') {
-      ev.preventDefault();
-      refInput.current.blur(); // will cause save
+    switch (ev.key) {
+      case 'Enter':
+        ev.preventDefault();
+        refInput.current.blur(); // will cause save
+
+        break;
+
+      case 'Escape':
+        handleCancel();
+        break;
     }
   };
   /*
@@ -218,7 +249,7 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
     React.createElement("div", {
       className: cx(blockClass, // Apply the block class to the main HTML element
       className, // Apply any supplied class names to the main HTML element.
-      "".concat(blockClass, "--").concat(size), (_cx = {}, _defineProperty(_cx, "".concat(blockClass, "--disabled"), disabled), _defineProperty(_cx, "".concat(blockClass, "--editing"), editing), _defineProperty(_cx, "".concat(blockClass, "--invalid"), invalid), _defineProperty(_cx, "".concat(blockClass, "--warn"), warn), _defineProperty(_cx, "".concat(blockClass, "--light"), light), _defineProperty(_cx, "".concat(blockClass, "--overflows"), refInput.current && refInput.current.scrollWidth > refInput.current.offsetWidth), _cx)),
+      "".concat(blockClass, "--").concat(size), (_cx = {}, _defineProperty(_cx, "".concat(blockClass, "--disabled"), disabled), _defineProperty(_cx, "".concat(blockClass, "--editing"), editing), _defineProperty(_cx, "".concat(blockClass, "--invalid"), invalid), _defineProperty(_cx, "".concat(blockClass, "--light"), light), _defineProperty(_cx, "".concat(blockClass, "--overflows"), refInput.current && refInput.current.scrollWidth > refInput.current.offsetWidth), _cx)),
       onClick: handleEdit // disabled eslint for click handler
       ,
       onBlur: handleBlur,
@@ -249,14 +280,14 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
       className: cx("".concat(blockClass, "__toolbar"), (_cx3 = {}, _defineProperty(_cx3, "".concat(blockClass, "__toolbar--animation"), toolbarAnimation), _defineProperty(_cx3, "".concat(blockClass, "__toolbar--saveable"), refInput.current && value !== internalValue), _cx3))
     }, showValidation && /*#__PURE__*/React.createElement("div", {
       className: "".concat(blockClass, "__validation-icon")
-    }, validationIcon), editing ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Button, {
+    }, validationIcon), editing ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Button, _extends({
       className: "".concat(blockClass, "__cancel"),
       kind: "ghost",
       hasIconOnly: true,
       iconDescription: cancelDescription,
       onClick: handleCancel,
       renderIcon: Close16
-    }), /*#__PURE__*/React.createElement(Button, {
+    }, tipPositions.cancel)), /*#__PURE__*/React.createElement(Button, _extends({
       className: "".concat(blockClass, "__save"),
       kind: "ghost",
       hasIconOnly: true,
@@ -264,9 +295,8 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
       onClick: handleSave,
       renderIcon: Checkmark16,
       disabled: value === internalValue
-    })) : /*#__PURE__*/React.createElement(Button, {
-      "aria-hidden": "true",
-      className: cx("".concat(blockClass, "__edit"), _defineProperty({}, "".concat(blockClass, "__edit--hover-visible"), editVisibleOnHoverOnly)),
+    }, tipPositions.save))) : /*#__PURE__*/React.createElement(Button, _extends({
+      className: cx("".concat(blockClass, "__edit"), _defineProperty({}, "".concat(blockClass, "__edit--always-visible"), editAlwaysVisible)),
       kind: "ghost",
       hasIconOnly: true,
       iconDescription: editDescription,
@@ -274,7 +304,7 @@ export var InlineEdit = /*#__PURE__*/React.forwardRef(function (_ref, refIn) {
       renderIcon: disabled ? EditOff16 : Edit16,
       disabled: disabled,
       tabIndex: -1
-    }))), /*#__PURE__*/React.createElement("div", {
+    }, tipPositions.edit)))), /*#__PURE__*/React.createElement("div", {
       className: cx("".concat(blockClass, "__disabled-cover"))
     }), showValidation && validationText && validationText.length > 0 && /*#__PURE__*/React.createElement("div", {
       className: "".concat(blockClass, "__validation-text ").concat(carbon.prefix, "--form-requirement")
@@ -290,6 +320,28 @@ InlineEdit.displayName = componentName; // The types and DocGen commentary for t
 // See https://www.npmjs.com/package/prop-types#usage.
 
 InlineEdit.propTypes = {
+  /**
+   * buttonTooltipAlignment from the standard tooltip. Default center.
+   *
+   * Can be passed either as one of tooltip options or as an object specifying cancel, edit and save separately
+   */
+  buttonTooltipAlignment: PropTypes.oneOfType([PropTypes.oneOf(['start', 'center', 'end']), PropTypes.shape({
+    cancel: PropTypes.oneOf(['start', 'center', 'end']),
+    edit: PropTypes.oneOf(['start', 'center', 'end']),
+    save: PropTypes.oneOf(['start', 'center', 'end'])
+  })]),
+
+  /**
+   * buttonTooltipPosition from the standard tooltip
+   *
+   * Can be passed either as one of tooltip options or as an object specifying cancel, edit and save separately
+   */
+  buttonTooltipPosition: PropTypes.oneOfType([PropTypes.oneOf(['top', 'right', 'bottom', 'left']), PropTypes.shape({
+    cancel: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
+    edit: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
+    save: PropTypes.oneOf(['top', 'right', 'bottom', 'left'])
+  })]),
+
   /**
    * label for cancel button
    */
@@ -306,15 +358,14 @@ InlineEdit.propTypes = {
   disabled: PropTypes.bool,
 
   /**
-   * Label for the edit button
+   * By default the edit icon is shown on hover only.
    */
-  editDescription: PropTypes.string.isRequired,
+  editAlwaysVisible: PropTypes.bool,
 
   /**
-   * In some scenarios the edit icon only needs to be shown on hover. These cases are where continual visibility of
-   * the edit icon is redundant. E.g. a spreadsheet a property panel.
+   * Label for the edit button
    */
-  editVisibleOnHoverOnly: PropTypes.bool,
+  editDescription: PropTypes.string.isRequired,
 
   /**
    * ID for inline edit
@@ -349,14 +400,14 @@ InlineEdit.propTypes = {
   /**
    * method called on input event (it's a React thing onChange behaves like on input).
    *
-   * NOTE: caller to handle invalid/warn states and associated text
+   * NOTE: caller to handle invalid states and associated text
    */
   onChange: PropTypes.func,
 
   /**
    * method called on change event
    *
-   * NOTE: caller to handle invalid/warn states and associated text
+   * NOTE: caller to handle invalid states and associated text
    */
   onSave: PropTypes.func,
 
@@ -378,15 +429,5 @@ InlineEdit.propTypes = {
   /**
    * initial/unedited value
    */
-  value: PropTypes.string,
-
-  /**
-   * set warn state for input
-   */
-  warn: PropTypes.bool,
-
-  /**
-   * text shown when warn true
-   */
-  warnText: PropTypes.string
+  value: PropTypes.string
 };

package/es/components/OptionsTile/OptionsTile.js

@@ -2,10 +2,10 @@ import _extends from "@babel/runtime/helpers/extends";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["children", "className", "enabled", "heading", "headingId", "invalid", "invalidText", "locked", "lockedText", "onToggle", "open", "size", "summary", "warn", "warnText"];
+var _excluded = ["children", "className", "enabled", "invalid", "invalidText", "locked", "lockedText", "onToggle", "open", "size", "summary", "title", "titleId", "warn", "warnText"];
 
 /**
- * Copyright IBM Corp. 2021, 2021
+ * Copyright IBM Corp. 2021, 2022
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -38,8 +38,6 @@ export var OptionsTile = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var children = _ref.children,
       className = _ref.className,
       enabled = _ref.enabled,
-      heading = _ref.heading,
-      userDefinedHeadingId = _ref.headingId,
       invalid = _ref.invalid,
       invalidText = _ref.invalidText,
       locked = _ref.locked,
@@ -49,6 +47,8 @@ export var OptionsTile = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       _ref$size = _ref.size,
       size = _ref$size === void 0 ? defaults.size : _ref$size,
       summary = _ref.summary,
+      title = _ref.title,
+      userDefinedTitleId = _ref.titleId,
       warn = _ref.warn,
       warnText = _ref.warnText,
       rest = _objectWithoutProperties(_ref, _excluded);
@@ -71,7 +71,7 @@ export var OptionsTile = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var detailsRef = useRef(null);
   var contentRef = useRef(null);
   var id = uuidv4();
-  var headingId = userDefinedHeadingId !== null && userDefinedHeadingId !== void 0 ? userDefinedHeadingId : "".concat(id, "-heading");
+  var titleId = userDefinedTitleId !== null && userDefinedTitleId !== void 0 ? userDefinedTitleId : "".concat(id, "-title");
   var isExpandable = children !== undefined;
   var isInvalid = invalid;
   var isWarn = !isInvalid && warn;
@@ -185,15 +185,25 @@ export var OptionsTile = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     } else if (locked) {
       Icon = Locked16;
       summaryClasses.push("".concat(blockClass, "__summary--locked"));
+
+      if (!text) {
+        text = lockedText;
+      }
+    }
+
+    var hasValidationState = invalid || warn || locked;
+    var summaryHidden = !hasValidationState && enabled === false;
+
+    if (summaryHidden) {
+      summaryClasses.push("".concat(blockClass, "__summary--hidden"));
     }
 
-    var summaryHidden = enabled === false;
     return /*#__PURE__*/React.createElement("div", {
-      className: "".concat(blockClass, "__title")
-    }, /*#__PURE__*/React.createElement("h6", {
-      id: headingId,
       className: "".concat(blockClass, "__heading")
-    }, heading), text && /*#__PURE__*/React.createElement("span", {
+    }, /*#__PURE__*/React.createElement("h6", {
+      id: titleId,
+      className: "".concat(blockClass, "__title")
+    }, title), text && /*#__PURE__*/React.createElement("span", {
       className: cx(summaryClasses),
       "aria-hidden": summaryHidden
     }, Icon && /*#__PURE__*/React.createElement(Icon, null), /*#__PURE__*/React.createElement("span", {
@@ -214,7 +224,7 @@ export var OptionsTile = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     toggled: enabled,
     labelA: "",
     labelB: "",
-    "aria-labelledby": headingId,
+    "aria-labelledby": titleId,
     onToggle: onToggle,
     size: "sm",
     disabled: isLocked
@@ -261,16 +271,6 @@ OptionsTile.propTypes = {
    */
   enabled: PropTypes.bool,
 
-  /**
-   * Provide the heading for this OptionsTile.
-   */
-  heading: PropTypes.string.isRequired,
-
-  /**
-   * Optionally provide an id which should be used for the heading.
-   */
-  headingId: PropTypes.string,
-
   /**
    * Whether the OptionsTile is in invalid validation state.
    */
@@ -312,6 +312,16 @@ OptionsTile.propTypes = {
    */
   summary: PropTypes.string,
 
+  /**
+   * Provide the title for this OptionsTile.
+   */
+  title: PropTypes.string.isRequired,
+
+  /**
+   * Optionally provide an id which should be used for the title.
+   */
+  titleId: PropTypes.string,
+
   /**
    * Whether the OptionsTile is in warning validation state.
    */

package/es/components/OptionsTile/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2021, 2021
+ * Copyright IBM Corp. 2021, 2022
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.