@dxc-technology/halstack-react 5.0.0 → 6.0.0

package/flex/Flex.stories.tsx

@@ -0,0 +1,103 @@
+import React from "react";
+import Title from "../../.storybook/components/Title";
+import styled from "styled-components";
+import DxcFlex from "./Flex";
+
+export default {
+  title: "Flex",
+  component: DxcFlex,
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Default" level={4} />
+    <Container>
+      <DxcFlex>
+        <Placeholder />
+        <Placeholder width="50px" />
+        <Placeholder />
+        <Placeholder width="50px" />
+        <Placeholder width="50px" />
+      </DxcFlex>
+    </Container>
+    <Title title="Direction column, wrap, justify content end, align items center and gap" level={4} />
+    <Container>
+      <DxcFlex direction="column" wrap="wrap" justifyContent="end" alignItems="center" gap="20px">
+        <Placeholder />
+        <Placeholder width="100px" />
+        <Placeholder />
+        <Placeholder width="100px" />
+        <Placeholder />
+      </DxcFlex>
+    </Container>
+    <Title title="Wrap with align content space between, row and column gaps, and as a span" level={4} />
+    <Container height="250px">
+      <DxcFlex wrap="wrap" alignContent="space-between" as="span" gap={{ rowGap: "10px", columnGap: "20px" }}>
+        <Placeholder />
+        <Placeholder />
+        <Placeholder />
+        <Placeholder />
+        <Placeholder width="100px" />
+        <Placeholder />
+        <Placeholder />
+        <Placeholder width="100px" />
+        <Placeholder />
+        <Placeholder />
+        <Placeholder width="100px" />
+        <Placeholder />
+      </DxcFlex>
+    </Container>
+    <Title title="Basis 100%, order, grow and align self" level={4} />
+    <Container height="75px">
+      <DxcFlex basis="100%">
+        <DxcFlex order={3} grow={1} alignSelf="flex-end">
+          <PlaceholderGrowAndShrink>order 3, grow 1, align self end</PlaceholderGrowAndShrink>
+        </DxcFlex>
+        <DxcFlex order={-1} grow={4}>
+          <PlaceholderGrowAndShrink>order -1, grow 4</PlaceholderGrowAndShrink>
+        </DxcFlex>
+        <DxcFlex order={5} grow={1}>
+          <PlaceholderGrowAndShrink>order 5, grow 1</PlaceholderGrowAndShrink>
+        </DxcFlex>
+        <DxcFlex order={2} grow={2}>
+          <PlaceholderGrowAndShrink>order 2. grow 2</PlaceholderGrowAndShrink>
+        </DxcFlex>
+      </DxcFlex>
+    </Container>
+    <Title title="Basis and shrink" level={4} />
+    <Container>
+      <DxcFlex basis="600px">
+        <DxcFlex shrink={4} basis="400px">
+          <PlaceholderGrowAndShrink>shrink 4</PlaceholderGrowAndShrink>
+        </DxcFlex>
+        <DxcFlex shrink={2} basis="400px">
+          <PlaceholderGrowAndShrink>shrink 2</PlaceholderGrowAndShrink>
+        </DxcFlex>
+        <DxcFlex shrink={1} basis="400px">
+          <PlaceholderGrowAndShrink>shrink 1</PlaceholderGrowAndShrink>
+        </DxcFlex>
+      </DxcFlex>
+    </Container>
+  </>
+);
+
+const Container = styled.div<{ height?: string }>`
+  display: flex;
+  background: #f2eafa;
+  margin: 2.5rem;
+  ${({ height }) => (height ? `height: ${height}` : "max-height: 150px")};
+`;
+
+const Placeholder = styled.div<{ width?: string }>`
+  height: 40px;
+  min-width: ${({ width }) => width || "200px"};
+  border: 1px solid #a46ede;
+  background-color: #e5d5f6;
+`;
+
+const PlaceholderGrowAndShrink = styled.div`
+  height: 40px;
+  width: 100%;
+  border: 1px solid #a46ede;
+  background-color: #e5d5f6;
+`;

package/flex/types.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+declare type Gap = {
+    rowGap: string;
+    columnGap: string;
+};
+declare type Props = {
+    direction?: "row" | "row-reverse" | "column" | "column-reverse";
+    wrap?: "nowrap" | "wrap" | "wrap-reverse";
+    justifyContent?: "flex-start" | "flex-end" | "start" | "end" | "left" | "right" | "center" | "space-between" | "space-around" | "space-evenly";
+    alignItems?: "stretch" | "flex-start" | "flex-end" | "start" | "end" | "self-start" | "self-end" | "center" | "baseline";
+    alignContent?: "normal" | "flex-start" | "flex-end" | "start" | "end" | "center" | "space-between" | "space-around" | "space-evenly" | "stretch";
+    gap?: string | Gap;
+    order?: number;
+    grow?: number;
+    shrink?: number;
+    basis?: string;
+    alignSelf?: "auto" | "flex-start" | "flex-end" | "center" | "baseline" | "stretch";
+    as?: keyof HTMLElementTagNameMap;
+    children: React.ReactNode;
+};
+export default Props;

package/footer/Footer.js

@@ -21,6 +21,8 @@ var _variables = require("../common/variables.js");
 
 var _useTheme = _interopRequireDefault(require("../useTheme"));
 
+var _useTranslatedLabels = _interopRequireDefault(require("../useTranslatedLabels"));
+
 var _BackgroundColorContext = require("../BackgroundColorContext");
 
 var _Icons = require("./Icons");
@@ -34,14 +36,14 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
 var DxcFooter = function DxcFooter(_ref) {
   var socialLinks = _ref.socialLinks,
       bottomLinks = _ref.bottomLinks,
-      _ref$copyright = _ref.copyright,
-      copyright = _ref$copyright === void 0 ? "\xA9 DXC Technology ".concat(new Date().getFullYear(), ". All rights reserved.") : _ref$copyright,
+      copyright = _ref.copyright,
       children = _ref.children,
       padding = _ref.padding,
       margin = _ref.margin,
       _ref$tabIndex = _ref.tabIndex,
       tabIndex = _ref$tabIndex === void 0 ? 0 : _ref$tabIndex;
   var colorsTheme = (0, _useTheme["default"])();
+  var translatedLabels = (0, _useTranslatedLabels["default"])();
   var footerLogo = (0, _react.useMemo)(function () {
     if (!colorsTheme.footer.logo) {
       return _Icons.dxcLogo;
@@ -49,7 +51,7 @@ var DxcFooter = function DxcFooter(_ref) {
 
     if (typeof colorsTheme.footer.logo === "string") {
       return /*#__PURE__*/_react["default"].createElement(LogoImg, {
-        alt: "Logo",
+        alt: translatedLabels.formFields.logoAlternativeText,
         src: colorsTheme.footer.logo
       });
     }
@@ -86,7 +88,7 @@ var DxcFooter = function DxcFooter(_ref) {
     color: colorsTheme.footer.backgroundColor
   }, children)), /*#__PURE__*/_react["default"].createElement(FooterFooter, {
     className: "footerFooter"
-  }, /*#__PURE__*/_react["default"].createElement(BottomLinks, null, bottomLink), /*#__PURE__*/_react["default"].createElement(Copyright, null, copyright)))));
+  }, /*#__PURE__*/_react["default"].createElement(BottomLinks, null, bottomLink), /*#__PURE__*/_react["default"].createElement(Copyright, null, copyright || translatedLabels.footer.copyrightText(new Date().getFullYear()))))));
 };
 
 var FooterContainer = _styledComponents["default"].footer(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  @media (min-width: ", "rem) {\n    padding: 24px 36px 24px 36px;\n  }\n\n  @media (max-width: ", "rem) {\n    //mobile phones\n    padding: 20px;\n  }\n\n  background-color: ", ";\n  margin-top: ", ";\n  width: 100%;\n  box-sizing: border-box;\n  min-height: ", ";\n  display: flex;\n  flex-direction: column;\n  justify-content: space-between;\n"])), _variables.responsiveSizes.small, _variables.responsiveSizes.small, function (props) {
@@ -119,7 +121,7 @@ var ChildComponents = _styledComponents["default"].div(_templateObject5 || (_tem
   return props.padding && (0, _typeof2["default"])(props.padding) === "object" && props.padding.left ? _variables.spaces[props.padding.left] : "";
 });
 
-var Copyright = _styledComponents["default"].div(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  color: ", ";\n\n  @media (min-width: ", "rem) {\n    max-width: 40%;\n    text-align: right;\n  }\n\n  @media (max-width: ", "rem) {\n    //mobile phones\n    max-width: 100%;\n    width: 100%;\n    text-align: left;\n  }\n  \n  padding-top: ", ";\n"])), function (props) {
+var Copyright = _styledComponents["default"].div(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n  font-family: ", ";\n  font-size: ", ";\n  font-style: ", ";\n  font-weight: ", ";\n  color: ", ";\n\n  @media (min-width: ", "rem) {\n    max-width: 40%;\n    text-align: right;\n  }\n\n  @media (max-width: ", "rem) {\n    //mobile phones\n    max-width: 100%;\n    width: 100%;\n    text-align: left;\n  }\n\n  padding-top: ", ";\n"])), function (props) {
   return props.theme.copyrightFontFamily;
 }, function (props) {
   return props.theme.copyrightFontSize;

package/footer/Icons.js

@@ -12,7 +12,7 @@ var _react = _interopRequireDefault(require("react"));
 var dxcLogo = /*#__PURE__*/_react["default"].createElement("svg", {
   id: "g10",
   xmlns: "http://www.w3.org/2000/svg",
-  width: "280.781",
+  width: "100%",
   height: "32",
   viewBox: "0 0 280.781 32"
 }, /*#__PURE__*/_react["default"].createElement("title", null, "DXC Logo"), /*#__PURE__*/_react["default"].createElement("g", {

package/header/Header.js

@@ -29,6 +29,8 @@ var _variables = require("../common/variables.js");
 
 var _useTheme = _interopRequireDefault(require("../useTheme"));
 
+var _useTranslatedLabels = _interopRequireDefault(require("../useTranslatedLabels"));
+
 var _BackgroundColorContext = _interopRequireWildcard(require("../BackgroundColorContext"));
 
 var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8, _templateObject9, _templateObject10, _templateObject11, _templateObject12, _templateObject13, _templateObject14, _templateObject15;
@@ -64,14 +66,14 @@ var Dropdown = function Dropdown(props) {
 
 var HeaderDropdown = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  button {\n    background-color: transparent;\n    :hover {\n      background-color: transparent;\n    }\n  }\n"])));
 
-var getLogoElement = function getLogoElement(themeInput) {
+var getLogoElement = function getLogoElement(themeInput, logoLabel) {
   if (!themeInput) {
     return _Icons.dxcLogo;
   }
 
   if (typeof themeInput === "string") {
     return /*#__PURE__*/_react["default"].createElement(LogoImg, {
-      alt: "Logo",
+      alt: logoLabel,
       src: themeInput
     });
   }
@@ -90,6 +92,7 @@ var DxcHeader = function DxcHeader(_ref) {
       _ref$tabIndex = _ref.tabIndex,
       tabIndex = _ref$tabIndex === void 0 ? 0 : _ref$tabIndex;
   var colorsTheme = (0, _useTheme["default"])();
+  var translatedLabels = (0, _useTranslatedLabels["default"])();
   var ref = (0, _react.useRef)(null);
 
   var _useState = (0, _react.useState)(false),
@@ -125,10 +128,10 @@ var DxcHeader = function DxcHeader(_ref) {
   };
 
   var headerLogo = (0, _react.useMemo)(function () {
-    return getLogoElement(colorsTheme.header.logo);
+    return getLogoElement(colorsTheme.header.logo, translatedLabels.formFields.logoAlternativeText);
   }, [colorsTheme.header.logo]);
   var headerResponsiveLogo = (0, _react.useMemo)(function () {
-    return getLogoElement(colorsTheme.header.logoResponsive);
+    return getLogoElement(colorsTheme.header.logoResponsive, translatedLabels.formFields.logoAlternativeText);
   }, [colorsTheme.header.logoResponsive]);
   (0, _react.useEffect)(function () {
     if (ref.current) {

package/inset/Inset.js

@@ -36,40 +36,7 @@ function Inset(_ref) {
 }
 
 function getSpacingValue(spacingName) {
-  switch (spacingName) {
-    case "none":
-      return "0rem";
-
-    case "xxxsmall":
-      return "0.125rem";
-
-    case "xxsmall":
-      return "0.25rem";
-
-    case "xsmall":
-      return "0.5rem";
-
-    case "small":
-      return "1rem";
-
-    case "medium":
-      return "1.5rem";
-
-    case "large":
-      return "2rem";
-
-    case "xlarge":
-      return "3rem";
-
-    case "xxlarge":
-      return "4rem";
-
-    case "xxxlarge":
-      return "5rem";
-
-    default:
-      return "0rem";
-  }
+  return spacingName ? spacingName : "0rem";
 }
 
 var StyledInset = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  ", "\n"])), function (_ref2) {

package/inset/Inset.stories.tsx

@@ -1,7 +1,7 @@
 import React from "react";
 import Title from "../../.storybook/components/Title";
 import styled from "styled-components";
-import DxcStack from "./../stack/Stack";
+import DxcFlex from "./../flex/Flex";
 import DxcInset from "./Inset";
 
 export default {
@@ -19,199 +19,199 @@ export const Chromatic = () => (
     </Container>
     <Title title="space = none" level={4} />
     <Container>
-      <DxcInset space="none">
+      <DxcInset space="0rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = xxxsmall" level={4} />
     <Container>
-      <DxcInset space="xxxsmall">
+      <DxcInset space="0.125rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = xxsmall" level={4} />
     <Container>
-      <DxcInset space="xxsmall">
+      <DxcInset space="0.25rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = xsmall" level={4} />
     <Container>
-      <DxcInset space="xsmall">
+      <DxcInset space="0.5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = small" level={4} />
     <Container>
-      <DxcInset space="small">
+      <DxcInset space="1rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = medium" level={4} />
     <Container>
-      <DxcInset space="medium">
+      <DxcInset space="1.5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = large" level={4} />
     <Container>
-      <DxcInset space="large">
+      <DxcInset space="2rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = xlarge" level={4} />
     <Container>
-      <DxcInset space="xlarge">
+      <DxcInset space="3rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = xxlarge" level={4} />
     <Container>
-      <DxcInset space="xxlarge">
+      <DxcInset space="4rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="space = xxxlarge" level={4} />
     <Container>
-      <DxcInset space="xxxlarge">
+      <DxcInset space="5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = none" level={4} />
     <Container>
-      <DxcInset horizontal="none">
+      <DxcInset horizontal="0rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = xxxsmall" level={4} />
     <Container>
-      <DxcInset horizontal="xxxsmall">
+      <DxcInset horizontal="0.125rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = xxsmall" level={4} />
     <Container>
-      <DxcInset horizontal="xxsmall">
+      <DxcInset horizontal="0.25rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = xsmall" level={4} />
     <Container>
-      <DxcInset horizontal="xsmall">
+      <DxcInset horizontal="0.5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = small" level={4} />
     <Container>
-      <DxcInset horizontal="small">
+      <DxcInset horizontal="1rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = medium" level={4} />
     <Container>
-      <DxcInset horizontal="medium">
+      <DxcInset horizontal="1.5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = large" level={4} />
     <Container>
-      <DxcInset horizontal="large">
+      <DxcInset horizontal="2rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = xlarge" level={4} />
     <Container>
-      <DxcInset horizontal="xlarge">
+      <DxcInset horizontal="3rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = xxlarge" level={4} />
     <Container>
-      <DxcInset horizontal="xxlarge">
+      <DxcInset horizontal="4rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="horizontal = xxxlarge" level={4} />
     <Container>
-      <DxcInset horizontal="xxxlarge">
+      <DxcInset horizontal="5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = none" level={4} />
     <Container>
-      <DxcInset vertical="none">
+      <DxcInset vertical="0rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = xxxsmall" level={4} />
     <Container>
-      <DxcInset vertical="xxxsmall">
+      <DxcInset vertical="0.125rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = xxsmall" level={4} />
     <Container>
-      <DxcInset vertical="xxsmall">
+      <DxcInset vertical="0.25rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = xsmall" level={4} />
     <Container>
-      <DxcInset vertical="xsmall">
+      <DxcInset vertical="0.5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = small" level={4} />
     <Container>
-      <DxcInset vertical="small">
+      <DxcInset vertical="1rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = medium" level={4} />
     <Container>
-      <DxcInset vertical="medium">
+      <DxcInset vertical="1.5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = large" level={4} />
     <Container>
-      <DxcInset vertical="large">
+      <DxcInset vertical="2rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = xlarge" level={4} />
     <Container>
-      <DxcInset vertical="xlarge">
+      <DxcInset vertical="3rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = xxlarge" level={4} />
     <Container>
-      <DxcInset vertical="xxlarge">
+      <DxcInset vertical="4rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="vertical = xxxlarge" level={4} />
     <Container>
-      <DxcInset vertical="xxxlarge">
+      <DxcInset vertical="5rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
     <Title title="top = xxsmall, right= medium, bottom = large and left = xxlarge" level={4} />
     <Container>
-      <DxcInset top="xxsmall" right="medium" bottom="large" left="xxlarge">
+      <DxcInset top="0.25rem" right="1.5rem" bottom="2rem" left="4rem">
         <Placeholder></Placeholder>
       </DxcInset>
     </Container>
-    <Title title="Inside a stack" level={4} />
+    <Title title="Inside a flex column" level={4} />
     <Container>
-      <DxcStack gutter="medium" divider>
+      <DxcFlex direction="column" gap="0.75rem">
         <Placeholder></Placeholder>
-        <DxcInset top="xxsmall" right="medium" bottom="large" left="xxlarge">
+        <DxcInset top="0.25rem" right="1.5rem" bottom="2rem" left="4rem">
           <Placeholder></Placeholder>
         </DxcInset>
         <Placeholder></Placeholder>
-      </DxcStack>
+      </DxcFlex>
     </Container>
   </>
 );

package/inset/types.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-declare type Spacing = "none" | "xxxsmall" | "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge" | "xxxlarge";
+declare type Spacing = "0rem" | "0.125rem" | "0.25rem" | "0.5rem" | "1rem" | "1.5rem" | "2rem" | "3rem" | "4rem" | "5rem";
 declare type Props = {
     /**
      * Applies the spacing scale to all sides.

package/layout/ApplicationLayout.d.ts

@@ -1,10 +1,20 @@
-/// <reference types="react" />
-import AppLayoutPropsType, { AppLayoutFooterPropsType, AppLayoutMainPropsType, AppLayoutHeaderPropsType } from "./types";
+import React from "react";
+import AppLayoutPropsType, { AppLayoutMainPropsType } from "./types";
 declare const DxcApplicationLayout: {
-    ({ children }: AppLayoutPropsType): JSX.Element;
-    Header: ({ children }: AppLayoutHeaderPropsType) => JSX.Element;
+    ({ visibilityToggleLabel, header, sidenav, footer, children, }: AppLayoutPropsType): JSX.Element;
+    Header: {
+        ({ underlined, content, responsiveContent, onClick, margin, padding, tabIndex, }: import("../header/types").default): JSX.Element;
+        Dropdown: (props: any) => JSX.Element;
+    };
     Main: ({ children }: AppLayoutMainPropsType) => JSX.Element;
-    Footer: ({ children }: AppLayoutFooterPropsType) => JSX.Element;
-    SideNav: (props: any) => JSX.Element;
+    Footer: ({ socialLinks, bottomLinks, copyright, children, padding, margin, tabIndex, }: import("../footer/types").default) => JSX.Element;
+    SideNav: {
+        ({ children, title }: import("../sidenav/types").default): JSX.Element;
+        Section: ({ children }: import("../sidenav/types").SidenavSectionPropsType) => JSX.Element;
+        Group: ({ children, title, collapsable, icon }: import("../sidenav/types").SidenavGroupPropsType) => JSX.Element;
+        Link: React.ForwardRefExoticComponent<import("../sidenav/types").SidenavLinkPropsType & React.RefAttributes<HTMLAnchorElement>>;
+        Title: ({ children }: import("../sidenav/types").SidenavTitlePropsType) => JSX.Element;
+    };
+    useResponsiveSidenavVisibility: () => (isSidenavVisible: boolean) => void;
 };
 export default DxcApplicationLayout;