@dxc-technology/halstack-react 0.0.0-2d619b4 → 0.0.0-2edb175

package/{dist/new-input-text → text-input}/index.d.ts

@@ -6,10 +6,10 @@ type Margin = {
   left?: Space;
   right?: Space;
 };
-type SVG = string | (HTMLElement & SVGElement);
+type SVG = React.SVGProps<SVGSVGElement> | React.FunctionComponent<React.SVGProps<SVGSVGElement>>;
 type Action = {
   onClick: (event: React.MouseEvent<HTMLButtonElement>) => void;
-  icon: SVG;
+  icon: string | SVG;
 };
 
 type Props = {
@@ -47,8 +47,10 @@ type Props = {
    */
   disabled?: boolean;
   /**
-   * If true, the input will be optional, showing '(Optional)' next to the label.
-   * Otherwise, the field will be considered required and will display an error when not filled in.
+   * If true, the input will be optional, showing '(Optional)'
+   * next to the label. Otherwise, the field will be considered required and an error will be
+   * passed as a parameter to the OnBlur and onChange functions when it has
+   * not been filled.
    */
   optional?: boolean;
   /**
@@ -60,17 +62,23 @@ type Props = {
    */
   suffix?: string;
   /**
-   * This function will be called when the user types within the input. The new value will be passed as a parameter.
+   * This function will be called when the user types within the input
+   * element of the component. An object including the current value and
+   * the error (if the value entered is not valid) will be passed to this
+   * function. If there is no error, error will be null.
    */
-  onChange?: (value: string) => void;
+  onChange?: (val: { value: string; error: string }) => void;
   /**
-   * This function will be called when the input loses the focus. An object including the input value and the error will be passed to this function.
-   * If there is no error, error will be null.
+   * This function will be called when the input element loses the focus.
+   * An object including the input value and the error (if the value
+   * entered is not valid) will be passed to this function. If there is no error, 
+   * error will be null.
    */
   onBlur?: (obj: { value: string; error: string }) => void;
   /**
-   * If it is defined, the component will change its appearance, showing the error below the input component.
-   * If it is not defined, the error messages will be created and managed internally.
+   * If it is defined, the component will change its appearance, showing
+   * the error below the input component. If it is not defined, the error
+   * messages will be managed internally, but never displayed on its own.
    */
   error?: string;
   /**
@@ -81,16 +89,23 @@ type Props = {
    */
   suggestions?: string[] | (() => void);
   /**
-   * Regular expression that defines the valid format allowed by the input. This will be checked when the input loses the focus.
-   * If the value entered does not match the pattern, the onBlur function will be called with the value entered
-   * and the error informing that the value does not match the pattern as parameters. If the pattern is accomplished,
-   * the error parameter will be null.
+    * Regular expression that defines the valid format allowed by the input.
+    * This will be checked both when the input element loses the focus and
+    * while typing within it. If the string entered does not match the
+    * pattern, the onBlur and onChange functions will be called with the
+    * current value and an internal error informing that this value does not
+    * match the pattern. If the pattern is met, the error parameter of both
+    * events will be null.
    */
   pattern?: string;
   /**
-   * Specifies the minimun and maximum length allowed by the input. This will be checked when the input loses the focus. If the value entered does not comply the length,
-   * the onBlur function will be called with the value entered and the error informing that the value does not comply the length as parameters.
-   * If the length is accomplished, the error parameter will be null.
+    * Specifies the minimun and maximum length allowed by the input. 
+    * This will be checked both when the input element loses the
+    * focus and while typing within it. If the string entered does not
+    * comply the length, the onBlur and onChange functions will be called
+    * with the current value and an internal error informing that the value
+    * length does not comply the specified range. If a valid length is
+    * reached, the error parameter of both events will be null.
    */
   length?: { min?: number; max?: number };
   /**
@@ -117,4 +132,4 @@ type Props = {
   ref?: React.RefObject<HTMLDivElement>;
 };
 
-export default function DxcNewInputText(props: Props): JSX.Element;
+export default function DxcTextInput(props: Props): JSX.Element;

package/{dist/new-textarea/NewTextarea.js → textarea/Textarea.js}

@@ -1,9 +1,9 @@
 "use strict";
 
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
-
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
+var _typeof3 = require("@babel/runtime/helpers/typeof");
+
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -33,65 +33,11 @@ var _uuid = require("uuid");
 
 var _BackgroundColorContext = _interopRequireDefault(require("../BackgroundColorContext.js"));
 
-function _templateObject6() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n  font-family: ", ";\n  font-size: 0.75rem;\n  font-weight: 400;\n  min-height: 1.5em;\n  line-height: 1.5em;\n"]);
-
-  _templateObject6 = function _templateObject6() {
-    return data;
-  };
-
-  return data;
-}
-
-function _templateObject5() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  ", ";\n  ", "\n\n  margin: calc(1rem * 0.25) 0;\n  padding: calc(1rem * 0.5) calc(1rem * 1);\n  box-shadow: 0 0 0 2px transparent;\n  border-radius: calc(1rem * 0.25);\n  border: 1px solid\n    ", ";\n  ", "\n\n  ", ";\n  ", ";\n\n  color: ", ";\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  line-height: 1.5em;\n\n  ::placeholder {\n    color: ", ";\n  }\n"]);
-
-  _templateObject5 = function _templateObject5() {
-    return data;
-  };
-
-  return data;
-}
-
-function _templateObject4() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  line-height: 1.5em;\n"]);
-
-  _templateObject4 = function _templateObject4() {
-    return data;
-  };
-
-  return data;
-}
-
-function _templateObject3() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  font-weight: ", ";\n"]);
-
-  _templateObject3 = function _templateObject3() {
-    return data;
-  };
-
-  return data;
-}
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6;
 
-function _templateObject2() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  line-height: 1.75em;\n"]);
+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); }
 
-  _templateObject2 = function _templateObject2() {
-    return data;
-  };
-
-  return data;
-}
-
-function _templateObject() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-direction: column;\n\n  width: ", ";\n  margin: ", ";\n  margin-top: ", ";\n  margin-right: ", ";\n  margin-bottom: ", ";\n  margin-left: ", ";\n"]);
-
-  _templateObject = function _templateObject() {
-    return data;
-  };
-
-  return data;
-}
+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; }
 
 var getNotOptionalErrorMessage = function getNotOptionalErrorMessage() {
   return "This field is required. Please, enter a value.";
@@ -101,15 +47,15 @@ var getLengthErrorMessage = function getLengthErrorMessage(length) {
   return "Min length ".concat(length.min, ", max length ").concat(length.max, ".");
 };
 
-var patternMatch = function patternMatch(pattern, value) {
-  return new RegExp(pattern).test(value);
-};
-
 var getPatternErrorMessage = function getPatternErrorMessage() {
   return "Please match the format requested.";
 };
 
-var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
+var patternMatch = function patternMatch(pattern, value) {
+  return new RegExp(pattern).test(value);
+};
+
+var DxcTextarea = /*#__PURE__*/_react["default"].forwardRef(function (_ref, ref) {
   var _ref$label = _ref.label,
       label = _ref$label === void 0 ? "" : _ref$label,
       _ref$name = _ref.name,
@@ -146,23 +92,16 @@ var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
       innerValue = _useState2[0],
       setInnerValue = _useState2[1];
 
-  var _useState3 = (0, _react.useState)(""),
-      _useState4 = (0, _slicedToArray2["default"])(_useState3, 2),
-      validationError = _useState4[0],
-      changeValidationError = _useState4[1];
+  var _useState3 = (0, _react.useState)("textarea-".concat((0, _uuid.v4)())),
+      _useState4 = (0, _slicedToArray2["default"])(_useState3, 1),
+      textareaId = _useState4[0];
 
   var colorsTheme = (0, _useTheme["default"])();
   var backgroundType = (0, _react.useContext)(_BackgroundColorContext["default"]);
   var textareaRef = (0, _react.useRef)(null);
-  var textareaId = "textarea-".concat((0, _uuid.v4)());
   var errorId = "error-message-".concat(textareaId);
 
-  var changeValue = function changeValue(newValue) {
-    value !== null && value !== void 0 ? value : setInnerValue(newValue);
-    typeof onChange === "function" && onChange(newValue);
-  };
-
-  var notOptionalCheck = function notOptionalCheck(value) {
+  var isNotOptional = function isNotOptional(value) {
     return value === "" && !optional;
   };
 
@@ -170,32 +109,37 @@ var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
     return value !== "" && length && length.min && length.max && (value.length < length.min || value.length > length.max);
   };
 
+  var changeValue = function changeValue(newValue) {
+    value !== null && value !== void 0 ? value : setInnerValue(newValue);
+    if (isNotOptional(newValue)) onChange === null || onChange === void 0 ? void 0 : onChange({
+      value: newValue,
+      error: getNotOptionalErrorMessage()
+    });else if (isLengthIncorrect(newValue)) onChange === null || onChange === void 0 ? void 0 : onChange({
+      value: newValue,
+      error: getLengthErrorMessage(length)
+    });else if (newValue && pattern && !patternMatch(pattern, newValue)) onChange === null || onChange === void 0 ? void 0 : onChange({
+      value: newValue,
+      error: getPatternErrorMessage()
+    });else onChange === null || onChange === void 0 ? void 0 : onChange({
+      value: newValue,
+      error: null
+    });
+  };
+
   var handleTOnBlur = function handleTOnBlur(event) {
-    if (notOptionalCheck(event.target.value)) {
-      changeValidationError(getNotOptionalErrorMessage());
-      onBlur === null || onBlur === void 0 ? void 0 : onBlur({
-        value: event.target.value,
-        error: getNotOptionalErrorMessage()
-      });
-    } else if (isLengthIncorrect(event.target.value)) {
-      changeValidationError(getLengthErrorMessage(length, event));
-      onBlur === null || onBlur === void 0 ? void 0 : onBlur({
-        value: event.target.value,
-        error: getLengthErrorMessage(length)
-      });
-    } else if (event.target.value && pattern && !patternMatch(pattern, event.target.value)) {
-      changeValidationError(getPatternErrorMessage());
-      onBlur === null || onBlur === void 0 ? void 0 : onBlur({
-        value: event.target.value,
-        error: getPatternErrorMessage()
-      });
-    } else {
-      changeValidationError("");
-      onBlur === null || onBlur === void 0 ? void 0 : onBlur({
-        value: event.target.value,
-        error: null
-      });
-    }
+    if (isNotOptional(event.target.value)) onBlur === null || onBlur === void 0 ? void 0 : onBlur({
+      value: event.target.value,
+      error: getNotOptionalErrorMessage()
+    });else if (isLengthIncorrect(event.target.value)) onBlur === null || onBlur === void 0 ? void 0 : onBlur({
+      value: event.target.value,
+      error: getLengthErrorMessage(length)
+    });else if (event.target.value && pattern && !patternMatch(pattern, event.target.value)) onBlur === null || onBlur === void 0 ? void 0 : onBlur({
+      value: event.target.value,
+      error: getPatternErrorMessage()
+    });else onBlur === null || onBlur === void 0 ? void 0 : onBlur({
+      value: event.target.value,
+      error: null
+    });
   };
 
   var handleTOnChange = function handleTOnChange(event) {
@@ -211,20 +155,20 @@ var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
       textareaRef.current.style.height = "".concat(newHeight, "px");
     }
   }, [value, verticalGrow, rows, innerValue]);
-  return _react["default"].createElement(_styledComponents.ThemeProvider, {
-    theme: colorsTheme.newTextarea
-  }, _react["default"].createElement(DxcTextarea, {
+  return /*#__PURE__*/_react["default"].createElement(_styledComponents.ThemeProvider, {
+    theme: colorsTheme.textarea
+  }, /*#__PURE__*/_react["default"].createElement(TextareaContainer, {
     margin: margin,
     size: size,
     ref: ref
-  }, _react["default"].createElement(Label, {
+  }, /*#__PURE__*/_react["default"].createElement(Label, {
     htmlFor: textareaId,
     disabled: disabled,
     backgroundType: backgroundType
-  }, label, " ", optional && _react["default"].createElement(OptionalLabel, null, "(Optional)")), _react["default"].createElement(HelperText, {
+  }, label, " ", optional && /*#__PURE__*/_react["default"].createElement(OptionalLabel, null, "(Optional)")), /*#__PURE__*/_react["default"].createElement(HelperText, {
     disabled: disabled,
     backgroundType: backgroundType
-  }, helperText), _react["default"].createElement(Textarea, {
+  }, helperText), /*#__PURE__*/_react["default"].createElement(Textarea, {
     id: textareaId,
     name: name,
     value: value !== null && value !== void 0 ? value : innerValue,
@@ -234,18 +178,20 @@ var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
     onChange: handleTOnChange,
     onBlur: handleTOnBlur,
     disabled: disabled,
-    error: error || validationError,
+    error: error,
+    minLength: length === null || length === void 0 ? void 0 : length.min,
+    maxLength: length === null || length === void 0 ? void 0 : length.max,
     autoComplete: autocomplete,
     backgroundType: backgroundType,
     ref: textareaRef,
     tabIndex: tabIndex,
-    "aria-invalid": error || validationError ? "true" : "false",
-    "aria-describedby": error || validationError ? errorId : undefined,
+    "aria-invalid": error ? "true" : "false",
+    "aria-describedby": error ? errorId : undefined,
     "aria-required": optional ? "false" : "true"
-  }), !disabled && _react["default"].createElement(Error, {
+  }), !disabled && /*#__PURE__*/_react["default"].createElement(Error, {
     id: errorId,
     backgroundType: backgroundType
-  }, error || validationError)));
+  }, error)));
 });
 
 var sizes = {
@@ -259,7 +205,7 @@ var calculateWidth = function calculateWidth(margin, size) {
   return size === "fillParent" ? "calc(".concat(sizes[size], " - ").concat((0, _utils.getMargin)(margin, "left"), " - ").concat((0, _utils.getMargin)(margin, "right"), ")") : sizes[size];
 };
 
-var DxcTextarea = _styledComponents["default"].div(_templateObject(), function (props) {
+var TextareaContainer = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-direction: column;\n\n  width: ", ";\n  margin: ", ";\n  margin-top: ", ";\n  margin-right: ", ";\n  margin-bottom: ", ";\n  margin-left: ", ";\n"])), function (props) {
   return calculateWidth(props.margin, props.size);
 }, function (props) {
   return props.margin && (0, _typeof2["default"])(props.margin) !== "object" ? _variables.spaces[props.margin] : "0px";
@@ -273,7 +219,7 @@ var DxcTextarea = _styledComponents["default"].div(_templateObject(), function (
   return props.margin && (0, _typeof2["default"])(props.margin) === "object" && props.margin.left ? _variables.spaces[props.margin.left] : "";
 });
 
-var Label = _styledComponents["default"].label(_templateObject2(), function (props) {
+var Label = _styledComponents["default"].label(_templateObject2 || (_templateObject2 = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  line-height: ", ";\n"])), function (props) {
   return props.disabled ? props.backgroundType === "dark" ? props.theme.disabledLabelFontColorOnDark : props.theme.disabledLabelFontColor : props.backgroundType === "dark" ? props.theme.labelFontColorOnDark : props.theme.labelFontColor;
 }, function (props) {
   return props.theme.fontFamily;
@@ -283,13 +229,15 @@ var Label = _styledComponents["default"].label(_templateObject2(), function (pro
   return props.theme.labelFontStyle;
 }, function (props) {
   return props.theme.labelFontWeight;
+}, function (props) {
+  return props.theme.labelLineHeight;
 });
 
-var OptionalLabel = _styledComponents["default"].span(_templateObject3(), function (props) {
+var OptionalLabel = _styledComponents["default"].span(_templateObject3 || (_templateObject3 = (0, _taggedTemplateLiteral2["default"])(["\n  font-weight: ", ";\n"])), function (props) {
   return props.theme.optionalLabelFontWeight;
 });
 
-var HelperText = _styledComponents["default"].span(_templateObject4(), function (props) {
+var HelperText = _styledComponents["default"].span(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  line-height: ", ";\n"])), function (props) {
   return props.disabled ? props.backgroundType === "dark" ? props.theme.disabledHelperTextFontColorOnDark : props.theme.disabledHelperTextFontColor : props.backgroundType === "dark" ? props.theme.helperTextFontColorOnDark : props.theme.helperTextFontColor;
 }, function (props) {
   return props.theme.fontFamily;
@@ -299,12 +247,16 @@ var HelperText = _styledComponents["default"].span(_templateObject4(), function
   return props.theme.helperTextFontStyle;
 }, function (props) {
   return props.theme.helperTextFontWeight;
+}, function (props) {
+  return props.theme.helperTextLineHeight;
 });
 
-var Textarea = _styledComponents["default"].textarea(_templateObject5(), function (props) {
+var Textarea = _styledComponents["default"].textarea(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["\n  ", ";\n  ", "\n\n  margin: ", ";\n  padding: 0.5rem 1rem;\n  box-shadow: 0 0 0 2px transparent;\n  border-radius: 0.25rem;\n  border: 1px solid\n    ", ";\n  ", "\n\n  ", ";\n  ", ";\n\n  color: ", ";\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  line-height: 1.5em;\n\n  ::placeholder {\n    color: ", ";\n  }\n"])), function (props) {
   if (props.verticalGrow === "none") return "resize: none;";else if (props.verticalGrow === "auto") return "resize: none; overflow: hidden;";else if (props.verticalGrow === "manual") return "resize: vertical;";else return "resize: none;";
 }, function (props) {
   if (props.disabled) return props.backgroundType === "dark" ? "background-color: ".concat(props.theme.disabledContainerFillColorOnDark, ";") : "background-color: ".concat(props.theme.disabledContainerFillColor, ";");else return "background-color: transparent;";
+}, function (props) {
+  return "".concat(props.theme.inputMarginTop, " 0 ").concat(props.theme.inputMarginBottom, " 0");
 }, function (props) {
   if (props.disabled) return props.backgroundType === "dark" ? props.theme.disabledBorderColorOnDark : props.theme.disabledBorderColor;else return props.backgroundType === "dark" ? props.theme.enabledBorderColorOnDark : props.theme.enabledBorderColor;
 }, function (props) {
@@ -327,13 +279,13 @@ var Textarea = _styledComponents["default"].textarea(_templateObject5(), functio
   return props.disabled ? props.backgroundType === "dark" ? props.theme.disabledPlaceholderFontColorOnDark : props.theme.disabledPlaceholderFontColor : props.backgroundType === "dark" ? props.theme.placeholderFontColorOnDark : props.theme.placeholderFontColor;
 });
 
-var Error = _styledComponents["default"].span(_templateObject6(), function (props) {
+var Error = _styledComponents["default"].span(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n  font-family: ", ";\n  font-size: 0.75rem;\n  font-weight: 400;\n  min-height: 1.5em;\n  line-height: 1.5em;\n"])), function (props) {
   return props.backgroundType === "dark" ? props.theme.errorMessageColorOnDark : props.theme.errorMessageColor;
 }, function (props) {
   return props.theme.fontFamily;
 });
 
-DxcNewTextarea.propTypes = {
+DxcTextarea.propTypes = {
   label: _propTypes["default"].string,
   name: _propTypes["default"].string,
   value: _propTypes["default"].string,
@@ -361,5 +313,5 @@ DxcNewTextarea.propTypes = {
   size: _propTypes["default"].oneOf((0, _toConsumableArray2["default"])(Object.keys(sizes))),
   tabIndex: _propTypes["default"].number
 };
-var _default = DxcNewTextarea;
+var _default = DxcTextarea;
 exports["default"] = _default;

package/textarea/Textarea.stories.jsx

@@ -0,0 +1,135 @@
+import React from "react";
+import DxcTextarea from "./Textarea";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+import { BackgroundColorProvider } from "../BackgroundColorContext";
+import DarkContainer from "../../.storybook/components/DarkSection";
+
+export default {
+  title: "Textarea",
+  component: DxcTextarea,
+};
+
+export const Chromatic = () => (
+  <>
+    <>
+      <ExampleContainer pseudoState="pseudo-hover">
+        <Title title="Hovered" theme="light" level={4} />
+        <DxcTextarea label="Hovered" />
+      </ExampleContainer>
+      <ExampleContainer pseudoState="pseudo-focus">
+        <Title title="Focused" theme="light" level={4} />
+        <DxcTextarea label="Focused" />
+      </ExampleContainer>
+      <ExampleContainer>
+        <Title title="Disabled" theme="light" level={4} />
+        <DxcTextarea
+          label="Disabled"
+          optional
+          helperText="Sample text"
+          placeholder="Enter your text here..."
+          disabled
+        />
+      </ExampleContainer>
+      <ExampleContainer>
+        <Title title="Disabled with value" theme="light" level={4} />
+        <DxcTextarea label="Disabled" value="Example text" disabled />
+      </ExampleContainer>
+      <ExampleContainer>
+        <Title title="With error" theme="light" level={4} />
+        <DxcTextarea
+          label="Textarea with error"
+          helperText="Helper text"
+          placeholder="Enter your text here..."
+          error="Error message"
+        />
+      </ExampleContainer>
+      <ExampleContainer>
+        <Title title="Helper text and optional with value" theme="light" level={4} />
+        <DxcTextarea label="Helper & optional" value="Some text" helperText="Sample text" optional />
+      </ExampleContainer>
+      <ExampleContainer>
+        <Title title="Resizable" theme="light" level={4} />
+        <DxcTextarea label="With resizer" helperText="Helper text" verticalGrow="manual" />
+      </ExampleContainer>
+      <ExampleContainer>
+        <Title title="Grow manual" theme="light" level={4} />
+        <DxcTextarea
+          label="Manual vertical grow"
+          verticalGrow="manual"
+          value="Long textttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt"
+        />
+      </ExampleContainer>
+    </>
+    <BackgroundColorProvider color="#333333">
+      <DarkContainer>
+        <>
+          <Title title="Helper text and optional with value" theme="dark" level={4} />
+          <DxcTextarea label="Helper & optional" value="Some text" margin="medium" helperText="Sample text" optional />
+
+          <Title title="Disabled" theme="dark" level={4} />
+          <DxcTextarea
+            label="Disabled"
+            margin="medium"
+            optional
+            helperText="Sample text"
+            placeholder="Enter your text here..."
+            disabled
+          />
+          <Title title="Disabled with value" theme="dark" level={4} />
+          <DxcTextarea label="Disabled" margin="medium" value="Example text" disabled />
+          <Title title="With error" theme="dark" level={4} />
+          <DxcTextarea
+            label="Textarea with error"
+            margin="medium"
+            helperText="Helper text"
+            placeholder="Enter your text here..."
+            error="Error message"
+          />
+        </>
+      </DarkContainer>
+    </BackgroundColorProvider>
+    <Title title="Sizes" theme="light" level={2} />
+    <ExampleContainer>
+      <DxcTextarea label="Small" size="small" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <DxcTextarea label="Medium" size="medium" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <DxcTextarea label="Large" size="large" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <DxcTextarea label="Fill parent" size="fillParent" />
+    </ExampleContainer>
+    <Title title="Margins" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall margin" theme="light" level={4} />
+      <DxcTextarea label="Xxsmmall" margin="xxsmall" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xsmall margin" theme="light" level={4} />
+      <DxcTextarea label="xsmmall" margin="xsmall" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Small margin" theme="light" level={4} />
+      <DxcTextarea label="smmall" margin="small" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium margin" theme="light" level={4} />
+      <DxcTextarea label="medium" margin="medium" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large margin" theme="light" level={4} />
+      <DxcTextarea label="Large" margin="large" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xlarge margin" theme="light" level={4} />
+      <DxcTextarea label="Xlarge" margin="xlarge" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xxlarge margin" theme="light" level={4} />
+      <DxcTextarea label="Xxlarge" margin="xxlarge" />
+    </ExampleContainer>
+  </>
+);

package/{dist/new-textarea → textarea}/index.d.ts

@@ -6,7 +6,6 @@ type Margin = {
   left?: Space;
   right?: Space;
 };
-type VerticalGrow = "auto" | "manual" | "none";
 
 type Props = {
   /**
@@ -34,7 +33,10 @@ type Props = {
    */
   disabled?: boolean;
   /**
-   * If true, the textarea will be marked as optional, showing '(Optional)' next to the label. Otherwise, the field will be considered required and will display an error when not filled in.
+   * If true, the textarea will be optional, showing '(Optional)' 
+   * next to the label. Otherwise, the field will be considered required 
+   * and an error will be passed as a parameter to the OnBlur and onChange functions 
+   * when it has not been filled.
    */
   optional?: boolean;
   /**
@@ -43,44 +45,58 @@ type Props = {
    *    - 'manual': The height of the textarea is enabled to be manually modified.
    *    - 'none': The textarea has a fixed height and can't be modified.
    */
-  verticalGrow?: VerticalGrow;
+  verticalGrow?: "auto" | "manual" | "none";
   /**
    * Number of rows of the textarea.
    */
   rows?: number;
   /**
-   * This function will be called when the user types within the textarea. The new value will be passed as a parameter.
+   * This function will be called when the user types within the textarea.
+   * An object including the current value and the error (if the value
+   * entered is not valid) will be passed to this function. 
+   * If there is no error, error will be null.
    */
-  onChange?: (value: string) => void;
+  onChange?: (val: { value: string; error: string }) => void;
   /**
-   * This function will be called when the textarea loses the focus. An object including the textarea value and the error will be passed to this function. 
-   * If there is no error, error will be null.
+   * This function will be called when the textarea loses the focus. An
+   * object including the textarea value and the error (if the value entered
+   * is not valid) will be passed to this function. If there is no error, 
+   * error will be null.
    */
   onBlur?: (val: { value: string; error: string }) => void;
   /**
-   * If it is defined, the component will change its appearance, showing the error below the textarea component. If it is not defined, the error messages will be created and managed internally.
+   * If it is defined, the component will change its appearance, showing
+   * the error below the textarea. If it is not defined, the error
+   * messages will be managed internally, but never displayed on its own.
    */
   error?: string;
   /**
-   * Regular expression that defines the valid format allowed by the textarea. This will be checked when the textarea loses the focus. 
-   * If the value entered does not match the pattern, the onBlur function will be called with the value entered and the error informing that the value does not match the pattern as parameters. 
-   * If the pattern is accomplished, the error parameter will be null.
+   * Regular expression that defines the valid format allowed by the
+   * textarea. This will be checked both when the textarea loses the focus
+   * and while typing within it. If the string entered does not match the
+   * pattern, the onBlur and onChange functions will be called with the
+   * current value and an internal error informing that this value does not
+   * match the pattern. If the pattern is met, the error parameter of both
+   * events will be null.
    */
   pattern?: string;
   /**
-   * Specifies the minimun and maximum length allowed by the textarea. It follows this structure: { min: minLength, max: maxLength }. 
-   * This will be checked when the textarea loses the focus. If the value entered does not comply the length, 
-   * the onBlur function will be called with the value entered and the error informing that the value does not comply the length as parameters. 
-   * If the length is accomplished, the error parameter will be null.
+   * Specifies the minimun and maximum length allowed by the textarea.
+   * This will be checked both when the textarea loses the
+   * focus and while typing within it. If the string entered does not
+   * comply the length, the onBlur and onChange functions will be called
+   * with the current value and an internal error informing that the value
+   * length does not comply the specified range. If a valid length is
+   * reached, the error parameter of both events will be null.
    */
   length?: { min: number; max: number };
   /**
-   * HTML autocomplete attribute. Lets the user specify if any permission the user agent has to provide automated assistance in filling out the textarea value. 
+   * HTML autocomplete attribute. Lets the user specify if any permission the user agent has to provide automated assistance in filling out the textarea value.
    * Its value must be one of all the possible values of the HTML autocomplete attribute: 'on', 'off', 'email', 'username', 'new-password', ...
    */
   autocomplete?: string;
   /**
-   * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge'). 
+   * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
    * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
    */
   margin?: Space | Margin;
@@ -98,4 +114,4 @@ type Props = {
   ref?: React.RefObject<HTMLDivElement>;
 };
 
-export default function DxcNewTextarea(props: Props): JSX.Element;
+export default function DxcTextarea(props: Props): JSX.Element;