@carbon/ibm-products 1.35.1 → 1.36.0

package/lib/components/InlineEditV1/InlineEditV1.js

@@ -0,0 +1,403 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof3 = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.InlineEditV1 = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _carbonComponentsReact = require("carbon-components-react");
+var _iconsReact = require("@carbon/icons-react");
+var _excluded = ["buttonTooltipAlignment", "buttonTooltipPosition", "cancelDescription", "className", "disabled", "editAlwaysVisible", "editDescription", "id", "invalid", "invalidText", "labelText", "light", "onCancel", "onSave", "onChange", "placeholder", "saveDescription", "size", "value"];
+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 || _typeof3(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; }
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--inline-edit");
+var componentName = 'InlineEditV1';
+// 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'];
+console.warn('the v1 version of this component is being deprecated. please switch to the v2 component as soon as possible.');
+
+/**
+ * TODO: A description of the component.
+ */
+var InlineEditV1 = /*#__PURE__*/_react.default.forwardRef(function (_ref, refIn) {
+  var _cx, _refInput$current, _refInput$current$tex, _cx3;
+  var buttonTooltipAlignment = _ref.buttonTooltipAlignment,
+    buttonTooltipPosition = _ref.buttonTooltipPosition,
+    cancelDescription = _ref.cancelDescription,
+    className = _ref.className,
+    disabled = _ref.disabled,
+    editAlwaysVisible = _ref.editAlwaysVisible,
+    editDescription = _ref.editDescription,
+    id = _ref.id,
+    invalid = _ref.invalid,
+    invalidText = _ref.invalidText,
+    labelText = _ref.labelText,
+    _ref$light = _ref.light,
+    light = _ref$light === void 0 ? defaults.light : _ref$light,
+    onCancel = _ref.onCancel,
+    onSave = _ref.onSave,
+    onChange = _ref.onChange,
+    placeholder = _ref.placeholder,
+    saveDescription = _ref.saveDescription,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? defaults.size : _ref$size,
+    value = _ref.value,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var refInput = (0, _react.useRef)({
+    textContent: value
+  });
+  var localRef = (0, _react.useRef)(null);
+  var ref = refIn || localRef;
+  var _useState = (0, _react.useState)(false),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    editing = _useState2[0],
+    setEditing = _useState2[1];
+  var _useState3 = (0, _react.useState)(value),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    internalValue = _useState4[0],
+    setInternalValue = _useState4[1];
+  var showValidation = invalid; // || warn;
+  var validationText = invalidText; // || warnText;
+  var validationIcon = showValidation ? /*#__PURE__*/_react.default.createElement(_iconsReact.WarningFilled16, null) : null;
+
+  // sanitize the tooltip values
+  var alignIsObject = (0, _typeof2.default)(buttonTooltipAlignment) === 'object';
+  var directionIsObject = (0, _typeof2.default)(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) {
+      // move scroll to start
+      refInput.current.scrollLeft = 0;
+    }
+    setEditing(!disabled && value);
+  };
+  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
+      if (rightOfInput || leftOfInput) {
+        doSetEditing(true);
+        setTimeout(function () {
+          refInput.current.focus();
+          // select all the content
+          document.getSelection().selectAllChildren(refInput.current);
+          if (rightOfInput) {
+            document.getSelection().collapseToEnd();
+            refInput.current.scrollLeft = 9999; // never going to get there but ensures at end.
+          } else {
+            document.getSelection().collapseToStart();
+            refInput.current.scrollLeft = 0; // scroll to start
+          }
+        }, 0);
+      }
+    }
+  };
+  var handleFocus = function handleFocus(ev) {
+    ev.preventDefault();
+    if (!editing && ev.target.classList.contains("".concat(blockClass, "__input"))) {
+      doSetEditing(true);
+    }
+  };
+  var handleSave = function handleSave() {
+    doSetEditing(false);
+    document.getSelection().removeAllRanges();
+    if (onSave) {
+      onSave(refInput.current.textContent);
+    }
+  };
+  var handleInput = function handleInput() {
+    setInternalValue(refInput.current.textContent);
+    if (onChange) {
+      onChange(refInput.current.textContent);
+    }
+  };
+
+  // pasting into contentEditable not supported by userEvent
+  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
+    var sanitizedText = text.replaceAll(/\n/g, '') // remove carriage returns
+    .replaceAll(/\t/g, '  '); // replace tab with two spaces
+
+    if (document.queryCommandSupported('insertText')) {
+      document.execCommand('insertText', false, sanitizedText);
+    } else {
+      // Insert text at the current position of caret
+      var range = document.getSelection().getRangeAt(0);
+      range.deleteContents();
+      var textNode = document.createTextNode(sanitizedText);
+      range.insertNode(textNode);
+      // move selection end of textNode
+      range.selectNodeContents(textNode);
+      range.collapse(false);
+
+      // remove existing range
+      var selection = document.getSelection();
+      selection.removeAllRanges();
+
+      // set the new range
+      selection.addRange(range);
+    }
+  };
+  var handleCancel = function handleCancel() {
+    refInput.current.textContent = value;
+    handleInput(value);
+    doSetEditing(false);
+    document.getSelection().removeAllRanges();
+    if (onCancel) {
+      onCancel(value);
+    }
+  };
+  var handleBlur = function handleBlur(ev) {
+    if (!ref.current.contains(ev.relatedTarget)) {
+      handleSave();
+    }
+  };
+  var handleKeyDown = function handleKeyDown(ev) {
+    switch (ev.key) {
+      case 'Enter':
+        ev.preventDefault();
+        refInput.current.blur(); // will cause save
+        break;
+      case 'Escape':
+        handleCancel();
+        break;
+    }
+  };
+
+  /*
+    The HTML is structured as follows:
+   <container>
+    <!-- margin left of input to match Carbon -->
+    <content-editable>
+    <-- margin right of input space for after-input-elements -->
+    <after-input-elements>
+  </container>
+    NOTE:
+   - An input is not used as this would not permit a heading tag e.g. <h2>.
+   - Some padding is added to the left 16px standard for a Carbon text input
+   - The after-input-elements are position absolute with a margin to on the input to reserve space. Using inline-flex
+   - does not measure space properly for the input otherwise.
+   - The content editable is not expected to change size when buttons are added, to ensure the text does not move space
+    is reserved up front for buttons and invalid icon. Mostly this is only noticed if the width of the component is not 100%.
+    which can be shown by setting inlineEditFullWidth to false in storybook.
+    In making content-editable behave like an input of type text we have to account for.
+   - Enforcing a single line
+   - Pasting of non-text e.g. html or text with carriage returns
+   - The padding and border not hiding typed in text.
+   - Placing the cursor at the start or end depending on area clicked (before for left-padding)
+  */
+
+  var toolbarAnimation = true;
+  return (
+    /*#__PURE__*/
+    // eslint-disable-next-line
+    _react.default.createElement("div", {
+      className: (0, _classnames.default)(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 = {}, (0, _defineProperty2.default)(_cx, "".concat(blockClass, "--disabled"), disabled), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "--editing"), editing), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "--invalid"), invalid), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "--light"), light), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "--overflows"), refInput.current && refInput.current.scrollWidth > refInput.current.offsetWidth), _cx)),
+      onClick: handleEdit // disabled eslint for click handler
+      ,
+      onBlur: handleBlur,
+      ref: ref
+    }, /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, (0, _devtools.getDevtoolsProps)(componentName), {
+      id: id,
+      size: size,
+      className: (0, _classnames.default)("".concat(blockClass, "__input"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__input--empty"), ((_refInput$current = refInput.current) === null || _refInput$current === void 0 ? void 0 : (_refInput$current$tex = _refInput$current.textContent) === null || _refInput$current$tex === void 0 ? void 0 : _refInput$current$tex.length) === 0)),
+      contentEditable: true,
+      "aria-label": labelText,
+      role: "textbox",
+      tabIndex: disabled ? -1 : 0,
+      onFocus: handleFocus,
+      onInput: handleInput,
+      onKeyDown: handleKeyDown,
+      onPaste: handlePaste,
+      suppressContentEditableWarning: true,
+      ref: refInput,
+      "data-placeholder": placeholder
+    }), value), /*#__PURE__*/_react.default.createElement("div", {
+      className: (0, _classnames.default)("".concat(blockClass, "__after-input-elements"))
+      // tabindex -1 fixes blur target test when clicking on after-input-elements background
+      ,
+      tabIndex: "-1"
+    }, /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__ellipsis"),
+      "aria-hidden": !editing
+    }, "\u2026"), /*#__PURE__*/_react.default.createElement("div", {
+      className: (0, _classnames.default)("".concat(blockClass, "__toolbar"), (_cx3 = {}, (0, _defineProperty2.default)(_cx3, "".concat(blockClass, "__toolbar--animation"), toolbarAnimation), (0, _defineProperty2.default)(_cx3, "".concat(blockClass, "__toolbar--saveable"), refInput.current && value !== internalValue), _cx3))
+    }, showValidation && /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__validation-icon")
+    }, validationIcon), editing ? /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, (0, _extends2.default)({
+      className: "".concat(blockClass, "__cancel"),
+      kind: "ghost",
+      hasIconOnly: true,
+      iconDescription: cancelDescription,
+      onClick: handleCancel,
+      renderIcon: _iconsReact.Close16
+    }, tipPositions.cancel)), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, (0, _extends2.default)({
+      className: "".concat(blockClass, "__save"),
+      kind: "ghost",
+      hasIconOnly: true,
+      iconDescription: saveDescription,
+      onClick: handleSave,
+      renderIcon: _iconsReact.Checkmark16,
+      disabled: value === internalValue
+    }, tipPositions.save))) : /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, (0, _extends2.default)({
+      className: (0, _classnames.default)("".concat(blockClass, "__edit"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__edit--always-visible"), editAlwaysVisible)),
+      kind: "ghost",
+      hasIconOnly: true,
+      iconDescription: editDescription,
+      onClick: handleEdit,
+      renderIcon: disabled ? _iconsReact.EditOff16 : _iconsReact.Edit16,
+      disabled: disabled,
+      tabIndex: -1
+    }, tipPositions.edit)))), /*#__PURE__*/_react.default.createElement("div", {
+      className: (0, _classnames.default)("".concat(blockClass, "__disabled-cover"))
+    }), showValidation && validationText && validationText.length > 0 && /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__validation-text ").concat(_settings.carbon.prefix, "--form-requirement")
+    }, validationText))
+  );
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.InlineEditV1 = InlineEditV1;
+exports.InlineEditV1 = InlineEditV1 = _settings.pkg.checkComponentEnabled(InlineEditV1, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+InlineEditV1.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+InlineEditV1.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.default.oneOfType([_propTypes.default.oneOf(['start', 'center', 'end']), _propTypes.default.shape({
+    cancel: _propTypes.default.oneOf(['start', 'center', 'end']),
+    edit: _propTypes.default.oneOf(['start', 'center', 'end']),
+    save: _propTypes.default.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.default.oneOfType([_propTypes.default.oneOf(['top', 'right', 'bottom', 'left']), _propTypes.default.shape({
+    cancel: _propTypes.default.oneOf(['top', 'right', 'bottom', 'left']),
+    edit: _propTypes.default.oneOf(['top', 'right', 'bottom', 'left']),
+    save: _propTypes.default.oneOf(['top', 'right', 'bottom', 'left'])
+  })]),
+  /**
+   * label for cancel button
+   */
+  cancelDescription: _propTypes.default.string.isRequired,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+  /**
+   * disable edit
+   */
+  disabled: _propTypes.default.bool,
+  /**
+   * By default the edit icon is shown on hover only.
+   */
+  editAlwaysVisible: _propTypes.default.bool,
+  /**
+   * Label for the edit button
+   */
+  editDescription: _propTypes.default.string.isRequired,
+  /**
+   * ID for inline edit
+   */
+  id: _propTypes.default.string,
+  /**
+   * set invalid state for input
+   */
+  invalid: _propTypes.default.bool,
+  /**
+   * text shown when invalid is true
+   */
+  invalidText: _propTypes.default.string,
+  /**
+   * label for text input
+   */
+  labelText: _propTypes.default.string,
+  /**
+   * change background to light version (mimic React TextInput)
+   */
+  light: _propTypes.default.bool,
+  /**
+   * method called on cancel event
+   */
+  onCancel: _propTypes.default.func,
+  /**
+   * method called on input event (it's a React thing onChange behaves like on input).
+   *
+   * NOTE: caller to handle invalid states and associated text
+   */
+  onChange: _propTypes.default.func,
+  /**
+   * method called on change event
+   *
+   * NOTE: caller to handle invalid states and associated text
+   */
+  onSave: _propTypes.default.func,
+  /**
+   * placeholder for text input
+   */
+  placeholder: _propTypes.default.string,
+  /**
+   * label for save button
+   */
+  saveDescription: _propTypes.default.string.isRequired,
+  /**
+   * vertical size of control
+   */
+  size: _propTypes.default.oneOf(['sm', 'md', 'lg']),
+  /**
+   * initial/unedited value
+   */
+  value: _propTypes.default.string
+};

package/lib/components/InlineEditV1/index.js

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

package/lib/components/InlineEditV2/InlineEditV2.js

@@ -17,22 +17,21 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 var _iconsReact = require("@carbon/icons-react");
 var _settings = require("../../settings");
 var _devtools = require("../../global/js/utils/devtools");
-var _excluded = ["cancelLabel", "editLabel", "invalid", "invalidLabel", "onCancel", "onChange", "onSave", "readOnly", "readOnlyLabel", "saveLabel", "value"];
+var _excluded = ["cancelLabel", "editLabel", "id", "invalid", "invalidLabel", "labelText", "onCancel", "onChange", "onSave", "saveLabel", "value"];
 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; }
 var componentName = 'InlineEditV2';
 var blockClass = "".concat(_settings.pkg.prefix, "--inline-edit-v2");
 var InlineEditV2 = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
-  var _cx;
   var cancelLabel = _ref.cancelLabel,
     editLabel = _ref.editLabel,
+    id = _ref.id,
     invalid = _ref.invalid,
     invalidLabel = _ref.invalidLabel,
+    labelText = _ref.labelText,
     onCancel = _ref.onCancel,
     onChange = _ref.onChange,
     onSave = _ref.onSave,
-    readOnly = _ref.readOnly,
-    readOnlyLabel = _ref.readOnlyLabel,
     saveLabel = _ref.saveLabel,
     value = _ref.value,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
@@ -69,9 +68,10 @@ var InlineEditV2 = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     onChange(target.value);
   };
   var onFocusHandler = function onFocusHandler(e) {
-    if (readOnly) {
-      return;
-    }
+    // if (readOnly) {
+    //   return;
+    // }
+
     if (!isTargetingChild(e)) {
       inputRef.current.focus();
       setFocused(true);
@@ -89,7 +89,8 @@ var InlineEditV2 = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     onCancel(initialValue);
   };
   var onBlurHandler = function onBlurHandler(e) {
-    if (readOnly || escaping.current) {
+    // if (readOnly || escaping.current) {
+    if (escaping.current) {
       return;
     }
     if (!isTargetingChild(e)) {
@@ -128,16 +129,21 @@ var InlineEditV2 = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
   return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
     ref: ref
   }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement("div", {
-    className: (0, _classnames.default)(blockClass, (_cx = {}, (0, _defineProperty2.default)(_cx, "".concat(blockClass, "-focused"), focused), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "-readonly"), readOnly), _cx)),
+    className: (0, _classnames.default)(blockClass, (0, _defineProperty2.default)({}, "".concat(blockClass, "-focused"), focused)),
     onFocus: onFocusHandler,
     onBlur: onBlurHandler
-  }, /*#__PURE__*/_react.default.createElement("input", {
+  }, /*#__PURE__*/_react.default.createElement("label", {
+    className: "".concat(blockClass, "__text-input-label"),
+    htmlFor: id
+  }, labelText), /*#__PURE__*/_react.default.createElement("input", {
+    id: id,
     className: (0, _classnames.default)("".concat(blockClass, "__text-input"), "".concat(_settings.carbon.prefix, "--text-input"), "".concat(_settings.carbon.prefix, "--text-input--sm")),
     type: "text",
     value: value,
     onChange: onChangeHandler,
-    ref: inputRef,
-    readOnly: readOnly,
+    ref: inputRef
+    // readOnly={readOnly}
+    ,
     onKeyDown: onKeyHandler
   }), focused ? /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, invalid && /*#__PURE__*/_react.default.createElement(_iconsReact.WarningFilled16, {
     className: "".concat(blockClass, "__warning-icon")
@@ -164,10 +170,14 @@ var InlineEditV2 = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     disabled: !canSave
   })) : /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
     className: "".concat(blockClass, "__btn ").concat(blockClass, "__btn-edit"),
-    hasIconOnly: true,
-    renderIcon: readOnly ? _iconsReact.EditOff24 : _iconsReact.Edit24,
-    size: "sm",
-    iconDescription: readOnly ? readOnlyLabel : editLabel,
+    hasIconOnly: true
+    // renderIcon={readOnly ? EditOff24 : Edit24}
+    ,
+    renderIcon: _iconsReact.Edit24,
+    size: "sm"
+    // iconDescription={readOnly ? readOnlyLabel : editLabel}
+    ,
+    iconDescription: editLabel,
     onClick: onFocusHandler,
     kind: "ghost",
     tabIndex: 0,
@@ -188,6 +198,10 @@ InlineEditV2.propTypes = {
    * label for edit button
    */
   editLabel: _propTypes.default.string.isRequired,
+  /**
+   * Specify a custom id for the input
+   */
+  id: _propTypes.default.string.isRequired,
   /**
    * determines if the input is invalid
    */
@@ -196,6 +210,10 @@ InlineEditV2.propTypes = {
    * text that is displayed if the input is invalid
    */
   invalidLabel: _propTypes.default.string,
+  /**
+   * Provide the text that will be read by a screen reader when visiting this control
+   */
+  labelText: _propTypes.default.string.isRequired,
   /**
    * handler that is called when the cancel button is pressed or when the user removes focus from the input and there is no new value
    */
@@ -211,11 +229,11 @@ InlineEditV2.propTypes = {
   /**
    * determines if the input is in readOnly mode
    */
-  readOnly: _propTypes.default.bool,
+  // readOnly: PropTypes.bool,
   /**
    * label for the edit button that displays when in read only mode
    */
-  readOnlyLabel: _propTypes.default.string,
+  // readOnlyLabel: PropTypes.string,
   /**
    * label for save button
    */
@@ -227,6 +245,6 @@ InlineEditV2.propTypes = {
 };
 InlineEditV2.defaultProps = {
   invalid: false,
-  invalidLabel: '',
-  readOnly: false
+  invalidLabel: ''
+  // readOnly: false,
 };

package/lib/components/OptionsTile/OptionsTile.js

@@ -16,10 +16,11 @@ var _classnames = _interopRequireDefault(require("classnames"));
 var _devtools = require("../../global/js/utils/devtools");
 var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
 var _settings = require("../../settings");
+var _hooks = require("../../global/js/hooks");
 var _carbonComponentsReact = require("carbon-components-react");
 var _iconsReact = require("@carbon/icons-react");
 var carbonMotion = _interopRequireWildcard(require("@carbon/motion"));
-var _excluded = ["children", "className", "enabled", "invalid", "invalidText", "locked", "lockedText", "onToggle", "open", "size", "summary", "title", "titleId", "warn", "warnText"];
+var _excluded = ["children", "className", "enabled", "invalid", "invalidText", "locked", "lockedText", "onChange", "onToggle", "open", "size", "summary", "title", "titleId", "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); }
 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; }
 // The block part of our conventional BEM class names (blockClass__E--M).
@@ -30,6 +31,7 @@ var componentName = 'OptionsTile';
 
 // Default values for props
 var defaults = {
+  onChange: function onChange() {},
   size: 'xl'
 };
 
@@ -44,6 +46,8 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     invalidText = _ref.invalidText,
     locked = _ref.locked,
     lockedText = _ref.lockedText,
+    _ref$onChange = _ref.onChange,
+    _onChange = _ref$onChange === void 0 ? defaults.onChange : _ref$onChange,
     onToggle = _ref.onToggle,
     open = _ref.open,
     _ref$size = _ref.size,
@@ -56,16 +60,22 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
   var _useState = (0, _react.useState)(open),
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-    isOpen = _useState2[0],
-    setIsOpen = _useState2[1];
-  var _useState3 = (0, _react.useState)(open),
+    prevIsOpen = _useState2[0],
+    setPrevIsOpen = _useState2[1];
+  var _useState3 = (0, _react.useState)(false),
     _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
-    prevIsOpen = _useState4[0],
-    setPrevIsOpen = _useState4[1];
-  var _useState5 = (0, _react.useState)(false),
-    _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
-    closing = _useState6[0],
-    setClosing = _useState6[1];
+    closing = _useState4[0],
+    setClosing = _useState4[1];
+  var _useControllableState = (0, _hooks.useControllableState)({
+      value: open,
+      defaultValue: open || null,
+      onChange: function onChange(value) {
+        return _onChange(value);
+      }
+    }),
+    _useControllableState2 = (0, _slicedToArray2.default)(_useControllableState, 2),
+    isOpen = _useControllableState2[0],
+    setIsOpen = _useControllableState2[1];
   var detailsRef = (0, _react.useRef)(null);
   var contentRef = (0, _react.useRef)(null);
   var id = (0, _uuidv.default)();
@@ -270,6 +280,11 @@ OptionsTile.propTypes = {
    * Provide a text explaining why the OptionsTile is in locked state.
    */
   lockedText: _propTypes.default.string,
+  /**
+   * Provide a function which will be called each time the user
+   * toggles the open state of the OptionsTile.
+   */
+  onChange: _propTypes.default.func,
   /**
    * Provide a function which will be called each time the user
    * interacts with the toggle.

package/lib/components/index.js

@@ -472,11 +472,11 @@ var _UserProfileImage = require("./UserProfileImage");
 var _WebTerminal = require("./WebTerminal");
 var _EditSidePanel = require("./EditSidePanel");
 var _OptionsTile = require("./OptionsTile");
-var _InlineEdit = require("./InlineEdit");
 var _DataSpreadsheet = require("./DataSpreadsheet");
 var _Datagrid = require("./Datagrid");
 var _EditTearsheet = require("./EditTearsheet");
 var _EditTearsheetNarrow = require("./EditTearsheetNarrow");
 var _EditFullPage = require("./EditFullPage");
 var _EditUpdateCards = require("./EditUpdateCards");
+var _InlineEdit = require("./InlineEdit");
 var _InlineEditV = require("./InlineEditV2");

package/lib/global/js/hooks/index.js

@@ -15,6 +15,12 @@ Object.defineProperty(exports, "useClickOutside", {
     return _useClickOutside.useClickOutside;
   }
 });
+Object.defineProperty(exports, "useControllableState", {
+  enumerable: true,
+  get: function get() {
+    return _useControllableState.useControllableState;
+  }
+});
 Object.defineProperty(exports, "useCreateComponentFocus", {
   enumerable: true,
   get: function get() {
@@ -78,4 +84,5 @@ var _useCreateComponentStepChange = require("./useCreateComponentStepChange");
 var _usePreviousValue = require("./usePreviousValue");
 var _useResetCreateComponent = require("./useResetCreateComponent");
 var _useRetrieveStepData = require("./useRetrieveStepData");
-var _useValidCreateStepCount = require("./useValidCreateStepCount");
+var _useValidCreateStepCount = require("./useValidCreateStepCount");
+var _useControllableState = require("./useControllableState");