@dxc-technology/halstack-react 0.0.0-13e0035 → 0.0.0-1418b62

package/dist/new-select/index.d.ts

@@ -0,0 +1,53 @@
+type SVG = string | (HTMLElement & SVGElement);
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+  top?: Space;
+  bottom?: Space;
+  left?: Space;
+  right?: Space;
+};
+
+type OptionGroup = {
+  label: string;
+  options: Option[];
+};
+type Option = {
+  icon?: string | SVG;
+  label: string;
+  value: string;
+};
+
+type Props = {
+  label?: string;
+  name?: string;
+  value?: string | string[];
+  options?: Option[] | OptionGroup[];
+  helperText?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  optional?: boolean;
+  searchable?: boolean;
+  multiple?: boolean;
+  onChange?: (value: string | string[]) => void;
+  onBlur?: (val: { value: string | string[]; error: string }) => void;
+  error?: string;
+  /**
+   * 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;
+  /**
+   * Size of the component ('small' | 'medium' | 'large' | 'fillParent').
+   */
+  size?: "small" | "medium" | "large" | "fillParent";
+  /**
+   * Value of the tabindex attribute.
+   */
+  tabIndex?: number;
+  /**
+   * Reference to the component.
+   */
+  ref?: React.RefObject<HTMLDivElement>;
+};
+
+export default function DxcNewSelect(props: Props): JSX.Element;

package/dist/new-textarea/NewTextarea.js

@@ -93,18 +93,22 @@ function _templateObject() {
   return data;
 }
 
-var getLengthErrorMessage = function getLengthErrorMessage(length) {
-  return "Min length ".concat(length.min, ", max length ").concat(length.max, ".");
+var getNotOptionalErrorMessage = function getNotOptionalErrorMessage() {
+  return "This field is required. Please, enter a value.";
 };
 
-var patternMatch = function patternMatch(pattern, value) {
-  return new RegExp(pattern).test(value);
+var getLengthErrorMessage = function getLengthErrorMessage(length) {
+  return "Min length ".concat(length.min, ", max length ").concat(length.max, ".");
 };
 
 var getPatternErrorMessage = function getPatternErrorMessage() {
   return "Please match the format requested.";
 };
 
+var patternMatch = function patternMatch(pattern, value) {
+  return new RegExp(pattern).test(value);
+};
+
 var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
   var _ref$label = _ref.label,
       label = _ref$label === void 0 ? "" : _ref$label,
@@ -123,12 +127,14 @@ var DxcNewTextarea = _react["default"].forwardRef(function (_ref, ref) {
       verticalGrow = _ref$verticalGrow === void 0 ? "auto" : _ref$verticalGrow,
       _ref$rows = _ref.rows,
       rows = _ref$rows === void 0 ? 4 : _ref$rows,
-      length = _ref.length,
-      pattern = _ref.pattern,
       onChange = _ref.onChange,
       onBlur = _ref.onBlur,
       _ref$error = _ref.error,
       error = _ref$error === void 0 ? "" : _ref$error,
+      pattern = _ref.pattern,
+      length = _ref.length,
+      _ref$autocomplete = _ref.autocomplete,
+      autocomplete = _ref$autocomplete === void 0 ? "off" : _ref$autocomplete,
       margin = _ref.margin,
       _ref$size = _ref.size,
       size = _ref$size === void 0 ? "medium" : _ref$size,
@@ -140,45 +146,54 @@ 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 isNotOptional = function isNotOptional(value) {
+    return value === "" && !optional;
   };
 
   var isLengthIncorrect = function isLengthIncorrect(value) {
     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 (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) {
@@ -217,13 +232,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
-  }), _react["default"].createElement(Error, {
+    tabIndex: tabIndex,
+    "aria-invalid": error ? "true" : "false",
+    "aria-describedby": error ? errorId : undefined,
+    "aria-required": optional ? "false" : "true"
+  }), !disabled && _react["default"].createElement(Error, {
+    id: errorId,
     backgroundType: backgroundType
-  }, error || validationError)));
+  }, error)));
 });
 
 var sizes = {
@@ -329,6 +351,7 @@ DxcNewTextarea.propTypes = {
   onChange: _propTypes["default"].func,
   onBlur: _propTypes["default"].func,
   error: _propTypes["default"].string,
+  autocomplete: _propTypes["default"].string,
   margin: _propTypes["default"].oneOfType([_propTypes["default"].shape({
     top: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),
     bottom: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),

package/dist/new-textarea/index.d.ts

@@ -0,0 +1,117 @@
+type Size = "small" | "medium" | "large" | "fillParent";
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+  top?: Space;
+  bottom?: Space;
+  left?: Space;
+  right?: Space;
+};
+
+type Props = {
+  /**
+   * Text to be placed above the textarea.
+   */
+  label?: string;
+  /**
+   * Name attribute of the textarea element.
+   */
+  name?: string;
+  /**
+   * Value of the textarea. If undefined, the component will be uncontrolled and the value will be managed internally.
+   */
+  value?: string;
+  /**
+   * Helper text to be placed above the textarea.
+   */
+  helperText?: string;
+  /**
+   * Text to be put as placeholder of the textarea.
+   */
+  placeholder?: string;
+  /**
+   * If true, the component will be disabled.
+   */
+  disabled?: boolean;
+  /**
+   * 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;
+  /**
+   * Defines the textarea's ability to resize vertically. It can be:
+   *    - 'auto': The textarea grows or shrinks automatically in order to fit the content.
+   *    - '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?: "auto" | "manual" | "none";
+  /**
+   * Number of rows of the textarea.
+   */
+  rows?: number;
+  /**
+   * 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?: (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 (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. 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 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.
+   * 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.
+   * 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').
+   * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
+   */
+  margin?: Space | Margin;
+  /**
+   * Size of the component ('small' | 'medium' | 'large' | 'fillParent').
+   */
+  size?: Size;
+  /**
+   * Value of the tabindex attribute.
+   */
+  tabIndex?: number;
+  /**
+   * Reference to the component.
+   */
+  ref?: React.RefObject<HTMLDivElement>;
+};
+
+export default function DxcNewTextarea(props: Props): JSX.Element;

package/dist/number/Number.js

@@ -1,7 +1,5 @@
 "use strict";
 
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
-
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
 Object.defineProperty(exports, "__esModule", {
@@ -13,7 +11,7 @@ var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers
 
 var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
 
-var _react = _interopRequireWildcard(require("react"));
+var _react = _interopRequireDefault(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
@@ -60,6 +58,8 @@ var DxcNumber = _react["default"].forwardRef(function (_ref, ref) {
       onBlur = _ref.onBlur,
       _ref$error = _ref.error,
       error = _ref$error === void 0 ? "" : _ref$error,
+      _ref$autocomplete = _ref.autocomplete,
+      autocomplete = _ref$autocomplete === void 0 ? "off" : _ref$autocomplete,
       margin = _ref.margin,
       _ref$size = _ref.size,
       size = _ref$size === void 0 ? "medium" : _ref$size,
@@ -85,6 +85,7 @@ var DxcNumber = _react["default"].forwardRef(function (_ref, ref) {
     error: error,
     onChange: onChange,
     onBlur: onBlur,
+    autocomplete: autocomplete,
     margin: margin,
     size: size,
     tabIndex: tabIndex,
@@ -121,6 +122,7 @@ DxcNumber.propTypes = {
   step: _propTypes["default"].number,
   onChange: _propTypes["default"].func,
   onBlur: _propTypes["default"].func,
+  autocomplete: _propTypes["default"].string,
   margin: _propTypes["default"].oneOfType([_propTypes["default"].shape({
     top: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),
     bottom: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),

package/dist/number/index.d.ts

@@ -0,0 +1,113 @@
+type Size = "small" | "medium" | "large" | "fillParent";
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+  top?: Space;
+  bottom?: Space;
+  left?: Space;
+  right?: Space;
+};
+type Props = {
+  /**
+   * Text to be placed above the number.
+   */
+  label?: string;
+  /**
+   * Name attribute of the input element.
+   */
+  name?: string;
+  /**
+   * Value of the input element. If undefined, the component will be uncontrolled and the value will be managed internally by the component.
+   */
+  value?: string;
+  /**
+   * Helper text to be placed above the number.
+   */
+  helperText?: string;
+  /**
+   * Text to be put as placeholder of the number.
+   */
+  placeholder?: string;
+  /**
+   * If true, the component will be disabled.
+   */
+  disabled?: boolean;
+  /**
+   * If true, the number 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;
+  /**
+   * Prefix to be placed before the number value.
+   */
+  prefix?: string;
+  /**
+   * Suffix to be placed after the number value.
+   */
+  suffix?: string;
+  /**
+   * Minimum value allowed by the number. If the typed value by the user is
+   * lower than min, the onBlur and onChange functions will be called with
+   * the current value and an internal error informing that the current
+   * value is not correct. If a valid state is reached, the error parameter
+   * will be null in both events.
+   */
+  min?: number;
+  /**
+   * Maximum value allowed by the number. If the typed value by the user
+   * surpasses max, the onBlur and onChange functions will be called with
+   * the current value and an internal error informing that the current
+   * value is not correct. If a valid state is reached, the error parameter
+   * will be null in both events.
+   */
+  max?: number;
+  /**
+   * The step interval to use when using the up and down arrows to adjust the value.
+   */
+  step?: number;
+  /**
+   * 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?: (val: { value: string; error: string }) => void;
+  /**
+   * 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?: (val: { 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 managed internally, but never displayed on its own.
+   */
+  error?: string;
+  /**
+   * HTML autocomplete attribute. Lets the user specify if any permission the user agent has to provide automated assistance in filling out the input 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'). 
+   * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
+   */
+  margin?: Space | Margin;
+  /**
+   * Size of the component ('small' | 'medium' | 'large' | 'fillParent').
+   */
+   size?: Size;
+   /**
+    * Value of the tabindex attribute.
+    */
+   tabIndex?: number;
+   /**
+    * Reference to the component.
+    */
+   ref?: React.RefObject<HTMLDivElement>;
+};
+
+export default function DxcNumber(props: Props): JSX.Element;

package/dist/password/Password.js

@@ -45,15 +45,17 @@ var DxcPassword = _react["default"].forwardRef(function (_ref, ref) {
       value = _ref.value,
       _ref$helperText = _ref.helperText,
       helperText = _ref$helperText === void 0 ? "" : _ref$helperText,
-      _ref$error = _ref.error,
-      error = _ref$error === void 0 ? "" : _ref$error,
       _ref$clearable = _ref.clearable,
       clearable = _ref$clearable === void 0 ? false : _ref$clearable,
       onChange = _ref.onChange,
       onBlur = _ref.onBlur,
-      margin = _ref.margin,
+      _ref$error = _ref.error,
+      error = _ref$error === void 0 ? "" : _ref$error,
       pattern = _ref.pattern,
       length = _ref.length,
+      _ref$autocomplete = _ref.autocomplete,
+      autocomplete = _ref$autocomplete === void 0 ? "off" : _ref$autocomplete,
+      margin = _ref.margin,
       _ref$size = _ref.size,
       size = _ref$size === void 0 ? "medium" : _ref$size,
       _ref$tabIndex = _ref.tabIndex,
@@ -156,6 +158,7 @@ var DxcPassword = _react["default"].forwardRef(function (_ref, ref) {
     size: size,
     pattern: pattern,
     length: length,
+    autocomplete: autocomplete,
     tabIndex: tabIndex
   }));
 });
@@ -178,6 +181,7 @@ DxcPassword.propTypes = {
   clearable: _propTypes["default"].bool,
   onChange: _propTypes["default"].func,
   onBlur: _propTypes["default"].func,
+  autocomplete: _propTypes["default"].string,
   margin: _propTypes["default"].oneOfType([_propTypes["default"].shape({
     top: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),
     bottom: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),

package/dist/password/index.d.ts

@@ -0,0 +1,94 @@
+type Size = "small" | "medium" | "large" | "fillParent";
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+  top?: Space;
+  bottom?: Space;
+  left?: Space;
+  right?: Space;
+};
+
+type Props = {
+  /**
+   * Text to be placed above the password.
+   */
+  label?: string;
+  /**
+   * Name attribute of the input element.
+   */
+  name?: string;
+  /**
+   * Value of the input element. If undefined, the component will be uncontrolled and the value will be managed internally by the component.
+   */
+  value?: string;
+  /**
+   * Helper text to be placed above the password.
+   */
+  helperText?: string;
+  /**
+   * If true, the password will have an action to clear the entered value.
+   */
+  clearable?: boolean;
+  /**
+   * 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?: (val: { value: string; error: string }) => void;
+  /**
+   * 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?: (val: { value: string; error: string }) => void;
+  /**
+   * If it is defined, the component will change its appearance, showing
+   * the error below the password component. 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
+   * password. 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 password.
+   * 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 };
+  /**
+   * HTML autocomplete attribute. Lets the user specify if any permission the user agent has to provide automated assistance in filling out the input 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').
+   * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
+   */
+  margin?: Space | Margin;
+  /**
+   * Size of the component ('small' | 'medium' | 'large' | 'fillParent').
+   */
+  size?: Size;
+  /**
+   * Value of the tabindex attribute.
+   */
+  tabIndex?: number;
+  /**
+   * Reference to the component.
+   */
+  ref?: React.RefObject<HTMLDivElement>;
+};
+
+export default function DxcPassword(props: Props): JSX.Element;