@dxc-technology/halstack-react 0.0.0-9b341c0 → 0.0.0-9bd9511

package/select/types.d.ts

@@ -0,0 +1,210 @@
+import React from "react";
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+type SVG = React.ReactNode & React.SVGProps<SVGSVGElement>;
+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?: string | 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 CommonProps = {
+    /**
+     * 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;
+    /**
+     * 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 an empty string as 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 it is a defined value and also a truthy string, the component will
+     * change its appearance, showing the error below the select component.
+     * If the defined value is an empty string, it will reserve a space below
+     * the component for a future error, but it would not change its look. In
+     * case of being undefined or null, both the appearance and the space for
+     * the error message would not be modified.
+     */
+    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.
+     */
+    size?: "small" | "medium" | "large" | "fillParent";
+    /**
+     * Value of the tabindex attribute.
+     */
+    tabIndex?: number;
+};
+type SingleSelect = CommonProps & {
+    /**
+     * 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?: false;
+    /**
+     * Initial value of the select, only when it is uncontrolled.
+     */
+    defaultValue?: string;
+    /**
+     * Value of the select. If undefined, the component will be uncontrolled
+     * and the value will be managed internally by the component.
+     */
+    value?: string;
+    /**
+     * 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 not be defined.
+     */
+    onChange?: (val: {
+        value: string;
+        error?: string;
+    }) => void;
+    /**
+     * This function will be called when the select loses the focus. An
+     * object including the value and the error (if the value
+     * selected is not valid) will be passed to this function. If there is no error,
+     * error will not be defined.
+     */
+    onBlur?: (val: {
+        value: string;
+        error?: string;
+    }) => void;
+};
+type MultipleSelect = CommonProps & {
+    /**
+     * 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: true;
+    /**
+     * Initial value of the select, only when it is uncontrolled.
+     */
+    defaultValue?: string[];
+    /**
+     * Value of the select. If undefined, the component will be uncontrolled
+     * and the value will be managed internally by the component.
+     */
+    value?: string[];
+    /**
+     * This function will be called when the user selects an option.
+     * An object including the current selected values 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 select loses the focus. An
+     * object including the selected 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[];
+        error?: string;
+    }) => void;
+};
+type Props = SingleSelect | MultipleSelect;
+/**
+ * Single option of the select component.
+ */
+export type OptionProps = {
+    id: string;
+    option: Option;
+    onClick: (option: Option) => void;
+    multiple: boolean;
+    visualFocused: boolean;
+    isGroupedOption?: boolean;
+    isLastOption: boolean;
+    isSelected: boolean;
+};
+/**
+ * Listbox from the select component.
+ */
+export type ListboxProps = {
+    id: string;
+    currentValue: string | string[];
+    options: Option[] | OptionGroup[];
+    visualFocusIndex: number;
+    lastOptionIndex: number;
+    multiple: boolean;
+    optional: boolean;
+    optionalItem: Option;
+    searchable: boolean;
+    handleOptionOnClick: (option: Option) => void;
+    styles: React.CSSProperties;
+};
+/**
+ * Reference to the select component.
+ */
+export type RefType = HTMLDivElement;
+export default Props;

package/select/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/sidenav/Sidenav.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import SidenavPropsType, { SidenavGroupPropsType, SidenavLinkPropsType, SidenavSectionPropsType, SidenavTitlePropsType } from "./types.js";
+declare const DxcSidenav: {
+    ({ children, title }: SidenavPropsType): JSX.Element;
+    Section: ({ children }: SidenavSectionPropsType) => JSX.Element;
+    Group: ({ children, title, collapsable, icon }: SidenavGroupPropsType) => JSX.Element;
+    Link: React.ForwardRefExoticComponent<SidenavLinkPropsType & React.RefAttributes<HTMLAnchorElement>>;
+    Title: ({ children }: SidenavTitlePropsType) => JSX.Element;
+};
+export default DxcSidenav;

package/sidenav/Sidenav.js

@@ -0,0 +1,226 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _react = _interopRequireWildcard(require("react"));
+var _styledComponents = _interopRequireWildcard(require("styled-components"));
+var _variables = require("../common/variables");
+var _SidenavContext = require("../layout/SidenavContext");
+var _useTheme = _interopRequireDefault(require("../useTheme"));
+var _BackgroundColorContext = require("../BackgroundColorContext");
+var _Flex = _interopRequireDefault(require("../flex/Flex"));
+var _Bleed = _interopRequireDefault(require("../bleed/Bleed"));
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8;
+var _excluded = ["href", "children", "newWindow", "selected", "icon", "tabIndex", "onClick"];
+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); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(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 collapsedIcon = /*#__PURE__*/_react["default"].createElement("svg", {
+  xmlns: "http://www.w3.org/2000/svg",
+  height: "24px",
+  viewBox: "0 0 24 24",
+  width: "24px",
+  fill: "currentColor"
+}, /*#__PURE__*/_react["default"].createElement("path", {
+  d: "M0 0h24v24H0z",
+  fill: "none"
+}), /*#__PURE__*/_react["default"].createElement("path", {
+  d: "M16.59 8.59L12 13.17 7.41 8.59 6 10l6 6 6-6z"
+}));
+var collapsableIcon = /*#__PURE__*/_react["default"].createElement("svg", {
+  xmlns: "http://www.w3.org/2000/svg",
+  height: "24px",
+  viewBox: "0 0 24 24",
+  width: "24px",
+  fill: "currentColor"
+}, /*#__PURE__*/_react["default"].createElement("path", {
+  d: "M0 0h24v24H0z",
+  fill: "none"
+}), /*#__PURE__*/_react["default"].createElement("path", {
+  d: "M12 8l-6 6 1.41 1.41L12 10.83l4.59 4.58L18 14z"
+}));
+var externalLinkIcon = /*#__PURE__*/_react["default"].createElement("svg", {
+  xmlns: "http://www.w3.org/2000/svg",
+  height: "24",
+  viewBox: "0 0 24 24",
+  width: "24",
+  fill: "currentColor"
+}, /*#__PURE__*/_react["default"].createElement("path", {
+  d: "M0 0h24v24H0z",
+  fill: "none"
+}), /*#__PURE__*/_react["default"].createElement("path", {
+  d: "M19 19H5V5h7V3H5c-1.11 0-2 .9-2 2v14c0 1.1.89 2 2 2h14c1.1 0 2-.9 2-2v-7h-2v7zM14 3v2h3.59l-9.83 9.83 1.41 1.41L19 6.41V10h2V3h-7z"
+}));
+var DxcSidenav = function DxcSidenav(_ref) {
+  var children = _ref.children,
+    title = _ref.title;
+  var colorsTheme = (0, _useTheme["default"])();
+  return /*#__PURE__*/_react["default"].createElement(_styledComponents.ThemeProvider, {
+    theme: colorsTheme["sidenav"]
+  }, /*#__PURE__*/_react["default"].createElement(SidenavContainer, null, /*#__PURE__*/_react["default"].createElement(_BackgroundColorContext.BackgroundColorProvider, {
+    color: colorsTheme["sidenav"].backgroundColor
+  }, title, /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
+    direction: "column",
+    gap: "1rem"
+  }, _react["default"].Children.map(children, function (child, index) {
+    return /*#__PURE__*/_react["default"].createElement(_react["default"].Fragment, null, child, index !== _react["default"].Children.count(children) - 1 && /*#__PURE__*/_react["default"].createElement(Divider, null));
+  })))));
+};
+var Title = function Title(_ref2) {
+  var children = _ref2.children;
+  return /*#__PURE__*/_react["default"].createElement(_Bleed["default"], {
+    horizontal: "1rem"
+  }, /*#__PURE__*/_react["default"].createElement(SidenavTitle, null, children));
+};
+var Section = function Section(_ref3) {
+  var children = _ref3.children;
+  return /*#__PURE__*/_react["default"].createElement(_Bleed["default"], {
+    horizontal: "1rem"
+  }, /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
+    direction: "column"
+  }, children));
+};
+var Group = function Group(_ref4) {
+  var children = _ref4.children,
+    title = _ref4.title,
+    _ref4$collapsable = _ref4.collapsable,
+    collapsable = _ref4$collapsable === void 0 ? false : _ref4$collapsable,
+    icon = _ref4.icon;
+  var _useState = (0, _react.useState)(false),
+    _useState2 = (0, _slicedToArray2["default"])(_useState, 2),
+    collapsed = _useState2[0],
+    setCollapsed = _useState2[1];
+  var selectedGroup = (0, _react.useMemo)(function () {
+    return collapsed ? _react["default"].Children.toArray(children).some(function (child) {
+      var _child$props;
+      return (_child$props = child["props"]) === null || _child$props === void 0 ? void 0 : _child$props.selected;
+    }) : false;
+  }, [collapsed, children]);
+  return /*#__PURE__*/_react["default"].createElement(SidenavGroup, null, collapsable && title ? /*#__PURE__*/_react["default"].createElement(SidenavGroupTitleButton, {
+    role: "button",
+    "aria-expanded": !collapsed,
+    onClick: function onClick() {
+      return setCollapsed(!collapsed);
+    },
+    selectedGroup: selectedGroup
+  }, /*#__PURE__*/_react["default"].createElement(SidenavContent, null, typeof icon === "string" ? /*#__PURE__*/_react["default"].createElement("img", {
+    src: icon
+  }) : icon, title), collapsed ? collapsedIcon : collapsableIcon) : title && /*#__PURE__*/_react["default"].createElement(SidenavGroupTitle, null, typeof icon === "string" ? /*#__PURE__*/_react["default"].createElement("img", {
+    src: icon
+  }) : icon, title), !collapsed && children);
+};
+var Link = /*#__PURE__*/(0, _react.forwardRef)(function (_ref5, ref) {
+  var href = _ref5.href,
+    children = _ref5.children,
+    _ref5$newWindow = _ref5.newWindow,
+    newWindow = _ref5$newWindow === void 0 ? false : _ref5$newWindow,
+    _ref5$selected = _ref5.selected,
+    selected = _ref5$selected === void 0 ? false : _ref5$selected,
+    icon = _ref5.icon,
+    _ref5$tabIndex = _ref5.tabIndex,
+    tabIndex = _ref5$tabIndex === void 0 ? 0 : _ref5$tabIndex,
+    onClick = _ref5.onClick,
+    otherProps = (0, _objectWithoutProperties2["default"])(_ref5, _excluded);
+  var setIsSidenavVisibleResponsive = (0, _SidenavContext.useResponsiveSidenavVisibility)();
+  var handleClick = function handleClick($event) {
+    onClick === null || onClick === void 0 ? void 0 : onClick($event);
+    setIsSidenavVisibleResponsive === null || setIsSidenavVisibleResponsive === void 0 ? void 0 : setIsSidenavVisibleResponsive(false);
+  };
+  return /*#__PURE__*/_react["default"].createElement(SidenavLink, (0, _extends2["default"])({
+    selected: selected,
+    href: href ? href : undefined,
+    target: href ? newWindow ? "_blank" : "_self" : undefined,
+    ref: ref,
+    tabIndex: tabIndex,
+    onClick: handleClick
+  }, otherProps), /*#__PURE__*/_react["default"].createElement(SidenavContent, null, typeof icon === "string" ? /*#__PURE__*/_react["default"].createElement("img", {
+    src: icon
+  }) : icon, children), newWindow && externalLinkIcon);
+});
+var SidenavContainer = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-direction: column;\n  background-color: ", ";\n  box-sizing: border-box;\n  width: 280px;\n  @media (max-width: ", "rem) {\n    width: 100vw;\n  }\n\n  height: 100%;\n  padding: 2rem 1rem;\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"])), function (props) {
+  return props.theme.backgroundColor;
+}, _variables.responsiveSizes.medium, function (props) {
+  return props.theme.scrollBarTrackColor;
+}, function (props) {
+  return props.theme.scrollBarThumbColor;
+});
+var SidenavTitle = _styledComponents["default"].div(_templateObject2 || (_templateObject2 = (0, _taggedTemplateLiteral2["default"])(["\n  font-family: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  line-height: 27px;\n  display: flex;\n  align-items: center;\n  color: ", ";\n  text-transform: ", ";\n  letter-spacing: ", ";\n  padding: 0.5rem 1.2rem;\n\n  svg {\n    margin-right: 0.5rem;\n  }\n"])), function (props) {
+  return props.theme.titleFontFamily;
+}, function (props) {
+  return props.theme.titleFontStyle;
+}, function (props) {
+  return props.theme.titleFontWeight;
+}, function (props) {
+  return props.theme.titleFontSize;
+}, function (props) {
+  return props.theme.titleFontColor;
+}, function (props) {
+  return props.theme.titleFontTextTransform;
+}, function (props) {
+  return props.theme.titleFontLetterSpacing;
+});
+var Divider = _styledComponents["default"].div(_templateObject3 || (_templateObject3 = (0, _taggedTemplateLiteral2["default"])(["\n  width: 100%;\n  height: 1px;\n  background-color: #999999;\n"])));
+var SidenavGroup = _styledComponents["default"].div(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["\n  width: 100%;\n  a {\n    padding: 0.5rem 1.2rem 0.5rem 2.25rem;\n  }\n"])));
+var SidenavGroupTitle = _styledComponents["default"].span(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["\n  box-sizing: border-box;\n  display: flex;\n  align-items: center;\n  gap: 0.5rem;\n  width: 100%;\n  padding: 0.5rem 1.2rem;\n  font-family: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  line-height: 18px;\n\n  img,\n  svg {\n    height: 16px;\n    width: 16px;\n  }\n"])), function (props) {
+  return props.theme.groupTitleFontFamily;
+}, function (props) {
+  return props.theme.groupTitleFontStyle;
+}, function (props) {
+  return props.theme.groupTitleFontWeight;
+}, function (props) {
+  return props.theme.groupTitleFontSize;
+});
+var SidenavGroupTitleButton = _styledComponents["default"].button(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n  all: unset;\n  box-sizing: border-box;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  width: 100%;\n  padding: 0.5rem 1.2rem;\n\n  font-family: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  line-height: 19px;\n\n  cursor: pointer;\n\n  &:focus-visible {\n    outline: 2px solid ", ";\n    outline-offset: -2px;\n  }\n  &:hover {\n    ", "\n  }\n  &:active {\n    background-color: ", ";\n    color: ", ";\n  }\n  ", "\n\n  svg {\n    height: 16px;\n    width: 16px;\n  }\n"])), function (props) {
+  return props.theme.groupTitleFontFamily;
+}, function (props) {
+  return props.theme.groupTitleFontStyle;
+}, function (props) {
+  return props.theme.groupTitleFontWeight;
+}, function (props) {
+  return props.theme.groupTitleFontSize;
+}, function (props) {
+  return props.theme.linkFocusColor;
+}, function (props) {
+  return props.selectedGroup ? "color: ".concat(props.theme.groupTitleSelectedHoverFontColor, "; background: ").concat(props.theme.groupTitleSelectedHoverBackgroundColor, ";") : "color: ".concat(props.theme.groupTitleFontColor, "; background: ").concat(props.theme.groupTitleHoverBackgroundColor, ";");
+}, function (props) {
+  return props.theme.groupTitleActiveBackgroundColor;
+}, function (props) {
+  return props.theme.groupTitleFontColor;
+}, function (props) {
+  return props.selectedGroup ? "color: ".concat(props.theme.groupTitleSelectedFontColor, "; background: ").concat(props.theme.groupTitleSelectedBackgroundColor, ";") : "color: ".concat(props.theme.groupTitleFontColor, "; background: transparent;");
+});
+var SidenavLink = _styledComponents["default"].a(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 0.5rem;\n  padding: 0.5rem 1.2rem;\n  box-shadow: 0 0 0 2px transparent;\n  letter-spacing: ", ";\n  text-transform: ", ";\n  text-decoration: ", ";\n  font-family: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  line-height: 19px;\n\n  ", "\n\n  cursor: pointer;\n\n  &:hover {\n    ", "\n  }\n  &:focus {\n    outline: 2px solid ", ";\n    outline-offset: -2px;\n  }\n  &:active {\n    color: #ffffff;\n    background: #4d4d4d;\n    outline: 2px solid #0095ff;\n    outline-offset: -2px;\n  }\n\n  svg {\n    height: 16px;\n    width: 16px;\n  }\n"])), function (props) {
+  return props.theme.linkFontLetterSpacing;
+}, function (props) {
+  return props.theme.linkFontTextTransform;
+}, function (props) {
+  return props.theme.linkTextDecoration;
+}, function (props) {
+  return props.theme.linkFontFamily;
+}, function (props) {
+  return props.theme.linkFontStyle;
+}, function (props) {
+  return props.theme.linkFontWeight;
+}, function (props) {
+  return props.theme.linkFontSize;
+}, function (props) {
+  return props.selected ? "color: ".concat(props.theme.linkSelectedFontColor, "; background: ").concat(props.theme.linkSelectedBackgroundColor, ";") : "color: ".concat(props.theme.linkFontColor, "; background: transparent;");
+}, function (props) {
+  return props.selected ? "color: ".concat(props.theme.linkSelectedHoverFontColor, "; background: ").concat(props.theme.linkSelectedHoverBackgroundColor, ";") : "color: ".concat(props.theme.linkFontColor, "; background: ").concat(props.theme.linkHoverBackgroundColor, ";");
+}, function (props) {
+  return props.theme.linkFocusColor;
+});
+var SidenavContent = _styledComponents["default"].span(_templateObject8 || (_templateObject8 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  align-items: center;\n  gap: 0.5rem;\n\n  img,\n  svg {\n    height: 16px;\n    width: 16px;\n  }\n"])));
+DxcSidenav.Section = Section;
+DxcSidenav.Group = Group;
+DxcSidenav.Link = Link;
+DxcSidenav.Title = Title;
+var _default = DxcSidenav;
+exports["default"] = _default;