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

package/dist/select/index.d.ts

@@ -0,0 +1,131 @@
+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 of the group to be shown in the select's listbox.
+   */
+  label: string;
+  /**
+   * List of the grouped options.
+   */
+  options: Option[];
+};
+type Option = {
+  /**
+   * 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').
+   * 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 DxcSelect(props: Props): JSX.Element;

package/dist/sidenav/Sidenav.js

@@ -13,9 +13,7 @@ var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers
 
 var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
 
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-
-var _react = _interopRequireWildcard(require("react"));
+var _react = _interopRequireDefault(require("react"));
 
 var _styledComponents = _interopRequireWildcard(require("styled-components"));
 
@@ -23,24 +21,12 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 
 var _variables = require("../common/variables.js");
 
-require("../common/OpenSans.css");
-
-var _arrow_icon = _interopRequireDefault(require("./arrow_icon.svg"));
-
-var _ThemeContext = _interopRequireDefault(require("../ThemeContext.js"));
-
-function _templateObject5() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  box-sizing: border-box;\n  flex-grow: 1;\n  height: 100%;\n  padding: ", ";\n  margin-left: ", ";\n  transition: margin 0.4s ease-in-out;\n  width: ", ";\n"]);
-
-  _templateObject5 = function _templateObject5() {
-    return data;
-  };
+var _useTheme = _interopRequireDefault(require("../useTheme.js"));
 
-  return data;
-}
+var _BackgroundColorContext = require("../BackgroundColorContext.js");
 
 function _templateObject4() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  width: 18px;\n  height: 18px;\n  margin-left: ", ";\n  transition: margin 0.4s ease-in;\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  color: ", ";\n  letter-spacing: ", ";\n  text-transform: ", ";\n  text-decoration: ", ";\n  margin: ", ";\n  cursor: pointer;\n\n  :focus-visible {\n    outline: 2px solid ", ";\n    outline-offset: 1px;\n  }\n"]);
 
   _templateObject4 = function _templateObject4() {
     return data;
@@ -50,7 +36,7 @@ function _templateObject4() {
 }
 
 function _templateObject3() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  position: absolute;\n  left: ", ";\n  top: ", ";\n  width: 42px;\n  min-height: 42px;\n  background-color: ", ";\n  border-radius: 50%;\n  transform: ", ";\n  transition: transform 0.4s ease-in-out;\n  cursor: pointer;\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  color: ", ";\n  letter-spacing: ", ";\n  text-transform: ", ";\n  margin-bottom: 4px;\n"]);
 
   _templateObject3 = function _templateObject3() {
     return data;
@@ -60,7 +46,7 @@ function _templateObject3() {
 }
 
 function _templateObject2() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-direction: column;\n\n  background-color: #f8f8f8;\n\n  width: ", ";\n  box-sizing: border-box;\n  padding: ", ";\n  z-index: ", ";\n  transform: ", ";\n  transition: transform 0.4s ease-in-out;\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  color: ", ";\n  letter-spacing: ", ";\n  text-transform: ", ";\n  margin-bottom: 16px;\n"]);
 
   _templateObject2 = function _templateObject2() {
     return data;
@@ -70,7 +56,7 @@ function _templateObject2() {
 }
 
 function _templateObject() {
-  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  position: relative;\n"]);
+  var data = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-direction: column;\n  background-color: ", ";\n  max-width: 300px;\n  width: ", ";\n  padding: ", ";\n\n  overflow-y: auto;\n  overflow-x: hidden;\n  ::-webkit-scrollbar {\n    width: 2px;\n  }\n  ::-webkit-scrollbar-track {\n    background-color: ", ";\n    border-radius: 3px;\n  }\n  ::-webkit-scrollbar-thumb {\n    background-color: ", ";\n    border-radius: 3px;\n  }\n"]);
 
   _templateObject = function _templateObject() {
     return data;
@@ -80,138 +66,114 @@ function _templateObject() {
 }
 
 var DxcSidenav = function DxcSidenav(_ref) {
-  var navContent = _ref.navContent,
-      pageContent = _ref.pageContent,
-      padding = _ref.padding,
-      mode = _ref.mode,
-      arrowDistance = _ref.arrowDistance,
-      _ref$displayArrow = _ref.displayArrow,
-      displayArrow = _ref$displayArrow === void 0 ? true : _ref$displayArrow;
-  var ref = (0, _react.useRef)(null);
-
-  var _useState = (0, _react.useState)(),
-      _useState2 = (0, _slicedToArray2["default"])(_useState, 2),
-      sidenavSize = _useState2[0],
-      setSidenavSize = _useState2[1];
-
-  var _useState3 = (0, _react.useState)(),
-      _useState4 = (0, _slicedToArray2["default"])(_useState3, 2),
-      isShown = _useState4[0],
-      setIsShown = _useState4[1];
-
-  var _useState5 = (0, _react.useState)(),
-      _useState6 = (0, _slicedToArray2["default"])(_useState5, 2),
-      isResponsive = _useState6[0],
-      setIsResponsive = _useState6[1];
-
-  var colorsTheme = (0, _react.useContext)(_ThemeContext["default"]) || _variables.colors;
-
-  var handleVisbility = function handleVisbility(width) {
-    setIsShown(width <= _variables.responsiveSizes.tablet ? false : true);
-  };
-
-  var handleResize = function handleResize(width) {
-    if (width) {
-      setSidenavSize(width);
-      if (width <= _variables.responsiveSizes.tablet ? setIsResponsive(true) : setIsResponsive(false)) ;
-    }
-  };
-
-  var handleEventListener = function handleEventListener() {
-    handleResize(ref.current.offsetWidth);
-  };
-
-  (0, _react.useEffect)(function () {
-    if (ref.current) {
-      window.addEventListener("resize", handleEventListener);
-      handleResize(ref.current.offsetWidth);
-      handleVisbility(ref.current.offsetWidth);
-    }
-
-    return function () {
-      window.removeEventListener("resize", handleEventListener);
-    };
-  }, []);
+  var padding = _ref.padding,
+      children = _ref.children;
+  var colorsTheme = (0, _useTheme["default"])();
+  return _react["default"].createElement(_styledComponents.ThemeProvider, {
+    theme: colorsTheme.sidenav
+  }, _react["default"].createElement(SideNavContainer, {
+    padding: padding
+  }, _react["default"].createElement(_BackgroundColorContext.BackgroundColorProvider, {
+    color: colorsTheme.sidenav.backgroundColor
+  }, children)));
+};
 
-  var handleSidenav = function handleSidenav() {
-    setIsShown(!isShown);
-  };
+var Title = function Title(_ref2) {
+  var children = _ref2.children;
+  return _react["default"].createElement(SideNavMenuTitle, null, children);
+};
 
-  return _react["default"].createElement(_styledComponents.ThemeProvider, {
-    theme: colorsTheme
-  }, _react["default"].createElement(SidenavComponent, {
-    ref: ref
-  }, ref.current && _react["default"].createElement(_react["default"].Fragment, null, _react["default"].createElement(Sidenav, {
-    navContent: navContent,
-    isShown: isShown,
-    padding: padding,
-    mode: isResponsive ? "overlay" : mode,
-    sidenavSize: sidenavSize,
-    isResponsive: isResponsive
-  }, navContent, (displayArrow || isResponsive) && _react["default"].createElement(ArrowTrigger, {
-    onClick: handleSidenav,
-    isShown: isShown,
-    sidenavSize: sidenavSize,
-    arrowDistance: arrowDistance
-  }, _react["default"].createElement(ArrowImage, {
-    src: _arrow_icon["default"],
-    isShown: isShown
-  }))), _react["default"].createElement(PageContent, {
-    pageContent: pageContent,
-    padding: padding,
-    isShown: isShown,
-    mode: isResponsive ? "overlay" : mode,
-    sidenavSize: sidenavSize,
-    isResponsive: isResponsive
-  }, pageContent))));
+var Subtitle = function Subtitle(_ref3) {
+  var children = _ref3.children;
+  return _react["default"].createElement(SideNavMenuSubTitle, null, children);
 };
 
-var SidenavComponent = _styledComponents["default"].div(_templateObject());
+var Link = function Link(_ref4) {
+  var href = _ref4.href,
+      onClick = _ref4.onClick,
+      children = _ref4.children;
+  return _react["default"].createElement(SideNavMenuLink, {
+    href: href,
+    onClick: onClick
+  }, children);
+};
 
-var Sidenav = _styledComponents["default"].div(_templateObject2(), function (props) {
-  return props.sidenavSize <= _variables.responsiveSizes.tablet ? "60%" : "300px";
+var SideNavContainer = _styledComponents["default"].div(_templateObject(), function (props) {
+  return props.theme.backgroundColor;
+}, function (props) {
+  return props.padding ? "calc(300px - ".concat(_variables.spaces[props.padding], " - ").concat(_variables.spaces[props.padding], ")") : "300px";
 }, function (props) {
   return props.padding ? _variables.spaces[props.padding] : "";
 }, function (props) {
-  return props.mode === "overlay" ? "400" : "auto";
+  return props.theme.scrollBarTrackColor;
 }, function (props) {
-  return props.isShown ? "translateX(0)" : !props.isShown ? "translateX(-100%)" : "";
+  return props.theme.scrollBarThumbColor;
 });
 
-var ArrowTrigger = _styledComponents["default"].div(_templateObject3(), function (props) {
-  return props.sidenavSize <= _variables.responsiveSizes.tablet ? "calc(100% - 21px)" : "279px";
+var SideNavMenuTitle = _styledComponents["default"].div(_templateObject2(), function (props) {
+  return props.theme.titleFontFamily;
+}, function (props) {
+  return props.theme.titleFontSize;
+}, function (props) {
+  return props.theme.titleFontStyle;
 }, function (props) {
-  return props.arrowDistance ? props.arrowDistance : "calc(50% - 21px)";
+  return props.theme.titleFontWeight;
 }, function (props) {
-  return props.theme.lighterGrey;
+  return props.theme.titleFontColor;
 }, function (props) {
-  return props.isShown ? "rotate(-180deg)" : "rotate(0deg)";
+  return props.theme.titleFontLetterSpacing;
+}, function (props) {
+  return props.theme.titleFontTextTransform;
 });
 
-var ArrowImage = _styledComponents["default"].img(_templateObject4(), function (props) {
-  return props.isShown ? "0" : "10px";
+var SideNavMenuSubTitle = _styledComponents["default"].div(_templateObject3(), function (props) {
+  return props.theme.subtitleFontFamily;
+}, function (props) {
+  return props.theme.subtitleFontSize;
+}, function (props) {
+  return props.theme.subtitleFontStyle;
+}, function (props) {
+  return props.theme.subtitleFontWeight;
+}, function (props) {
+  return props.theme.subtitleFontColor;
+}, function (props) {
+  return props.theme.subtitleFontLetterSpacing;
+}, function (props) {
+  return props.theme.subtitleFontTextTransform;
 });
 
-var PageContent = _styledComponents["default"].div(_templateObject5(), function (props) {
-  return props.padding ? _variables.spaces[props.padding] : "";
+var SideNavMenuLink = _styledComponents["default"].a(_templateObject4(), function (props) {
+  return props.theme.linkFontFamily;
+}, function (props) {
+  return props.theme.linkFontSize;
+}, function (props) {
+  return props.theme.linkFontStyle;
+}, function (props) {
+  return props.theme.linkFontWeight;
+}, function (props) {
+  return props.theme.linkFontColor;
+}, function (props) {
+  return props.theme.linkFontLetterSpacing;
+}, function (props) {
+  return props.theme.linkFontTextTransform;
+}, function (props) {
+  return props.theme.linkTextDecoration;
 }, function (props) {
-  return props.isShown && props.mode === "push" && !props.isResponsive ? "" : !props.isResponsive ? "-300px" : "-60%";
+  return "".concat(props.theme.linkMarginTop, " ").concat(props.theme.linkMarginRight, " ").concat(props.theme.linkMarginBottom, " ").concat(props.theme.linkMarginLeft);
 }, function (props) {
-  return props.isShown && props.mode === "push" ? "calc(100% - 300px)" : "calc(100%)";
+  return props.theme.linkFocusColor;
 });
 
 DxcSidenav.propTypes = {
-  mode: _propTypes["default"].oneOf(["overlay", "push", ""]),
   padding: _propTypes["default"].oneOfType([_propTypes["default"].shape({
     top: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),
     bottom: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),
     left: _propTypes["default"].oneOf(Object.keys(_variables.spaces)),
     right: _propTypes["default"].oneOf(Object.keys(_variables.spaces))
-  }), _propTypes["default"].oneOf((0, _toConsumableArray2["default"])(Object.keys(_variables.spaces)))]),
-  navContent: _propTypes["default"].object,
-  pageContent: _propTypes["default"].object,
-  arrowDistance: _propTypes["default"].string,
-  displayArrow: _propTypes["default"].bool
+  }), _propTypes["default"].oneOf((0, _toConsumableArray2["default"])(Object.keys(_variables.spaces)))])
 };
+DxcSidenav.Title = Title;
+DxcSidenav.Subtitle = Subtitle;
+DxcSidenav.Link = Link;
 var _default = DxcSidenav;
 exports["default"] = _default;

package/dist/sidenav/index.d.ts

@@ -0,0 +1,13 @@
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Padding = {
+  top?: Space;
+  bottom?: Space;
+  left?: Space;
+  right?: Space;
+};
+
+type Props = {
+  padding?: Space | Padding;
+};
+
+export default function DxcSidenav(props: Props): JSX.Element;