carbon-react 95.1.3 → 97.0.0

package/lib/components/multi-action-button/multi-action-button.component.js

@@ -212,8 +212,8 @@ const MultiActionButton = ({
 
 MultiActionButton.propTypes = { ...marginPropTypes,
 
-  /** Button type: "primary" | "secondary". */
-  buttonType: _propTypes.default.oneOf(["primary", "secondary"]),
+  /** Button type: "primary" | "secondary" | "tertiary" */
+  buttonType: _propTypes.default.oneOf(["primary", "secondary", "tertiary"]),
 
   /** The additional button to display. */
   children: _propTypes.default.node.isRequired,

package/lib/components/multi-action-button/multi-action-button.config.js

@@ -8,5 +8,5 @@ const MULTI_ACTION_BUTTON_ALIGNMENTS = ["left", "right"];
 exports.MULTI_ACTION_BUTTON_ALIGNMENTS = MULTI_ACTION_BUTTON_ALIGNMENTS;
 const MULTI_ACTION_BUTTON_SIZES = ["small", "medium", "large"];
 exports.MULTI_ACTION_BUTTON_SIZES = MULTI_ACTION_BUTTON_SIZES;
-const MULTI_ACTION_BUTTON_THEMES = ["primary", "secondary"];
+const MULTI_ACTION_BUTTON_THEMES = ["primary", "secondary", "tertiary"];
 exports.MULTI_ACTION_BUTTON_THEMES = MULTI_ACTION_BUTTON_THEMES;

package/lib/components/multi-action-button/multi-action-button.d.ts

@@ -1,5 +1,8 @@
 import SplitButton from "../split-button";
 
-declare class MultiActionButton extends SplitButton {}
+declare class MultiActionButton extends SplitButton {
+  /** Button type: "primary" | "secondary" | "tertiary" */
+  buttonType?: "primary" | "secondary" | "tertiary";
+}
 
 export default MultiActionButton;

package/lib/components/pod/pod.d.ts

@@ -48,6 +48,8 @@ export interface PodProps {
   height?: string | number;
 }
 
-declare class Pod extends React.Component<PodProps> {}
+declare function Pod(
+  props: PodProps & React.RefAttributes<HTMLElement>
+): JSX.Element;
 
 export default Pod;

package/lib/components/show-edit-pod/show-edit-pod-test.stories.js

@@ -0,0 +1,165 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Default = exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _addonActions = require("@storybook/addon-actions");
+
+var _showEditPod = _interopRequireDefault(require("./show-edit-pod.component"));
+
+var _content = _interopRequireDefault(require("../content"));
+
+var _specialCharacters = _interopRequireDefault(require("../../../.storybook/utils/argTypes/specialCharacters"));
+
+var _textbox = _interopRequireDefault(require("../textbox"));
+
+var _fieldset = _interopRequireDefault(require("../fieldset"));
+
+var _showEditPod2 = require("./show-edit-pod.config");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
+
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+var _default = {
+  component: _showEditPod.default,
+  title: "ShowEditPod/Test",
+  parameters: {
+    info: {
+      disable: true
+    },
+    chromatic: {
+      disable: true
+    }
+  },
+  argTypes: {
+    buttonAlign: {
+      options: _showEditPod2.SHOW_EDIT_POD_ALIGNMENTS,
+      control: {
+        type: "select"
+      }
+    },
+    variant: {
+      options: _showEditPod2.SHOW_EDIT_POD_THEMES,
+      control: {
+        type: "select"
+      }
+    },
+    cancelTextSpecialCharacters: _specialCharacters.default,
+    deleteTextSpecialCharacters: _specialCharacters.default,
+    saveTextSpecialCharacters: _specialCharacters.default,
+    titleSpecialCharacters: _specialCharacters.default
+  },
+  args: {
+    border: false,
+    buttonAlign: "right",
+    cancel: true,
+    cancelText: "Cancel",
+    cancelTextSpecialCharacters: undefined,
+    deleteText: "Delete",
+    deleteTextSpecialCharacters: undefined,
+    saveText: "Save",
+    saveTextSpecialCharacters: undefined,
+    saving: false,
+    title: "Person",
+    titleSpecialCharacters: undefined,
+    transitionName: "carbon-show-edit-pod__transition",
+    variant: "transparent"
+  }
+};
+exports.default = _default;
+
+const ShowEditPodStory = ({
+  cancelTextSpecialCharacters,
+  cancelText,
+  deleteTextSpecialCharacters,
+  deleteText,
+  saveTextSpecialCharacters,
+  saveText,
+  titleSpecialCharacters,
+  title,
+  ...args
+}) => {
+  const [isEditing, setIsEditing] = (0, _react.useState)(false);
+  const [state, setState] = (0, _react.useState)({
+    edit_first_name: "Alan",
+    edit_second_name: "Smith",
+    edit_telephone: "000 000 0000"
+  });
+  const fieldProps = [{
+    key: "edit_first_name",
+    label: "First Name"
+  }, {
+    key: "edit_second_name",
+    label: "Second Name"
+  }, {
+    key: "edit_telephone",
+    label: "Telephone"
+  }];
+
+  const onEdit = () => {
+    setIsEditing(true);
+    (0, _addonActions.action)("edit")();
+  };
+
+  const onCancel = () => {
+    setIsEditing(false);
+    (0, _addonActions.action)("cancel")();
+  };
+
+  const onDelete = () => {
+    setIsEditing(false);
+    (0, _addonActions.action)("delete")();
+  };
+
+  const onSave = () => {
+    setIsEditing(false);
+    (0, _addonActions.action)("onSave")();
+  };
+
+  const setField = fieldName => e => {
+    setState({ ...state,
+      [fieldName]: e.target.value
+    });
+  };
+
+  return /*#__PURE__*/_react.default.createElement(_showEditPod.default, _extends({}, args, {
+    editing: isEditing,
+    onDelete: onDelete,
+    onCancel: onCancel,
+    onEdit: onEdit,
+    editFields: /*#__PURE__*/_react.default.createElement(_fieldset.default, null, fieldProps.map(({
+      key,
+      label
+    }) => /*#__PURE__*/_react.default.createElement(_textbox.default, {
+      label: label,
+      key: key,
+      onChange: setField(key),
+      value: state[key],
+      labelInline: true,
+      labelAlign: "right"
+    }))),
+    onSave: onSave,
+    cancelText: cancelTextSpecialCharacters || cancelText,
+    deleteText: deleteTextSpecialCharacters || deleteText,
+    saveText: saveTextSpecialCharacters || saveText,
+    title: titleSpecialCharacters || title
+  }), fieldProps.map(({
+    key,
+    label
+  }) => /*#__PURE__*/_react.default.createElement(_content.default, {
+    key: key,
+    title: label
+  }, state[key])));
+};
+
+const Default = ShowEditPodStory.bind({});
+exports.Default = Default;

package/lib/components/show-edit-pod/show-edit-pod.component.js

@@ -5,20 +5,16 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.BaseShowEditPod = exports.default = void 0;
 
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
-var _reactDom = _interopRequireDefault(require("react-dom"));
-
 var _reactTransitionGroup = require("react-transition-group");
 
 var _propTypes2 = _interopRequireDefault(require("@styled-system/prop-types"));
 
 var _utils = require("../../style/utils");
 
-var _pod = _interopRequireDefault(require("../pod"));
-
 var _form = _interopRequireDefault(require("../form"));
 
 var _button = _interopRequireDefault(require("../button"));
@@ -27,8 +23,6 @@ var _deleteButton = _interopRequireDefault(require("./delete-button.style"));
 
 var _events = _interopRequireDefault(require("../../__internal__/utils/helpers/events"));
 
-var _ether = require("../../__internal__/utils/ether");
-
 var _tags = _interopRequireDefault(require("../../__internal__/utils/helpers/tags/tags"));
 
 var _i18nContext = _interopRequireDefault(require("../../__internal__/i18n-context"));
@@ -37,230 +31,173 @@ var _showEditPod = _interopRequireDefault(require("./show-edit-pod.style"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
-
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
-
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
 
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
-
-function _possibleConstructorReturn(self, call) { if (call && (typeof call === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
-
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
-
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
-
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
-
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
 
 const marginPropTypes = (0, _utils.filterStyledSystemMarginProps)(_propTypes2.default.space);
 
-let ShowEditPod = /*#__PURE__*/function (_React$Component) {
-  _inherits(ShowEditPod, _React$Component);
-
-  var _super = _createSuper(ShowEditPod);
-
-  function ShowEditPod(...args) {
-    var _this;
-
-    _classCallCheck(this, ShowEditPod);
-
-    _this = _super.call(this, ...args);
-
-    _defineProperty(_assertThisInitialized(_this), "state", {
-      editing: false
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "isControlled", _this.props.editing !== undefined);
-
-    _defineProperty(_assertThisInitialized(_this), "onEdit", ev => {
-      _this.props.onEdit(ev);
-
-      _this.toggleEditingState(true);
-
-      _this.__focusOnPod();
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "onSaveEditForm", ev => {
-      ev.preventDefault();
-
-      _this.props.onSave(ev);
-
-      _this.toggleEditingState(false);
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "onCancelEditForm", ev => {
-      if (_this.props.onCancel) {
-        _this.props.onCancel(ev);
-      }
-
-      _this.toggleEditingState(false);
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "toggleEditingState", newState => {
-      if (!_this.isControlled) {
-        _this.setState({
-          editing: newState
-        });
-      }
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "onKeyDown", ev => {
-      if (_events.default.isEscKey(ev)) {
-        _this.onCancelEditForm(ev);
-      }
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "__focusOnPod", () => {
-      _reactDom.default.findDOMNode(_this.pod).focus(); // eslint-disable-line react/no-find-dom-node
-
-    });
-
-    return _this;
-  }
-
-  _createClass(ShowEditPod, [{
-    key: "componentDidMount",
-    value: function componentDidMount() {
-      if (this.props.editing) {
-        this.__focusOnPod();
-      }
+const ShowEditPod = ({
+  border = false,
+  className,
+  children,
+  saving = false,
+  editFields,
+  editing,
+  onEdit,
+  onSave,
+  onCancel,
+  onUndo,
+  cancel = true,
+  cancelText,
+  saveText,
+  onDelete,
+  deleteText,
+  softDelete,
+  buttonAlign = "right",
+  transitionName = "carbon-show-edit-pod__transition",
+  title,
+  hideDeleteButtonInViewMode = false,
+  variant = "transparent",
+  ...rest
+}) => {
+  const locale = (0, _react.useContext)(_i18nContext.default);
+  const ref = (0, _react.useRef)();
+  const [isEditing, setIsEditingState] = (0, _react.useState)(false);
+  const isControlled = editing !== undefined;
+
+  const focusPod = () => {
+    ref.current.focus();
+  };
+
+  (0, _react.useEffect)(() => {
+    if (editing) {
+      focusPod();
     }
-  }, {
-    key: "isEditing",
-    value: function isEditing() {
-      return this.isControlled ? this.props.editing : this.state.editing;
-    }
-  }, {
-    key: "deleteButton",
-    value: function deleteButton() {
-      const label = this.props.deleteText || this.context.actions.delete();
-      return /*#__PURE__*/_react.default.createElement(_deleteButton.default, {
-        buttonType: "tertiary",
-        "data-element": "delete-button",
-        size: "small",
-        onClick: this.props.onDelete
-      }, label);
+  }, [editing]);
+  const isInEditMode = isControlled ? editing : isEditing;
+
+  const toggleEditingState = newState => {
+    if (!isControlled) {
+      setIsEditingState(newState);
     }
-  }, {
-    key: "editContent",
-    value: function editContent() {
-      return /*#__PURE__*/_react.default.createElement(_form.default, {
-        onSubmit: this.onSaveEditForm,
-        buttonAlignment: this.props.buttonAlign,
-        "data-element": "edit-form",
-        leftSideButtons: this.props.cancel && /*#__PURE__*/_react.default.createElement(_button.default, {
-          "data-element": "cancel-button",
-          onClick: this.onCancelEditForm,
-          size: "small"
-        }, this.props.cancelText),
-        saveButton: /*#__PURE__*/_react.default.createElement(_button.default, {
-          disabled: this.props.saving,
-          "data-element": "submit-button",
-          buttonType: "primary",
-          type: "submit",
-          size: "small"
-        }, this.props.saveText),
-        rightSideButtons: this.props.onDelete ? this.deleteButton() : null,
-        saving: this.props.saving
-      }, this.props.editFields);
+  };
+
+  const handleEdit = ev => {
+    onEdit(ev);
+    toggleEditingState(true);
+    focusPod();
+  };
+
+  const onSaveEditForm = ev => {
+    ev.preventDefault();
+    onSave(ev);
+    toggleEditingState(false);
+  };
+
+  const onCancelEditForm = ev => {
+    if (onCancel) {
+      onCancel(ev);
     }
-  }, {
-    key: "content",
-    value: function content() {
-      if (this.isEditing()) {
-        return /*#__PURE__*/_react.default.createElement(_reactTransitionGroup.CSSTransition, {
-          key: "1",
-          classNames: this.props.transitionName,
-          timeout: {
-            enter: 300,
-            exit: 50
-          }
-        }, /*#__PURE__*/_react.default.createElement("div", {
-          key: "edit"
-        }, this.editContent()));
-      }
 
+    toggleEditingState(false);
+  };
+
+  const onKeyDown = ev => {
+    if (_events.default.isEscKey(ev)) {
+      onCancelEditForm(ev);
+    }
+  };
+
+  const deleteButton = () => {
+    const label = deleteText || locale.actions.delete();
+    return /*#__PURE__*/_react.default.createElement(_deleteButton.default, {
+      buttonType: "tertiary",
+      "data-element": "delete-button",
+      size: "small",
+      onClick: onDelete
+    }, label);
+  };
+
+  const editContent = () => /*#__PURE__*/_react.default.createElement(_form.default, {
+    onSubmit: onSaveEditForm,
+    buttonAlignment: buttonAlign,
+    "data-element": "edit-form",
+    leftSideButtons: cancel && /*#__PURE__*/_react.default.createElement(_button.default, {
+      "data-element": "cancel-button",
+      onClick: onCancelEditForm,
+      size: "small"
+    }, cancelText),
+    saveButton: /*#__PURE__*/_react.default.createElement(_button.default, {
+      disabled: saving,
+      "data-element": "submit-button",
+      buttonType: "primary",
+      type: "submit",
+      size: "small"
+    }, saveText),
+    rightSideButtons: onDelete ? deleteButton() : null,
+    saving: saving
+  }, editFields);
+
+  const content = () => {
+    if (isInEditMode) {
       return /*#__PURE__*/_react.default.createElement(_reactTransitionGroup.CSSTransition, {
-        key: "2",
-        classNames: this.props.transitionName,
+        key: "1",
+        classNames: transitionName,
         timeout: {
           enter: 300,
           exit: 50
         }
       }, /*#__PURE__*/_react.default.createElement("div", {
-        key: "show"
-      }, this.props.children));
+        key: "edit"
+      }, editContent()));
     }
-  }, {
-    key: "universalProps",
-    value: function universalProps() {
-      const {
-        onEdit,
-        onDelete,
-        className,
-        ...props
-      } = (0, _ether.validProps)(this, Object.keys(_pod.default.propTypes));
-      return props;
-    }
-  }, {
-    key: "contentProps",
-    value: function contentProps() {
-      const {
-        onEdit,
-        onDelete,
-        hideDeleteButtonInViewMode
-      } = this.props;
-      const props = this.universalProps();
-
-      if (onEdit) {
-        props.onEdit = this.onEdit;
-      }
 
-      return { ...props,
-        onDelete: !hideDeleteButtonInViewMode && onDelete
-      };
-    }
-  }, {
-    key: "editingProps",
-    value: function editingProps() {
-      const props = this.universalProps();
-      props.onKeyDown = this.onKeyDown;
-      return props;
-    }
-  }, {
-    key: "podProps",
-    value: function podProps() {
-      return this.isEditing() ? this.editingProps() : this.contentProps();
-    }
-  }, {
-    key: "render",
-    value: function render() {
-      return /*#__PURE__*/_react.default.createElement(_showEditPod.default, _extends({
-        className: this.props.className,
-        size: "small"
-      }, this.podProps(), {
-        ref: node => {
-          this.pod = node;
-        },
-        tabIndex: "-1"
-      }, (0, _tags.default)("show-edit-pod", this.props)), /*#__PURE__*/_react.default.createElement(_reactTransitionGroup.TransitionGroup, null, this.content()));
-    }
-  }]);
-
-  return ShowEditPod;
-}(_react.default.Component);
+    return /*#__PURE__*/_react.default.createElement(_reactTransitionGroup.CSSTransition, {
+      key: "2",
+      classNames: transitionName,
+      timeout: {
+        enter: 300,
+        exit: 50
+      }
+    }, /*#__PURE__*/_react.default.createElement("div", {
+      key: "show"
+    }, children));
+  };
+
+  const universalProps = () => ({
+    size: "small",
+    tabIndex: "-1",
+    title,
+    ref,
+    className,
+    border,
+    onUndo,
+    softDelete,
+    variant,
+    ...rest,
+    ...(0, _tags.default)("show-edit-pod", rest)
+  });
+
+  const contentProps = () => ({ ...universalProps(),
+    ...(!hideDeleteButtonInViewMode && {
+      onDelete
+    }),
+    ...(onEdit && {
+      onEdit: handleEdit
+    })
+  });
+
+  const editingProps = () => ({ ...universalProps(),
+    onKeyDown
+  });
+
+  const podProps = () => isInEditMode ? editingProps() : contentProps();
+
+  return /*#__PURE__*/_react.default.createElement(_showEditPod.default, podProps(), /*#__PURE__*/_react.default.createElement(_reactTransitionGroup.TransitionGroup, null, content()));
+};
 
 exports.BaseShowEditPod = ShowEditPod;
-ShowEditPod.contextType = _i18nContext.default;
 ShowEditPod.propTypes = { ...marginPropTypes,
 
   /** Pod theme variant. */
@@ -322,16 +259,10 @@ ShowEditPod.propTypes = { ...marginPropTypes,
   deleteText: _propTypes.default.string,
 
   /** Can inform if the form is in a saving state (disables the save button) */
-  saving: _propTypes.default.bool
-};
-ShowEditPod.defaultProps = {
-  variant: "transparent",
-  border: false,
-  buttonAlign: "right",
-  transitionName: "carbon-show-edit-pod__transition",
-  cancel: true,
-  saving: false,
-  hideDeleteButtonInViewMode: false
+  saving: _propTypes.default.bool,
+
+  /** Title to be displayed */
+  title: _propTypes.default.node
 };
 var _default = ShowEditPod;
 exports.default = _default;

package/lib/components/show-edit-pod/show-edit-pod.d.ts

@@ -48,8 +48,10 @@ export interface ShowEditPodProps {
   saveText?: string;
   /** Can inform if the form is in a saving state (disables the save button) */
   saving?: boolean;
+  /** Title to be displayed */
+  title?: React.ReactNode;
 }
 
-declare class ShowEditPod extends React.Component<ShowEditPodProps> {}
+declare function ShowEditPod(props: ShowEditPodProps): JSX.Element;
 
 export default ShowEditPod;

package/lib/components/textarea/textarea-test.stories.js

@@ -0,0 +1,153 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Default = exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _specialCharacters = _interopRequireWildcard(require("../../../.storybook/utils/argTypes/specialCharacters"));
+
+var _ = _interopRequireDefault(require("."));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
+
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+var _default = {
+  component: _.default,
+  title: "Textarea/Test",
+  parameters: {
+    info: {
+      disable: true
+    },
+    chromatic: {
+      disable: true
+    }
+  },
+  argTypes: {
+    labelAlign: {
+      options: ["left", "right"],
+      control: {
+        type: "select"
+      }
+    },
+    cols: {
+      control: {
+        min: 0,
+        max: 100,
+        step: 1,
+        type: "range"
+      }
+    },
+    rows: {
+      control: {
+        min: 0,
+        max: 100,
+        step: 1,
+        type: "range"
+      }
+    },
+    inputWidth: {
+      control: {
+        min: 0,
+        max: 100,
+        step: 1,
+        type: "range"
+      }
+    },
+    labelWidth: {
+      control: {
+        min: 0,
+        max: 100,
+        step: 1,
+        type: "range"
+      }
+    },
+    adaptiveLabelBreakpoint: {
+      control: {
+        type: "number"
+      }
+    },
+    placeholderSpecialCharacters: _specialCharacters.default,
+    labelSpecialCharacters: _specialCharacters.default,
+    labelHelpSpecialCharacters: _specialCharacters.default,
+    characterLimitSpecialCharacters: {
+      options: [..._specialCharacters.default.options, ..._specialCharacters.number.options],
+      mapping: { ..._specialCharacters.default.mapping,
+        ..._specialCharacters.number.mapping
+      }
+    },
+    fieldHelpSpecialCharacters: _specialCharacters.default
+  },
+  args: {
+    expandable: false,
+    cols: 0,
+    rows: 0,
+    disabled: false,
+    autoFocus: false,
+    readOnly: false,
+    placeholder: "",
+    fieldHelp: "",
+    characterLimit: "",
+    inputWidth: 100,
+    warnOverLimit: false,
+    enforceCharacterLimit: true,
+    label: "",
+    labelHelp: "",
+    labelInline: false,
+    labelWidth: 30,
+    labelAlign: undefined,
+    adaptiveLabelBreakpoint: undefined,
+    required: false,
+    placeholderSpecialCharacters: undefined,
+    labelSpecialCharacters: undefined,
+    labelHelpSpecialCharacters: undefined,
+    characterLimitSpecialCharacters: undefined,
+    fieldHelpSpecialCharacters: undefined
+  }
+};
+exports.default = _default;
+
+const Default = ({
+  placeholder,
+  placeholderSpecialCharacters,
+  label,
+  labelSpecialCharacters,
+  labelHelp,
+  labelHelpSpecialCharacters,
+  characterLimit,
+  characterLimitSpecialCharacters,
+  fieldHelp,
+  fieldHelpSpecialCharacters,
+  ...args
+}) => {
+  const [state, setState] = (0, _react.useState)("");
+
+  const handleChange = ({
+    target: {
+      value
+    }
+  }) => {
+    setState(value);
+  };
+
+  return /*#__PURE__*/_react.default.createElement(_.default, _extends({}, args, {
+    name: "textarea",
+    onChange: handleChange,
+    value: state,
+    placeholder: placeholder || placeholderSpecialCharacters,
+    label: label || labelSpecialCharacters,
+    labelHelp: labelHelp || labelHelpSpecialCharacters,
+    helpAriaLabel: labelHelp || labelHelpSpecialCharacters,
+    characterLimit: characterLimit || characterLimitSpecialCharacters,
+    fieldHelp: fieldHelp || fieldHelpSpecialCharacters
+  }));
+};
+
+exports.Default = Default;

package/lib/components/textarea/textarea.component.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = exports.OriginalTextarea = void 0;
 
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
@@ -35,229 +35,167 @@ var _tooltipProvider = require("../../__internal__/tooltip-provider");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
-
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
-
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
-
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
-
-function _possibleConstructorReturn(self, call) { if (call && (typeof call === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
-
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
 
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
 
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
-
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 
 const getFormatNumber = (value, locale) => new Intl.NumberFormat(locale).format(value);
 
 const marginPropTypes = (0, _utils.filterStyledSystemMarginProps)(_propTypes2.default.space);
 
-let Textarea = /*#__PURE__*/function (_React$Component) {
-  _inherits(Textarea, _React$Component);
-
-  var _super = _createSuper(Textarea);
-
-  function Textarea(...args) {
-    var _this;
-
-    _classCallCheck(this, Textarea);
-
-    _this = _super.call(this, ...args);
-
-    _defineProperty(_assertThisInitialized(_this), "minHeight", 0);
-
-    _defineProperty(_assertThisInitialized(_this), "id", _this.props.id || (0, _guid.default)());
-
-    _defineProperty(_assertThisInitialized(_this), "_input", /*#__PURE__*/_react.default.createRef());
-
-    _defineProperty(_assertThisInitialized(_this), "expandTextarea", () => {
-      const textarea = _this._input.current;
-
-      if (textarea.scrollHeight > _this.minHeight) {
-        // Reset height to zero - IE specific
-        textarea.style.height = "0px"; // Set the height so all content is shown
-
-        textarea.style.height = `${Math.max(textarea.scrollHeight, _this.minHeight)}px`;
-      }
-    });
+const Textarea = ({
+  autoFocus,
+  fieldHelp,
+  label,
+  size,
+  children,
+  characterLimit,
+  enforceCharacterLimit = true,
+  warnOverLimit = false,
+  onChange,
+  disabled = false,
+  labelInline,
+  labelAlign,
+  labelHelp,
+  labelSpacing,
+  inputIcon,
+  id: idProp,
+  error,
+  warning,
+  info,
+  name,
+  readOnly = false,
+  placeholder,
+  expandable = false,
+  rows,
+  cols,
+  validationOnLabel = false,
+  adaptiveLabelBreakpoint,
+  inputWidth,
+  labelWidth = 30,
+  tooltipPosition,
+  value,
+  "data-component": dataComponent,
+  "data-element": dataElement,
+  "data-role": dataRole,
+  helpAriaLabel,
+  ...props
+}) => {
+  const locale = (0, _react.useContext)(_i18nContext.default);
+  const {
+    current: id
+  } = (0, _react.useRef)(idProp || (0, _guid.default)());
+  const inputRef = (0, _react.useRef)();
+  const minHeight = (0, _react.useRef)(0);
+
+  const expandTextarea = () => {
+    const textarea = inputRef.current;
+
+    if (textarea.scrollHeight > minHeight.current) {
+      // Reset height to zero - IE specific
+      textarea.style.height = "0px"; // Set the height so all content is shown
+
+      textarea.style.height = `${Math.max(textarea.scrollHeight, minHeight.current)}px`;
+    }
+  };
 
-    return _this;
-  }
-
-  _createClass(Textarea, [{
-    key: "componentDidMount",
-    value:
-    /**
-     * A lifecycle method that is called after initial render.
-     * Allows access to refs and DOM to set expandable variables
-     */
-    function componentDidMount() {
-      if (this.props.expandable) {
-        window.addEventListener("resize", this.expandTextarea); // Set the min height to the initially rendered height.
-        // Without minHeight expandable textareas will only have
-        // one line when no content is present.
-
-        this.minHeight = this._input.current.clientHeight;
-        this.expandTextarea();
-      }
+  (0, _react.useEffect)(() => {
+    if (expandable) {
+      expandTextarea();
     }
-  }, {
-    key: "componentWillUnmount",
-    value: function componentWillUnmount() {
-      if (this.props.expandable) {
-        window.removeEventListener("resize", this.expandTextarea);
-      }
+  });
+  (0, _react.useEffect)(() => {
+    if (expandable) {
+      window.addEventListener("resize", expandTextarea);
+      minHeight.current = inputRef.current.clientHeight;
     }
-  }, {
-    key: "componentDidUpdate",
-    value: function componentDidUpdate() {
-      const {
-        expandable
-      } = this.props;
 
+    return () => {
       if (expandable) {
-        this.expandTextarea();
-      }
-    }
-  }, {
-    key: "overLimit",
-    get: function () {
-      const value = this.props.value || "";
-      return value.length > parseInt(this.props.characterLimit, 10);
-    }
-  }, {
-    key: "characterCount",
-    get: function () {
-      const value = this.props.value || "";
-      const {
-        characterLimit,
-        warnOverLimit
-      } = this.props;
-
-      if (!characterLimit) {
-        return null;
+        window.removeEventListener("resize", expandTextarea);
       }
+    };
+  }, [expandable]);
 
-      return /*#__PURE__*/_react.default.createElement(_characterCount.default, {
-        isOverLimit: this.overLimit && warnOverLimit,
-        value: getFormatNumber(value.length, this.context.locale()),
-        limit: getFormatNumber(characterLimit, this.context.locale()),
-        "data-element": "character-limit"
-      });
-    }
-  }, {
-    key: "render",
-    value: function render() {
-      const {
-        autoFocus,
-        fieldHelp,
-        label,
-        size,
-        children,
-        characterLimit,
-        enforceCharacterLimit,
-        onChange,
-        disabled,
-        labelInline,
-        labelAlign,
-        labelHelp,
-        labelSpacing,
-        inputIcon,
-        error,
-        warning,
-        info,
-        name,
-        readOnly,
-        placeholder,
-        rows,
-        cols,
-        validationOnLabel,
-        adaptiveLabelBreakpoint,
-        inputWidth,
-        labelWidth,
-        tooltipPosition,
-        "data-component": dataComponent,
-        "data-element": dataElement,
-        "data-role": dataRole,
-        helpAriaLabel,
-        ...props
-      } = this.props;
-      return /*#__PURE__*/_react.default.createElement(_tooltipProvider.TooltipProvider, {
-        helpAriaLabel: helpAriaLabel,
-        tooltipPosition: tooltipPosition
-      }, /*#__PURE__*/_react.default.createElement(_inputBehaviour.InputBehaviour, null, /*#__PURE__*/_react.default.createElement(_textarea.default, _extends({
-        labelInline: labelInline,
-        "data-component": dataComponent,
-        "data-role": dataRole,
-        "data-element": dataElement
-      }, (0, _utils.filterStyledSystemMarginProps)(props)), /*#__PURE__*/_react.default.createElement(_formField.default, {
-        fieldHelp: fieldHelp,
-        error: error,
-        warning: warning,
-        info: info,
-        label: label,
-        disabled: disabled,
-        id: this.id,
-        labelInline: labelInline,
-        labelAlign: labelAlign,
-        labelWidth: labelWidth,
-        labelHelp: labelHelp,
-        labelSpacing: labelSpacing,
-        isRequired: props.required,
-        useValidationIcon: validationOnLabel,
-        adaptiveLabelBreakpoint: adaptiveLabelBreakpoint
-      }, /*#__PURE__*/_react.default.createElement(_input.InputPresentation, {
-        size: size,
-        disabled: disabled,
-        readOnly: readOnly,
-        inputWidth: typeof inputWidth === "number" ? inputWidth : 100 - labelWidth,
-        error: error,
-        warning: warning,
-        info: info
-      }, /*#__PURE__*/_react.default.createElement(_input2.default, _extends({
-        autoFocus: autoFocus,
-        name: name,
-        "aria-invalid": !!error,
-        ref: this._input,
-        maxLength: enforceCharacterLimit && characterLimit ? characterLimit : undefined,
-        onChange: onChange,
-        disabled: disabled,
-        readOnly: readOnly,
-        labelInline: labelInline,
-        placeholder: disabled ? "" : placeholder,
-        rows: rows,
-        cols: cols,
-        id: this.id,
-        as: "textarea"
-      }, props)), children, /*#__PURE__*/_react.default.createElement(_inputIconToggle.default, {
-        disabled: disabled,
-        readOnly: readOnly,
-        inputIcon: inputIcon,
-        size: size,
-        error: error,
-        warning: warning,
-        info: info,
-        useValidationIcon: !validationOnLabel
-      }))), this.characterCount)));
+  const isOverLimit = () => {
+    return (value || "").length > parseInt(characterLimit, 10);
+  };
+
+  const characterCount = () => {
+    if (!characterLimit) {
+      return null;
     }
-  }]);
 
-  return Textarea;
-}(_react.default.Component);
+    return /*#__PURE__*/_react.default.createElement(_characterCount.default, {
+      isOverLimit: isOverLimit() && warnOverLimit,
+      value: getFormatNumber((value || "").length, locale.locale()),
+      limit: getFormatNumber(characterLimit, locale.locale()),
+      "data-element": "character-limit"
+    });
+  };
+
+  return /*#__PURE__*/_react.default.createElement(_tooltipProvider.TooltipProvider, {
+    tooltipPosition: tooltipPosition,
+    helpAriaLabel: helpAriaLabel
+  }, /*#__PURE__*/_react.default.createElement(_inputBehaviour.InputBehaviour, null, /*#__PURE__*/_react.default.createElement(_textarea.default, _extends({
+    labelInline: labelInline,
+    "data-component": dataComponent,
+    "data-role": dataRole,
+    "data-element": dataElement
+  }, (0, _utils.filterStyledSystemMarginProps)(props)), /*#__PURE__*/_react.default.createElement(_formField.default, {
+    fieldHelp: fieldHelp,
+    error: error,
+    warning: warning,
+    info: info,
+    label: label,
+    disabled: disabled,
+    id: id,
+    labelInline: labelInline,
+    labelAlign: labelAlign,
+    labelWidth: labelWidth,
+    labelHelp: labelHelp,
+    labelSpacing: labelSpacing,
+    isRequired: props.required,
+    useValidationIcon: validationOnLabel,
+    adaptiveLabelBreakpoint: adaptiveLabelBreakpoint
+  }, /*#__PURE__*/_react.default.createElement(_input.InputPresentation, {
+    size: size,
+    disabled: disabled,
+    readOnly: readOnly,
+    inputWidth: typeof inputWidth === "number" ? inputWidth : 100 - labelWidth,
+    error: error,
+    warning: warning,
+    info: info
+  }, /*#__PURE__*/_react.default.createElement(_input2.default, _extends({
+    autoFocus: autoFocus,
+    name: name,
+    "aria-invalid": !!error,
+    ref: inputRef,
+    maxLength: enforceCharacterLimit && characterLimit ? characterLimit : undefined,
+    onChange: onChange,
+    disabled: disabled,
+    readOnly: readOnly,
+    labelInline: labelInline,
+    placeholder: disabled ? "" : placeholder,
+    rows: rows,
+    cols: cols,
+    id: id,
+    as: "textarea"
+  }, props)), children, /*#__PURE__*/_react.default.createElement(_inputIconToggle.default, {
+    disabled: disabled,
+    readOnly: readOnly,
+    inputIcon: inputIcon,
+    size: size,
+    error: error,
+    warning: warning,
+    info: info,
+    useValidationIcon: !validationOnLabel
+  }))), characterCount())));
+};
 
 exports.OriginalTextarea = Textarea;
-Textarea.contextType = _i18nContext.default;
 Textarea.propTypes = { ...marginPropTypes,
 
   /** Automatically focus the input on component mount */
@@ -381,14 +319,5 @@ Textarea.propTypes = { ...marginPropTypes,
   /** Aria label for rendered help component */
   helpAriaLabel: _propTypes.default.string
 };
-Textarea.defaultProps = {
-  labelWidth: 30,
-  disabled: false,
-  expandable: false,
-  enforceCharacterLimit: true,
-  readOnly: false,
-  warnOverLimit: false,
-  validationOnLabel: false
-};
 var _default = Textarea;
 exports.default = _default;

package/lib/components/textarea/textarea.d.ts

@@ -74,7 +74,7 @@ export interface TextareaProps
   helpAriaLabel?: string;
 }
 
-declare class Textarea extends React.Component<TextareaProps> {}
+declare function Textarea(props: TextareaProps): JSX.Element;
 
 export { Textarea as OriginalTextarea };
 export default Textarea;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carbon-react",
-  "version": "95.1.3",
+  "version": "97.0.0",
   "description": "A library of reusable React components for easily building user interfaces.",
   "engineStrict": true,
   "engines": {
@@ -31,8 +31,7 @@
     "babel": "cross-env NODE_ENV=production babel ./src --config-file ./babel.config.js --out-dir ./lib --ignore '**/*/__spec__.js','**/*.spec.js','**/__definition__.js' --quiet",
     "clean-lib": "rimraf ./lib",
     "copy-files": "cpy \"**/\" \"!**/(*.js|*.md|*.mdx|*.stories.*|*.snap)\" ../lib/ --cwd=src --parents",
-    "commit": "git-cz",
-    "chromatic": "chromatic"
+    "commit": "git-cz"
   },
   "repository": {
     "type": "git",
@@ -89,6 +88,7 @@
     "babel-jest": "^26.6.3",
     "browserslist": "^4.16.6",
     "chalk": "^4.1.1",
+    "chromatic": "^6.0.5",
     "commitizen": "^4.2.4",
     "conventional-changelog-conventionalcommits": "^4.5.0",
     "core-js": "^3.1.4",