@dxc-technology/halstack-react 0.0.0-6f13c26 → 0.0.0-6f24944

package/spinner/Spinner.stories.jsx

@@ -0,0 +1,103 @@
+import React from "react";
+import DxcSpinner from "./Spinner";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+
+export default {
+  title: "Spinner",
+  component: DxcSpinner,
+};
+
+export const Chromatic = () => (
+  <>
+    <ExampleContainer>
+      <Title title="With label" theme="light" level={4} />
+      <DxcSpinner label="Label" value="50"></DxcSpinner>
+      <Title title="With value label" theme="light" level={4} />
+      <DxcSpinner value="50" showValue></DxcSpinner>
+      <Title title="With label and value label" theme="light" level={4} />
+      <DxcSpinner label="Label" value="50" showValue></DxcSpinner>
+      <Title title="With 100%" theme="light" level={4} />
+      <DxcSpinner label="Label" value="100" showValue></DxcSpinner>
+    </ExampleContainer>
+    <Title title="Modes" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Mode large" theme="light" level={4} />
+      <DxcSpinner mode="large" value="50"></DxcSpinner>
+      <Title title="Mode small" theme="light" level={4} />
+      <DxcSpinner mode="small" value="50"></DxcSpinner>
+      <Title title="Mode small with 100%" theme="light" level={4} />
+      <DxcSpinner mode="small" value="100" showValue></DxcSpinner>
+    </ExampleContainer>
+    <Title title="Margins with large mode" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall margin" theme="light" level={4} />
+      <DxcSpinner margin="xxsmall" value="75"></DxcSpinner>
+      <Title title="Xsmall margin" theme="light" level={4} />
+      <DxcSpinner margin="xsmall" value="75"></DxcSpinner>
+      <Title title="Small margin" theme="light" level={4} />
+      <DxcSpinner margin="small" value="75"></DxcSpinner>
+      <Title title="Medium margin" theme="light" level={4} />
+      <DxcSpinner margin="medium" value="75"></DxcSpinner>
+      <Title title="Large margin" theme="light" level={4} />
+      <DxcSpinner margin="large" value="75"></DxcSpinner>
+      <Title title="Xlarge margin" theme="light" level={4} />
+      <DxcSpinner margin="xlarge" value="75"></DxcSpinner>
+      <Title title="Xxlarge margin" theme="light" level={4} />
+      <DxcSpinner margin="xxlarge" value="75"></DxcSpinner>
+    </ExampleContainer>
+    <Title title="Margins with small mode" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall margin" theme="light" level={4} />
+      <DxcSpinner margin="xxsmall" mode="small" value="75"></DxcSpinner>
+      <Title title="Xsmall margin" theme="light" level={4} />
+      <DxcSpinner margin="xsmall" mode="small" value="75"></DxcSpinner>
+      <Title title="Small margin" theme="light" level={4} />
+      <DxcSpinner margin="small" mode="small" value="75"></DxcSpinner>
+      <Title title="Medium margin" theme="light" level={4} />
+      <DxcSpinner margin="medium" mode="small" value="75"></DxcSpinner>
+      <Title title="Large margin" theme="light" level={4} />
+      <DxcSpinner margin="large" mode="small" value="75"></DxcSpinner>
+      <Title title="Xlarge margin" theme="light" level={4} />
+      <DxcSpinner margin="xlarge" mode="small" value="75"></DxcSpinner>
+      <Title title="Xxlarge margin" theme="light" level={4} />
+      <DxcSpinner margin="xxlarge" mode="small" value="75"></DxcSpinner>
+      <hr />
+    </ExampleContainer>
+  </>
+);
+
+export const SpinnerOverlay = () => (
+  <ExampleContainer>
+    <Title title="Mode overlay" theme="light" level={4} />
+    <DxcSpinner mode="overlay" value="25"></DxcSpinner>
+  </ExampleContainer>
+);
+
+export const SpinnerOverlayWith100 = () => (
+  <ExampleContainer>
+    <Title title="Mode overlay" theme="light" level={4} />
+    <DxcSpinner mode="overlay" value="100"></DxcSpinner>
+  </ExampleContainer>
+);
+
+export const SpinnerOverlayWithLabel = () => (
+  <ExampleContainer>
+    <Title title="Mode overlay" theme="light" level={4} />
+    <DxcSpinner mode="overlay" value="50" label="Label"></DxcSpinner>
+  </ExampleContainer>
+);
+
+export const SpinnerOverlayWithValue = () => (
+  <ExampleContainer>
+    <Title title="Mode overlay" theme="light" level={4} />
+    <DxcSpinner mode="overlay" value="50" showValue></DxcSpinner>
+  </ExampleContainer>
+);
+
+export const SpinnerOverlayWithValueAndLabel = () => (
+  <ExampleContainer>
+    <Title title="Mode overlay" theme="light" level={4} />
+    <DxcSpinner mode="overlay" label="Label" value="50" showValue></DxcSpinner>
+  </ExampleContainer>
+);

package/spinner/Spinner.test.js

@@ -0,0 +1,64 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _react = _interopRequireDefault(require("react"));
+
+var _react2 = require("@testing-library/react");
+
+var _Spinner = _interopRequireDefault(require("./Spinner"));
+
+describe("Spinner component tests", function () {
+  test("Spinner renders with correct label", function () {
+    var _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
+      label: "test-loading"
+    })),
+        getByText = _render.getByText;
+
+    expect(getByText("test-loading")).toBeTruthy();
+  });
+  test("Spinner shows value correctly", function () {
+    var _render2 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
+      label: "test-loading",
+      value: 75,
+      showValue: true
+    })),
+        getByText = _render2.getByText;
+
+    expect(getByText("75%")).toBeTruthy();
+  });
+  test("Small spinner hides value and label correctly", function () {
+    var _render3 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
+      mode: "small",
+      label: "test-loading",
+      value: 75,
+      showValue: true
+    })),
+        queryByText = _render3.queryByText;
+
+    expect(queryByText("test-loading")).toBeFalsy();
+    expect(queryByText("75%")).toBeFalsy();
+  });
+  test("Overlay spinner shows value and label correctly", function () {
+    var _render4 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
+      mode: "overlay",
+      label: "test-loading",
+      value: 75,
+      showValue: true
+    })),
+        getByText = _render4.getByText;
+
+    expect(getByText("test-loading")).toBeTruthy();
+    expect(getByText("75%")).toBeTruthy();
+  });
+  test("Get spinner by role", function () {
+    var _render5 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
+      label: "test-loading",
+      value: 75,
+      showValue: true
+    })),
+        getByRole = _render5.getByRole;
+
+    expect(getByRole("progressbar")).toBeTruthy();
+  });
+});

package/spinner/types.d.ts

@@ -0,0 +1,32 @@
+declare type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+declare type Margin = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+declare type Props = {
+    /**
+     * Text to be placed inside the spinner.
+     */
+    label?: string;
+    /**
+     * The value of the progress indicator. If it's received the
+     * component is determinate, otherwise is indeterminate.
+     */
+    value?: number;
+    /**
+     * If true, the value is displayed inside the spinner..
+     */
+    showValue?: boolean;
+    /**
+     * Available modes of the spinner.
+     */
+    mode?: "large" | "small" | "overlay";
+    /**
+     * 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;
+};
+export default Props;

package/spinner/types.js

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

package/stack/Stack.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import StackPropsType from "./types";
+declare const DxcStack: ({ alignX, as, divider, gutter, reverse, wrap, children, }: StackPropsType) => JSX.Element;
+export default DxcStack;

package/stack/Stack.js

@@ -0,0 +1,56 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _styledComponents = _interopRequireDefault(require("styled-components"));
+
+var _templateObject, _templateObject2;
+
+var DxcStack = function DxcStack(_ref) {
+  var _ref$alignX = _ref.alignX,
+      alignX = _ref$alignX === void 0 ? "stretch" : _ref$alignX,
+      _ref$as = _ref.as,
+      as = _ref$as === void 0 ? "div" : _ref$as,
+      _ref$divider = _ref.divider,
+      divider = _ref$divider === void 0 ? false : _ref$divider,
+      _ref$gutter = _ref.gutter,
+      gutter = _ref$gutter === void 0 ? "0rem" : _ref$gutter,
+      _ref$reverse = _ref.reverse,
+      reverse = _ref$reverse === void 0 ? false : _ref$reverse,
+      _ref$wrap = _ref.wrap,
+      wrap = _ref$wrap === void 0 ? false : _ref$wrap,
+      children = _ref.children;
+  return /*#__PURE__*/_react["default"].createElement(Stack, {
+    gutter: gutter,
+    alignX: alignX,
+    reverse: reverse,
+    as: as,
+    divider: divider,
+    wrap: wrap
+  }, _react["default"].Children.map(children, function (child, index) {
+    return /*#__PURE__*/_react["default"].createElement(_react["default"].Fragment, null, child, divider && index !== _react["default"].Children.count(children) - 1 && /*#__PURE__*/_react["default"].createElement(Divider, null));
+  }));
+};
+
+var Divider = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  width: 100%;\n  height: 1px;\n  background-color: #999999;\n"])));
+
+var Stack = _styledComponents["default"].div(_templateObject2 || (_templateObject2 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  ", "\n  padding: 0px;\n  margin: 0px;\n  height: 100%;\n"])), function (_ref2) {
+  var alignX = _ref2.alignX,
+      gutter = _ref2.gutter,
+      reverse = _ref2.reverse,
+      divider = _ref2.divider,
+      wrap = _ref2.wrap;
+  return "\n    flex-direction: ".concat(reverse ? "column-reverse" : "column", ";\n    align-items: ").concat(alignX === "start" || alignX === "end" ? "flex-".concat(alignX) : alignX, ";\n    gap: ").concat(divider ? "calc(".concat(gutter, "/2 - 1px)") : gutter, ";\n    flex-wrap: ").concat(wrap ? "wrap" : "nowrap", ";\n  ");
+});
+
+var _default = DxcStack;
+exports["default"] = _default;

package/stack/Stack.stories.tsx

@@ -0,0 +1,263 @@
+import React from "react";
+import Title from "../../.storybook/components/Title";
+import styled from "styled-components";
+import DxcStack from "./Stack";
+
+export default {
+  title: "Stack",
+  component: DxcStack,
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Default" theme="light" level={4} />
+    <Container>
+      <DxcStack>
+        <Placeholder height="small" width="small" />
+        <Placeholder height="medium" width="medium" />
+        <Placeholder height="large" width="large" />
+        <Placeholder height="small" width="large" />
+      </DxcStack>
+    </Container>
+    <Title title="Default with divider" theme="light" level={4} />
+    <Container>
+      <DxcStack divider>
+        <Placeholder height="medium" width="medium" />
+        <Placeholder height="large" width="large" />
+        <Placeholder height="small" width="large" />
+      </DxcStack>
+    </Container>
+    <Title title="Alignment with divider" theme="light" level={4} />
+    <Container>
+      <DxcStack alignX="end" divider>
+        <Placeholder height="small" width="small" />
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Default with one child" theme="light" level={4} />
+    <Container>
+      <DxcStack divider>
+        <Placeholder height="large" width="xlarge" />
+      </DxcStack>
+    </Container>
+    <Title title="Wrap" theme="light" level={4} />
+    <FlexContainer customHeight>
+      <DxcStack wrap>
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+        <Placeholder height="large" width="medium" />
+      </DxcStack>
+    </FlexContainer>
+    <Title title="No wrap in a flex container" theme="light" level={4} />
+    <FlexContainer customHeight>
+      <DxcStack>
+        <Placeholder height="small" width="small" />
+        <Placeholder height="medium" width="small" />
+        <Placeholder height="small" width="medium" />
+      </DxcStack>
+    </FlexContainer>
+    <Title title="No wrap (default)" theme="light" level={4} />
+    <Container customHeight>
+      <DxcStack>
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="small" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="AlignX = start" theme="light" level={4} />
+    <Container>
+      <DxcStack alignX="start">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+        <Placeholder height="large" width="medium" />
+      </DxcStack>
+    </Container>
+    <Title title="AlignX = end" theme="light" level={4} />
+    <Container>
+      <DxcStack alignX="end">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="AlignX = center" theme="light" level={4} />
+    <Container>
+      <DxcStack alignX="center">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+        <Placeholder height="large" width="medium" />
+      </DxcStack>
+    </Container>
+    <Title title="AlignX = baseline" theme="light" level={4} />
+    <Container>
+      <DxcStack alignX="baseline">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="AlignX with wrapped items" theme="light" level={4} />
+    <Container customHeight>
+      <DxcStack alignX="center" wrap>
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="small" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 0rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="0rem">
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="medium" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="small" width="medium" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 0.125rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="0.125rem">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 0.25rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="0.25rem">
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="medium" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="small" width="medium" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 0.5rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="0.5rem">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 0.75rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="0.75rem">
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="medium" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="small" width="medium" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 1rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="1rem">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 1.5rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="1.5rem">
+        <Placeholder height="small" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="medium" width="medium" />
+        <Placeholder height="large" width="small" />
+        <Placeholder height="small" width="medium" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 2rem & divider" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="2rem" divider>
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 3rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="3rem">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 4rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="4rem">
+        <Placeholder height="large" width="medium" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Gutter = 5rem" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="5rem">
+        <Placeholder height="small" width="small" />
+        <Placeholder height="medium" width="small" />
+      </DxcStack>
+    </Container>
+    <Title title="Reverse" theme="light" level={4} />
+    <Container>
+      <DxcStack reverse>
+        <Placeholder height="small" width="medium">
+          1
+        </Placeholder>
+        <Placeholder height="large" width="small">
+          2
+        </Placeholder>
+        <Placeholder height="medium" width="medium">
+          3
+        </Placeholder>
+        <Placeholder height="large" width="small">
+          4
+        </Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Wrapped and reversed children" theme="light" level={4} />
+    <FlexContainer customHeight>
+      <DxcStack reverse wrap>
+        <Placeholder height="small" width="medium">
+          1
+        </Placeholder>
+        <Placeholder height="large" width="small">
+          2
+        </Placeholder>
+        <Placeholder height="medium" width="medium">
+          3
+        </Placeholder>
+        <Placeholder height="large" width="small">
+          4
+        </Placeholder>
+      </DxcStack>
+    </FlexContainer>
+  </>
+);
+
+const FlexContainer = styled.div<{ customHeight?: boolean }>`
+  display: flex;
+  ${({ customHeight }) => customHeight && `height: 100px;`};
+  background: #f2eafa;
+`;
+
+const Container = styled.div<{ customHeight?: boolean }>`
+  background: #f2eafa;
+  ${({ customHeight }) => customHeight && `height: 100px;`};
+`;
+
+type PlaceholderProps = {
+  width?: "xlarge" | "large" | "medium" | "small" | "auto";
+  height?: "large" | "medium" | "small" | "auto";
+};
+
+const Placeholder = styled.div<PlaceholderProps>`
+  ${({ width }) =>
+    width &&
+    `width: ${width === "xlarge" ? "350px" : width === "large" ? "150px" : width === "medium" ? "100px" : "50px"};`};
+  ${({ height }) => height && `height: ${height === "large" ? "100px" : height === "medium" ? "80px" : "50px"};`};
+  border: 1px solid #a46ede;
+  background-color: #e5d5f6;
+`;

package/stack/types.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="react" />
+declare type Props = {
+    /**
+     * Alignment applied to children in the main axis.
+     */
+    alignX?: "start" | "end" | "center" | "baseline" | "stretch";
+    /**
+     * Specifies the HTML tag or component that is rendered as the wrapper element.
+     */
+    as?: React.ElementType;
+    /**
+     * If true, a divider is shown between children.
+     */
+    divider?: boolean;
+    /**
+     * Space applied between each child.
+     */
+    gutter?: "0rem" | "0.125rem" | "0.25rem" | "0.5rem" | "0.75rem" | "1rem" | "1.5rem" | "2rem" | "3rem" | "4rem" | "5rem";
+    /**
+     * Change the direction of the stack to reverse.
+     */
+    reverse?: boolean;
+    /**
+     * Sets whether the children are forced onto one column or can wrap onto multiple columns.
+     */
+    wrap?: boolean;
+    /**
+     * Custom content inside the stack.
+     */
+    children: React.ReactNode[] | React.ReactNode;
+};
+export default Props;

package/stack/types.js

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

package/switch/Switch.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import SwitchPropsType from "./types";
+declare const DxcSwitch: ({ defaultChecked, checked, value, label, labelPosition, name, disabled, optional, onChange, margin, size, tabIndex, }: SwitchPropsType) => JSX.Element;
+export default DxcSwitch;