@dxc-technology/halstack-react 0.0.0-efa7c74 → 0.0.0-eff2879

package/toggle-group/types.d.ts

@@ -1,44 +1,49 @@
 /// <reference types="react" />
-declare type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
-declare type Margin = {
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
     top?: Space;
     bottom?: Space;
     left?: Space;
     right?: Space;
 };
-declare type SVG = React.SVGProps<SVGSVGElement> | React.FunctionComponent<React.SVGProps<SVGSVGElement>>;
-declare type OptionCommons = {
+type SVG = React.ReactNode & React.SVGProps<SVGSVGElement>;
+type OptionIcon = {
     /**
-     * Number with the option inner value.
-     */
-    value: string;
-    /**
-     * @deprecated URL of the icon that will be placed. IconSrc and label can't be used at same time.
+     * String with the option display value.
      */
-    iconSrc?: string;
-};
-declare type OptionIcon = OptionCommons & {
+    label?: never;
     /**
-     * String with the option display value.
+     * Material Symbols icon or SVG element. Icon and label can't be used at same time.
      */
-    label?: string;
+    icon: string | SVG;
     /**
-     * Element used as the icon. Icon and label can't be used at same time.
+     * Value for the HTML properties title and aria-label.
+     * When a label is defined, this prop can not be use.
      */
-    icon: SVG;
+    title: string;
 };
-declare type OptionLabel = OptionCommons & {
+export type OptionLabel = {
     /**
      * String with the option display value.
      */
     label: string;
     /**
-     * Element used as the icon. Icon and label can't be used at same time.
+     * Material Symbols icon or SVG element. Icon and label can't be used at same time.
+     */
+    icon?: string | SVG;
+    /**
+     * Value for the HTML properties title and aria-label.
+     * When a label is defined, this prop can not be use.
      */
-    icon?: SVG;
+    title?: never;
 };
-declare type Option = OptionIcon | OptionLabel;
-declare type Props = {
+type Option = {
+    /**
+     * Number with the option inner value.
+     */
+    value: number;
+} & (OptionIcon | OptionLabel);
+type CommonProps = {
     /**
      * Text to be placed above the component.
      */
@@ -47,18 +52,6 @@ declare type Props = {
      * Helper text to be placed above the component.
      */
     helperText?: string;
-    /**
-     * The key(s) of the selected value(s). If the toggle group component doesn't allow multiple selection,
-     * it must be one unique value. If the component allows multiple selection, value must be an array.
-     * If undefined, the component will be uncontrolled and the value will be managed internally by the component.
-     */
-    value?: string | string[];
-    /**
-     * This function will be called every time the selection changes. The number with the key of the selected
-     * value will be passed as a parameter to this function.
-     * If multiple selection is allowed, an array of keys will be passed.
-     */
-    onChange?: (optionIndex: number | number[]) => void;
     /**
      * If true, the component will be disabled.
      */
@@ -66,11 +59,7 @@ declare type Props = {
     /**
      * An array of objects representing the selectable options.
      */
-    options: [Option, ...Option[]];
-    /**
-     * If true, the toggle group will support multiple selection. In that case, value must be an array of numbers with the keys of the selected values.
-     */
-    multiple?: boolean;
+    options: Option[];
     /**
      * 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.
@@ -81,4 +70,45 @@ declare type Props = {
      */
     tabIndex?: number;
 };
+type SingleSelectionToggleGroup = CommonProps & {
+    /**
+     * If true, the toggle group will support multiple selection. In that case, value must be an array of numbers with the keys of the selected values.
+     */
+    multiple?: false;
+    /**
+     * The key of the initially selected value.
+     */
+    defaultValue?: number;
+    /**
+     * The key of the selected value. If the component allows multiple selection, value must be an array.
+     * If undefined, the component will be uncontrolled and the value will be managed internally by the component.
+     */
+    value?: number;
+    /**
+     * This function will be called every time the selection changes. The number with the key of the selected
+     * value will be passed as a parameter to this function.
+     */
+    onChange?: (optionIndex: number) => void;
+};
+type MultipleSelectionToggleGroup = CommonProps & {
+    /**
+     * If true, the toggle group will support multiple selection. In that case, value must be an array of numbers with the keys of the selected values.
+     */
+    multiple: true;
+    /**
+     * The array of keys with the initially selected values.
+     */
+    defaultValue?: number[];
+    /**
+     * An array with the keys of the selected values.
+     * If undefined, the component will be uncontrolled and the value will be managed internally by the component.
+     */
+    value?: number[];
+    /**
+     * This function will be called every time the selection changes. An array with the key of
+     * the selected values will be passed as a parameter to this function.
+     */
+    onChange?: (optionIndex: number[]) => void;
+};
+type Props = SingleSelectionToggleGroup | MultipleSelectionToggleGroup;
 export default Props;

package/typography/Typography.accessibility.test.js

@@ -0,0 +1,339 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _react = _interopRequireDefault(require("react"));
+var _react2 = require("@testing-library/react");
+var _jestAxe = require("jest-axe");
+var _Typography = _interopRequireDefault(require("./Typography"));
+var _Flex = _interopRequireDefault(require("../flex/Flex"));
+describe("Typography component accessibility tests", function () {
+  it("Should not have basic accessibility issues for different font sizes", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee() {
+    var _render, container, results;
+    return _regenerator["default"].wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "3.75rem"
+          }, "3.75rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "3rem"
+          }, "3rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "2rem"
+          }, "2rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "1.5rem"
+          }, "1.5rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "1.25rem"
+          }, "1.25rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "1rem"
+          }, "1rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "0.875rem"
+          }, "0.875rem."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontSize: "0.75rem"
+          }, "0.75rem."))), container = _render.container;
+          _context.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  })));
+  it("Should not have basic accessibility issues for different letter spacings", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee2() {
+    var _render2, container, results;
+    return _regenerator["default"].wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _render2 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            letterSpacing: "-0.025em"
+          }, "-0.025em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            letterSpacing: "-0.0125em"
+          }, "-0.0125em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            letterSpacing: "0em"
+          }, "0em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            letterSpacing: "0.025em"
+          }, "0.025em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            letterSpacing: "0.05em"
+          }, "0.05em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            letterSpacing: "0.1em"
+          }, "0.1em."))), container = _render2.container;
+          _context2.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context2.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  })));
+  it("Should not have basic accessibility issues for different line heights", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee3() {
+    var _render3, container, results;
+    return _regenerator["default"].wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          _render3 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            lineHeight: "1em"
+          }, "1em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            lineHeight: "1.25em"
+          }, "1.25em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            lineHeight: "1.365em"
+          }, "1.365em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            lineHeight: "1.5em"
+          }, "1.5em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            lineHeight: "1.715em"
+          }, "1.715em."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            lineHeight: "2em"
+          }, "2em."))), container = _render3.container;
+          _context3.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context3.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3);
+  })));
+  it("Should not have basic accessibility issues for different font weights", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee4() {
+    var _render4, container, results;
+    return _regenerator["default"].wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          _render4 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontWeight: "300"
+          }, "300."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontWeight: "400"
+          }, "400."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontWeight: "600"
+          }, "600."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontWeight: "700"
+          }, "700."))), container = _render4.container;
+          _context4.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context4.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  })));
+  it("Should not have basic accessibility issues for different text decorations", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee5() {
+    var _render5, container, results;
+    return _regenerator["default"].wrap(function _callee5$(_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          _render5 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textDecoration: "underline"
+          }, "Underline."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textDecoration: "line-through"
+          }, "Line-through."))), container = _render5.container;
+          _context5.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context5.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5);
+  })));
+  it("Should not have basic accessibility issues for different font families", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee6() {
+    var _render6, container, results;
+    return _regenerator["default"].wrap(function _callee6$(_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
+        case 0:
+          _render6 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontFamily: "Open Sans, sans-serif"
+          }, "Open Sans, sans-serif."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontFamily: "Source Code Pro, monospace"
+          }, "Source Code Pro, monospace."))), container = _render6.container;
+          _context6.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context6.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context6.stop();
+      }
+    }, _callee6);
+  })));
+  it("Should not have basic accessibility issues for different font styles", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee7() {
+    var _render7, container, results;
+    return _regenerator["default"].wrap(function _callee7$(_context7) {
+      while (1) switch (_context7.prev = _context7.next) {
+        case 0:
+          _render7 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontStyle: "italic"
+          }, "Italic."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            fontStyle: "normal"
+          }, "Normal."))), container = _render7.container;
+          _context7.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context7.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context7.stop();
+      }
+    }, _callee7);
+  })));
+  it("Should not have basic accessibility issues for different text alignments", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee8() {
+    var _render8, container, results;
+    return _regenerator["default"].wrap(function _callee8$(_context8) {
+      while (1) switch (_context8.prev = _context8.next) {
+        case 0:
+          _render8 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textAlign: "left"
+          }, "Left."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textAlign: "center"
+          }, "Center."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textAlign: "right"
+          }, "Right."))), container = _render8.container;
+          _context8.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context8.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context8.stop();
+      }
+    }, _callee8);
+  })));
+  it("Should not have basic accessibility issues for different white-spaces", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee9() {
+    var _render9, container, results;
+    return _regenerator["default"].wrap(function _callee9$(_context9) {
+      while (1) switch (_context9.prev = _context9.next) {
+        case 0:
+          _render9 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            fontSize: "2rem"
+          }, "                  ", " Normal: A bunch of words you see."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            whiteSpace: "nowrap",
+            fontSize: "2rem"
+          }, "                  ", "No-wrap: A bunch of words you see."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            whiteSpace: "pre",
+            fontSize: "2rem"
+          }, "                  ", " pre: A bunch of words you see."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            whiteSpace: "pre-line",
+            fontSize: "2rem"
+          }, "                  ", "pre-line: A bunch of words you see."), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            whiteSpace: "pre-wrap",
+            fontSize: "2rem"
+          }, "                  ", " pre-wrap: A bunch of words you see."))), container = _render9.container;
+          _context9.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context9.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context9.stop();
+      }
+    }, _callee9);
+  })));
+  it("Should not have basic accessibility issues for different displays", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee10() {
+    var _render10, container, results;
+    return _regenerator["default"].wrap(function _callee10$(_context10) {
+      while (1) switch (_context10.prev = _context10.next) {
+        case 0:
+          _render10 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textAlign: "left"
+          }, "Display Block.", /*#__PURE__*/_react["default"].createElement(_Typography["default"], null, "A different text.")), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "inline",
+            textAlign: "left"
+          }, "Display Inline.", /*#__PURE__*/_react["default"].createElement(_Typography["default"], null, "A different text.")))), container = _render10.container;
+          _context10.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context10.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context10.stop();
+      }
+    }, _callee10);
+  })));
+  it("Should not have basic accessibility issues for different text overflows", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee11() {
+    var _render11, container, results;
+    return _regenerator["default"].wrap(function _callee11$(_context11) {
+      while (1) switch (_context11.prev = _context11.next) {
+        case 0:
+          _render11 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Flex["default"], null, /*#__PURE__*/_react["default"].createElement("div", {
+            style: {
+              width: "75px"
+            }
+          }, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textOverflow: "clip"
+          }, "Overflow clip.")), /*#__PURE__*/_react["default"].createElement("div", {
+            style: {
+              width: "75px"
+            }
+          }, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textOverflow: "ellipsis"
+          }, "Overflow ellipsis.")), /*#__PURE__*/_react["default"].createElement("div", {
+            style: {
+              width: "75px"
+            }
+          }, /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
+            display: "block",
+            textOverflow: "unset"
+          }, "Overflow unset.")))), container = _render11.container;
+          _context11.next = 3;
+          return (0, _jestAxe.axe)(container);
+        case 3:
+          results = _context11.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context11.stop();
+      }
+    }, _callee11);
+  })));
+});

package/typography/Typography.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import TypographyPropsTypes from "./types";
+declare const DxcTypography: ({ textOverflow, whiteSpace, children, ...props }: TypographyPropsTypes) => JSX.Element;
+export default DxcTypography;

package/typography/Typography.js

@@ -0,0 +1,23 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireDefault(require("react"));
+var _BaseTypography = _interopRequireDefault(require("../utils/BaseTypography"));
+var _excluded = ["textOverflow", "whiteSpace", "children"];
+var DxcTypography = function DxcTypography(_ref) {
+  var textOverflow = _ref.textOverflow,
+    whiteSpace = _ref.whiteSpace,
+    children = _ref.children,
+    props = (0, _objectWithoutProperties2["default"])(_ref, _excluded);
+  return /*#__PURE__*/_react["default"].createElement(_BaseTypography["default"], (0, _extends2["default"])({
+    textOverflow: textOverflow,
+    whiteSpace: whiteSpace == null && textOverflow != null && textOverflow !== "unset" ? "nowrap" : whiteSpace
+  }, props), children);
+};
+var _default = exports["default"] = DxcTypography;