@dxc-technology/halstack-react 0.0.0-e961efe → 0.0.0-ebb089f

package/dist/button/Button.stories.js

@@ -0,0 +1,27 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Primary = exports["default"] = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _Button = _interopRequireDefault(require("./Button"));
+
+var _default = {
+  title: "Button",
+  component: _Button["default"]
+};
+exports["default"] = _default;
+
+var Primary = function Primary() {
+  return _react["default"].createElement(_Button["default"], {
+    mode: "primary",
+    label: "Primary Button"
+  });
+};
+
+exports.Primary = Primary;

package/dist/select/Select.js

@@ -62,7 +62,7 @@ function _templateObject26() {
 }
 
 function _templateObject25() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  height: 24px;\n  width: 24px;\n  margin-left: 8px;\n  color: ", ";\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  height: 24px;\n  width: 24px;\n  ", "\n  color: ", ";\n"]);
 
   _templateObject25 = function _templateObject25() {
     return data;
@@ -72,7 +72,7 @@ function _templateObject25() {
 }
 
 function _templateObject24() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  justify-content: space-between;\n  width: 100%;\n  overflow: hidden;\n  padding-left: 8px;\n  ", "\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  justify-content: space-between;\n  width: 100%;\n  overflow: hidden;\n  ", "\n"]);
 
   _templateObject24 = function _templateObject24() {
     return data;
@@ -232,7 +232,7 @@ function _templateObject9() {
 }
 
 function _templateObject8() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  height: 24px;\n  width: 24px;\n  font-size: 1rem;\n  font-family: ", ";\n  border: 1px solid transparent;\n  padding: 3px;\n  ", "\n  background-color: ", ";\n  color: ", ";\n\n  ", "\n\n  svg {\n    line-height: 18px;\n  }\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  height: 24px;\n  width: 24px;\n  font-size: 1rem;\n  font-family: ", ";\n  border: 1px solid transparent;\n  padding: 3px;\n  ", "\n  background-color: ", ";\n  color: ", ";\n\n  :focus-visible {\n    outline: none;\n  }\n  ", "\n\n  svg {\n    line-height: 18px;\n  }\n"]);
 
   _templateObject8 = function _templateObject8() {
     return data;
@@ -313,6 +313,7 @@ function _templateObject() {
 
 var selectIcons = {
   error: _react["default"].createElement("svg", {
+    role: "img",
     xmlns: "http://www.w3.org/2000/svg",
     height: "24px",
     viewBox: "0 0 24 24",
@@ -322,6 +323,7 @@ var selectIcons = {
     d: "M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-2h2v2zm0-4h-2V7h2v6z"
   })),
   arrowUp: _react["default"].createElement("svg", {
+    role: "img",
     xmlns: "http://www.w3.org/2000/svg",
     height: "24px",
     viewBox: "0 0 24 24",
@@ -334,6 +336,7 @@ var selectIcons = {
     d: "M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6 1.41 1.41z"
   })),
   arrowDown: _react["default"].createElement("svg", {
+    role: "img",
     xmlns: "http://www.w3.org/2000/svg",
     height: "24px",
     viewBox: "0 0 24 24",
@@ -346,6 +349,7 @@ var selectIcons = {
     d: "M7.41 8.59L12 13.17l4.59-4.58L18 10l-6 6-6-6 1.41-1.41z"
   })),
   clear: _react["default"].createElement("svg", {
+    role: "img",
     xmlns: "http://www.w3.org/2000/svg",
     width: "24",
     height: "24",
@@ -358,6 +362,7 @@ var selectIcons = {
     d: "M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"
   })),
   selected: _react["default"].createElement("svg", {
+    role: "img",
     xmlns: "http://www.w3.org/2000/svg",
     height: "24px",
     viewBox: "0 0 24 24",
@@ -370,6 +375,7 @@ var selectIcons = {
     d: "M9 16.2L4.8 12l-1.4 1.4L9 19 21 7l-1.4-1.4L9 16.2z"
   })),
   searchOff: _react["default"].createElement("svg", {
+    role: "img",
     xmlns: "http://www.w3.org/2000/svg",
     height: "24px",
     viewBox: "0 0 24 24",
@@ -468,13 +474,83 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
   var selectSearchInputRef = (0, _react.useRef)(null);
   var selectOptionsListRef = (0, _react.useRef)(null);
   var colorsTheme = (0, _useTheme["default"])();
-  var filteredOptions = (0, _react.useMemo)(function () {
-    return filterOptionsBySearchValue(options, searchValue);
-  }, [options, searchValue]);
   var optionalEmptyOption = {
     label: placeholder,
     value: ""
   };
+  var filteredOptions = (0, _react.useMemo)(function () {
+    return filterOptionsBySearchValue(options, searchValue);
+  }, [options, searchValue]);
+
+  var getLastOptionIndex = function getLastOptionIndex() {
+    var last = 0;
+
+    var reducer = function reducer(acc, current) {
+      var _current$options;
+
+      return acc + ((_current$options = current.options) === null || _current$options === void 0 ? void 0 : _current$options.length);
+    };
+
+    if (searchable && filteredOptions.length > 0) filteredOptions[0].options ? last = filteredOptions.reduce(reducer, 0) - 1 : last = filteredOptions.length - 1;else if ((options === null || options === void 0 ? void 0 : options.length) > 0) options[0].options ? last = options.reduce(reducer, 0) - 1 : last = options.length - 1;
+    return optional && !multiple ? last + 1 : last;
+  };
+
+  var lastOptionIndex = (0, _react.useMemo)(function () {
+    return getLastOptionIndex();
+  }, [searchable, optional, multiple, filteredOptions, options]);
+
+  var getSelectedOption = function getSelectedOption() {
+    var val = value !== null && value !== void 0 ? value : innerValue;
+    var selectedOption = multiple ? [] : "";
+    var singleSelectionIndex;
+
+    if (multiple) {
+      if ((options === null || options === void 0 ? void 0 : options.length) > 0) {
+        options.forEach(function (option) {
+          if (option.options) {
+            option.options.forEach(function (singleOption) {
+              if (val.includes(singleOption.value)) selectedOption.push(singleOption);
+            });
+          } else if (val.includes(option.value)) selectedOption.push(option);
+        });
+      }
+    } else {
+      if (optional && val === "") {
+        selectedOption = optionalEmptyOption;
+        singleSelectionIndex = 0;
+      } else if ((options === null || options === void 0 ? void 0 : options.length) > 0) {
+        var group_index = 0;
+        options.some(function (option, index) {
+          if (option.options) {
+            option.options.some(function (singleOption) {
+              if (singleOption.value === val) {
+                selectedOption = singleOption;
+                singleSelectionIndex = optional ? group_index + 1 : group_index;
+                return true;
+              }
+
+              group_index++;
+            });
+          } else if (option.value === val) {
+            selectedOption = option;
+            singleSelectionIndex = optional ? index + 1 : index;
+            return true;
+          }
+        });
+      }
+    }
+
+    return {
+      selectedOption: selectedOption,
+      singleSelectionIndex: singleSelectionIndex
+    };
+  };
+
+  var _useMemo = (0, _react.useMemo)(function () {
+    return getSelectedOption();
+  }, [options, multiple, value, innerValue]),
+      selectedOption = _useMemo.selectedOption,
+      singleSelectionIndex = _useMemo.singleSelectionIndex;
 
   var notOptionalCheck = function notOptionalCheck(value) {
     return value === "" && !optional;
@@ -547,16 +623,16 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
   };
 
   var handleSelectOnClick = function handleSelectOnClick() {
+    searchable && selectSearchInputRef.current.focus();
+
     if (isOpen) {
       closeOptions();
       setSearchValue("");
     } else openOptions();
-
-    searchable && selectSearchInputRef.current.focus();
   };
 
-  var handleSelectOnFocus = function handleSelectOnFocus() {
-    searchable && selectSearchInputRef.current.focus();
+  var handleSelectOnFocus = function handleSelectOnFocus(event) {
+    if (!event.currentTarget.contains(event.relatedTarget)) searchable && selectSearchInputRef.current.focus();
   };
 
   var handleSelectOnBlur = function handleSelectOnBlur(event) {
@@ -579,7 +655,7 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
       case 40:
         // Arrow Down
         event.preventDefault();
-        changeVisualFocusIndex(function (visualFocusIndex) {
+        singleSelectionIndex !== undefined && (!isOpen || visualFocusIndex === -1 && singleSelectionIndex > -1 && singleSelectionIndex <= lastOptionIndex) ? changeVisualFocusIndex(singleSelectionIndex) : changeVisualFocusIndex(function (visualFocusIndex) {
           if (visualFocusIndex < lastOptionIndex) return visualFocusIndex + 1;else if (visualFocusIndex === lastOptionIndex) return 0;
         });
         openOptions();
@@ -588,7 +664,7 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
       case 38:
         // Arrow Up
         event.preventDefault();
-        changeVisualFocusIndex(function (visualFocusIndex) {
+        singleSelectionIndex !== undefined && (!isOpen || visualFocusIndex === -1 && singleSelectionIndex > -1 && singleSelectionIndex <= lastOptionIndex) ? changeVisualFocusIndex(singleSelectionIndex) : changeVisualFocusIndex(function (visualFocusIndex) {
           return visualFocusIndex === 0 || visualFocusIndex === -1 ? lastOptionIndex : visualFocusIndex - 1;
         });
         openOptions();
@@ -638,11 +714,6 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
     openOptions();
   };
 
-  var handleClearActionOnClick = function handleClearActionOnClick(event) {
-    event.stopPropagation();
-    setSearchValue("");
-  };
-
   var handleClearOptionsActionOnClick = function handleClearOptionsActionOnClick(event) {
     event.stopPropagation();
     value !== null && value !== void 0 ? value : setInnerValue([]);
@@ -650,76 +721,33 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
       value: [],
       error: getNotOptionalErrorMessage()
     });
-    selectContainerRef.current.focus();
   };
 
-  var getLastOptionIndex = function getLastOptionIndex() {
-    var last = 0;
-
-    var reducer = function reducer(acc, current) {
-      var _current$options;
-
-      return acc + ((_current$options = current.options) === null || _current$options === void 0 ? void 0 : _current$options.length);
-    };
-
-    if (searchable && filteredOptions.length > 0) filteredOptions[0].options ? last = filteredOptions.reduce(reducer, 0) - 1 : last = filteredOptions.length - 1;else if ((options === null || options === void 0 ? void 0 : options.length) > 0) options[0].options ? last = options.reduce(reducer, 0) - 1 : last = options.length - 1;
-    return optional && !multiple ? last + 1 : last;
+  var handleClearSearchActionOnClick = function handleClearSearchActionOnClick(event) {
+    event.stopPropagation();
+    setSearchValue("");
   };
 
-  var lastOptionIndex = (0, _react.useMemo)(function () {
-    return getLastOptionIndex();
-  }, [searchable, optional, multiple, searchable ? filteredOptions : options]);
-
-  var getSelectedOption = function getSelectedOption() {
-    var val = value !== null && value !== void 0 ? value : innerValue;
-    var selectedOption = multiple ? [] : "";
+  (0, _react.useLayoutEffect)(function () {
+    if (isOpen && singleSelectionIndex) {
+      var _listEl$scrollTo;
 
-    if (multiple) {
-      if ((options === null || options === void 0 ? void 0 : options.length) > 0) {
-        options.forEach(function (option) {
-          if (option.options) {
-            option.options.forEach(function (singleOption) {
-              if (val.includes(singleOption.value)) selectedOption.push(singleOption);
-            });
-          } else if (val.includes(option.value)) selectedOption.push(option);
-        });
-      }
-    } else {
-      if ((options === null || options === void 0 ? void 0 : options.length) > 0) {
-        options.forEach(function (option) {
-          if (option.options) {
-            option.options.forEach(function (singleOption) {
-              if (singleOption.value === val) selectedOption = singleOption;
-            });
-          } else if (option.value === val) selectedOption = option;
-        });
-      }
+      var listEl = selectOptionsListRef === null || selectOptionsListRef === void 0 ? void 0 : selectOptionsListRef.current;
+      var selectedListOptionEl = listEl === null || listEl === void 0 ? void 0 : listEl.querySelector("[aria-selected='true']");
+      listEl === null || listEl === void 0 ? void 0 : (_listEl$scrollTo = listEl.scrollTo) === null || _listEl$scrollTo === void 0 ? void 0 : _listEl$scrollTo.call(listEl, {
+        top: (selectedListOptionEl === null || selectedListOptionEl === void 0 ? void 0 : selectedListOptionEl.offsetTop) - (listEl === null || listEl === void 0 ? void 0 : listEl.clientHeight) / 2
+      });
     }
-
-    return selectedOption;
-  };
-
-  var selectedOption = (0, _react.useMemo)(function () {
-    return getSelectedOption();
-  }, [options, multiple, value !== null && value !== void 0 ? value : innerValue]);
+  }, [isOpen]);
   (0, _react.useLayoutEffect)(function () {
-    var _selectOptionsListRef;
+    var _selectOptionsListRef, _visualFocusedOptionE;
 
     var visualFocusedOptionEl = selectOptionsListRef === null || selectOptionsListRef === void 0 ? void 0 : (_selectOptionsListRef = selectOptionsListRef.current) === null || _selectOptionsListRef === void 0 ? void 0 : _selectOptionsListRef.querySelectorAll("[role='option']")[visualFocusIndex];
-    visualFocusedOptionEl === null || visualFocusedOptionEl === void 0 ? void 0 : visualFocusedOptionEl.scrollIntoView({
+    visualFocusedOptionEl === null || visualFocusedOptionEl === void 0 ? void 0 : (_visualFocusedOptionE = visualFocusedOptionEl.scrollIntoView) === null || _visualFocusedOptionE === void 0 ? void 0 : _visualFocusedOptionE.call(visualFocusedOptionEl, {
       block: "nearest",
       inline: "start"
     });
   }, [visualFocusIndex]);
-  (0, _react.useLayoutEffect)(function () {
-    if (isOpen && !multiple) {
-      var listEl = selectOptionsListRef === null || selectOptionsListRef === void 0 ? void 0 : selectOptionsListRef.current;
-      var selectedListOptionEl = listEl === null || listEl === void 0 ? void 0 : listEl.querySelector("[aria-selected='true']");
-      listEl === null || listEl === void 0 ? void 0 : listEl.scrollTo({
-        top: (selectedListOptionEl === null || selectedListOptionEl === void 0 ? void 0 : selectedListOptionEl.offsetTop) - (listEl === null || listEl === void 0 ? void 0 : listEl.clientHeight) / 2
-      });
-    }
-  }, [isOpen]);
 
   var Option = function Option(_ref2) {
     var option = _ref2.option,
@@ -730,7 +758,7 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
     var isLastOption = index === lastOptionIndex;
     return _react["default"].createElement(OptionItem, {
       id: "option-".concat(index),
-      onClick: function onClick(event) {
+      onClick: function onClick() {
         // left mouse button only
         handleSelectChangeValue(option);
         !multiple && closeOptions();
@@ -750,7 +778,9 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
       tabIndex: -1,
       checked: isSelected
     }), option.icon && _react["default"].createElement(OptionIcon, {
-      selected: isSelected
+      grouped: isGroupedOption,
+      multiple: multiple,
+      role: !(typeof option.icon === "string") && "img"
     }, typeof option.icon === "string" ? _react["default"].createElement(OptionIconImg, {
       src: option.icon
     }) : option.icon), _react["default"].createElement(OptionContent, {
@@ -760,7 +790,7 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
     }, _react["default"].createElement(OptionLabel, null, option.label), !multiple && isSelected && _react["default"].createElement(OptionSelectedIndicator, null, selectIcons.selected))));
   };
 
-  var global_index = optional && !multiple ? 0 : -1; // index for options (not groups), starting from 0 to options.length -1
+  var global_index = optional && !multiple ? 0 : -1; // index for options, starting from 0 to options.length -1
 
   var mapOptionFunc = function mapOptionFunc(option) {
     if (option.options) {
@@ -814,13 +844,17 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
     "aria-expanded": isOpen ? "true" : "false",
     "aria-haspopup": "listbox",
     "aria-labelledby": selectLabelId,
-    "aria-activedescendant": visualFocusIndex >= 0 && "option-".concat(visualFocusIndex),
+    "aria-activedescendant": visualFocusIndex >= 0 ? "option-".concat(visualFocusIndex) : undefined,
     "aria-invalid": error ? "true" : "false",
     "aria-required": optional ? "false" : "true"
   }, multiple && selectedOption.length > 0 && _react["default"].createElement(SelectionIndicator, null, _react["default"].createElement(SelectionNumber, {
     disabled: disabled
   }, selectedOption.length, " "), _react["default"].createElement(ClearOptionsAction, {
     disabled: disabled,
+    onMouseDown: function onMouseDown(event) {
+      // Avoid input to lose focus when pressed
+      event.preventDefault();
+    },
     onClick: handleClearOptionsActionOnClick,
     tabIndex: -1,
     title: "Clear selected options",
@@ -828,7 +862,8 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
   }, selectIcons.clear)), _react["default"].createElement(SearchableValueContainer, null, _react["default"].createElement(ValueInput, {
     name: name,
     value: multiple ? (value !== null && value !== void 0 ? value : innerValue).join(", ") : value !== null && value !== void 0 ? value : innerValue,
-    readOnly: true
+    readOnly: true,
+    "aria-hidden": "true"
   }), searchable && _react["default"].createElement(SearchInput, {
     value: searchValue,
     disabled: disabled,
@@ -844,8 +879,12 @@ var DxcSelect = _react["default"].forwardRef(function (_ref, ref) {
   }).join(", ")), selectedOption.length === 0 && placeholder) : _react["default"].createElement(SelectedOption, {
     disabled: disabled,
     atBackground: !(value !== null && value !== void 0 ? value : innerValue) || isOpen
-  }, _react["default"].createElement(OptionLabel, null, (_ref3 = selectedOption === null || selectedOption === void 0 ? void 0 : selectedOption.label) !== null && _ref3 !== void 0 ? _ref3 : placeholder)))), !disabled && error && _react["default"].createElement(ErrorIcon, null, selectIcons.error), searchable && searchValue.length > 0 && _react["default"].createElement(ClearAction, {
-    onClick: handleClearActionOnClick,
+  }, _react["default"].createElement(OptionLabel, null, (_ref3 = selectedOption === null || selectedOption === void 0 ? void 0 : selectedOption.label) !== null && _ref3 !== void 0 ? _ref3 : placeholder)))), !disabled && error && _react["default"].createElement(ErrorIcon, null, selectIcons.error), searchable && searchValue.length > 0 && _react["default"].createElement(ClearSearchAction, {
+    onMouseDown: function onMouseDown(event) {
+      // Avoid input to lose focus
+      event.preventDefault();
+    },
+    onClick: handleClearSearchActionOnClick,
     tabIndex: -1,
     title: "Clear search text",
     "aria-label": "Clear search text"
@@ -1020,7 +1059,7 @@ var CollapseIndicator = _styledComponents["default"].span(_templateObject15(), f
   return props.disabled ? props.theme.disabledColor : props.theme.collapseIndicatorColor;
 });
 
-var ClearAction = _styledComponents["default"].button(_templateObject16(), function (props) {
+var ClearSearchAction = _styledComponents["default"].button(_templateObject16(), function (props) {
   return props.theme.fontFamily;
 }, function (props) {
   return props.disabled ? "cursor: not-allowed;" : "cursor: pointer;";
@@ -1077,10 +1116,12 @@ var StyledOption = _styledComponents["default"].span(_templateObject23(), functi
 });
 
 var OptionContent = _styledComponents["default"].span(_templateObject24(), function (props) {
-  return props.grouped && !props.multiple && !props.hasIcon && "padding-left: 16px;";
+  return props.grouped && !props.multiple && !props.hasIcon ? "padding-left: 16px;" : "padding-left: 8px;";
 });
 
 var OptionIcon = _styledComponents["default"].span(_templateObject25(), function (props) {
+  return props.grouped && !props.multiple ? "padding-left: 16px;" : "padding-left: 8px;";
+}, function (props) {
   return props.theme.listItemIconColor;
 });
 

package/dist/select/index.d.ts

@@ -8,28 +8,106 @@ type Margin = {
 };
 
 type OptionGroup = {
+  /**
+   * Label of the group to be shown in the select's listbox.
+   */
   label: string;
+  /**
+   * List of the grouped options.
+   */
   options: Option[];
 };
 type Option = {
-  icon?: string | SVG;
+  /**
+   * Element used as the icon that will be placed before the option label. 
+   * It can be a url of an image or an inline SVG. If the url option 
+   * is the chosen one, take into account that the component's 
+   * color styling tokens will not be applied to the image.
+   */
+  icon?: SVG;
+  /**
+   * Label of the option to be shown in the select's listbox.
+   */
   label: string;
+  /**
+   * Value of the option. It should be unique and
+   * not an empty string, which is reserved to the empty option added
+   * by optional prop.
+   */
   value: string;
 };
 
 type Props = {
+  /**
+   * Text to be placed above the select.
+   */
   label?: string;
+  /**
+   * Name attribute of the input element. This attribute will allow users
+   * to find the component's value during the submit event. In this event,
+   * the component's value will always be a regular string, for both single
+   * and multiple selection modes, been in the first one a single option
+   * value and in the multiple variant more than one option value,
+   * separated by commas.
+   */
   name?: string;
+  /**
+   * Value of the select. If undefined, the component will be uncontrolled
+   * and the value will be managed internally by the component.
+   */
   value?: string | string[];
+  /**
+   * An array of objects representing the selectable options.
+   */
   options?: Option[] | OptionGroup[];
+  /**
+   * Helper text to be placed above the select.
+   */
   helperText?: string;
+  /**
+   * Text to be put as placeholder of the select.
+   */
   placeholder?: string;
+  /**
+   * If true, the component will be disabled.
+   */
   disabled?: boolean;
+  /**
+   * If true, the select will be optional, showing '(Optional)'
+   * next to the label and adding a default first option with empty value, been
+   * the placeholder (if defined) its label. Otherwise, the field will be
+   * considered required and an error will be passed as a parameter to the
+   * OnBlur and onChange functions if an option wasn't selected.
+   */
   optional?: boolean;
+  /**
+   * If true, enables search functionality.
+   */
   searchable?: boolean;
+  /**
+   * If true, the select component will support multiple selected options.
+   * In that case, value will be an array of strings with each selected
+   * option value.
+   */
   multiple?: boolean;
+  /**
+   * This function will be called when the user selects an option.
+   * 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 | string[]) => void;
+  /**
+   * This function will be called when the select loses the focus. An
+   * object including the value (or values) and the error (if the value
+   * selected is not valid) will be passed to this function. If there is no error,
+   * error will be null.
+   */
   onBlur?: (val: { value: string | string[]; error: string }) => void;
+  /**
+   * If it is defined, the component will change its appearance, showing
+   * the error below the select component. If it is not defined, the error
+   * messages will be managed internally, but never displayed on its own.
+   */
   error?: string;
   /**
    * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').

package/dist/text-input/TextInput.js

@@ -715,7 +715,7 @@ var DxcTextInput = _react["default"].forwardRef(function (_ref, ref) {
     tabIndex: tabIndex,
     role: isTextInputType() && hasInputSuggestions() ? "combobox" : "textbox",
     "aria-autocomplete": isTextInputType() && hasInputSuggestions() ? "list" : undefined,
-    "aria-controls": isTextInputType() && hasInputSuggestions() ? inputId : undefined,
+    "aria-controls": isTextInputType() && hasInputSuggestions() ? autosuggestId : undefined,
     "aria-expanded": isTextInputType() && hasInputSuggestions() ? isOpen ? "true" : "false" : undefined,
     "aria-activedescendant": isTextInputType() && hasInputSuggestions() && isOpen && visualFocusedSuggIndex !== -1 ? "suggestion-".concat(visualFocusedSuggIndex) : undefined,
     "aria-invalid": error ? "true" : "false",
@@ -877,7 +877,7 @@ var Action = _styledComponents["default"].button(_templateObject8(), function (p
 }, function (props) {
   return props.disabled ? props.backgroundType === "dark" ? props.theme.disabledActionIconColorOnDark : props.theme.disabledActionIconColor : props.backgroundType === "dark" ? props.theme.actionIconColorOnDark : props.theme.actionIconColor;
 }, function (props) {
-  return !props.disabled && "\n      &:hover {\n        background-color: ".concat(props.backgroundType === "dark" ? props.theme.hoverActionBackgroundColorOnDark : props.theme.hoverActionBackgroundColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.hoverActionIconColorOnDark : props.theme.hoverActionIconColor, ";\n      }\n      &:focus {\n        outline: none;\n        box-shadow: 0 0 0 2px ").concat(props.backgroundType === "dark" ? props.theme.focusActionBorderColorOnDark : props.theme.focusActionBorderColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.focusActionIconColorOnDark : props.theme.focusActionIconColor, ";\n      }\n      &:focus-visible {\n        outline: none;\n        box-shadow: 0 0 0 2px ").concat(props.backgroundType === "dark" ? props.theme.focusActionBorderColorOnDark : props.theme.focusActionBorderColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.focusActionIconColorOnDark : props.theme.focusActionIconColor, ";\n      }\n      &:active {\n        background-color: ").concat(props.backgroundType === "dark" ? props.theme.activeActionBackgroundColorOnDark : props.theme.activeActionBackgroundColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.activeActionIconColorOnDark : props.theme.activeActionIconColor, ";\n      }\n    ");
+  return !props.disabled && "\n      &:focus {\n        outline: none;\n        box-shadow: 0 0 0 2px ".concat(props.backgroundType === "dark" ? props.theme.focusActionBorderColorOnDark : props.theme.focusActionBorderColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.focusActionIconColorOnDark : props.theme.focusActionIconColor, ";\n      }\n      &:focus-visible {\n        outline: none;\n        box-shadow: 0 0 0 2px ").concat(props.backgroundType === "dark" ? props.theme.focusActionBorderColorOnDark : props.theme.focusActionBorderColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.focusActionIconColorOnDark : props.theme.focusActionIconColor, ";\n      }\n      &:hover {\n        background-color: ").concat(props.backgroundType === "dark" ? props.theme.hoverActionBackgroundColorOnDark : props.theme.hoverActionBackgroundColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.hoverActionIconColorOnDark : props.theme.hoverActionIconColor, ";\n      }\n      &:active {\n        background-color: ").concat(props.backgroundType === "dark" ? props.theme.activeActionBackgroundColorOnDark : props.theme.activeActionBackgroundColor, ";\n        color: ").concat(props.backgroundType === "dark" ? props.theme.activeActionIconColorOnDark : props.theme.activeActionIconColor, ";\n      }\n    ");
 });
 
 var Prefix = _styledComponents["default"].span(_templateObject9(), function (props) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxc-technology/halstack-react",
-  "version": "0.0.0-e961efe",
+  "version": "0.0.0-ebb089f",
   "description": "DXC Halstack React components library",
   "repository": "dxc-technology/halstack-react",
   "homepage": "http://developer.dxc.com/tools/react",