@dxc-technology/halstack-react 0.0.0-ff43881 → 0.0.0-ff5083e

package/radio-group/types.d.ts

@@ -1,36 +1,114 @@
 export declare type Option = {
+    /**
+     * Label of the option placed next to the radio input.
+     */
     value: string;
+    /**
+     * Value of the option. It should be unique and
+     * not an empty string, which is reserved to the optional item added
+     * by 'optional' prop.
+     */
     label: string;
+    /**
+     * If true, disables the option.
+     */
     disabled?: boolean;
 };
 declare type RadioGroupProps = {
+    /**
+     * Text to be placed above the radio group.
+     */
     label: string;
+    /**
+     * Name attribute of the input element. This attribute will allow users
+     * to find the component's value during the submit event.
+     */
     name?: string;
+    /**
+     * Helper text to be placed above the radio group.
+     */
     helperText?: string;
+    /**
+     * An array of objects representing the selectable options.
+     */
     options: Option[];
+    /**
+     * If true, the component will be disabled.
+     */
     disabled?: boolean;
+    /**
+     * If true, the radio group will be optional, showing
+     * (Optional) next to the label and adding a default last
+     * option with an empty string as value. Otherwise, the field will be
+     * considered required and an error will be passed as a parameter to the
+     * OnBlur functions if an option wasn't selected.
+     */
     optional?: boolean;
+    /**
+     * Label of the optional radio input.
+     */
     optionalItemLabel?: string;
+    /**
+     * If true, the component will be marked as readonly.
+     */
     readonly?: boolean;
+    /**
+     * Sets the orientation of the options within the radio group.
+     */
     stacking?: "row" | "column";
+    /**
+     * Initial value of the radio group, only when it is uncontrolled.
+     */
     defaultValue?: string;
+    /**
+     * Value of the radio group. If undefined, the component will be
+     * uncontrolled and the value will be managed internally by the
+     * component.
+     */
     value?: string;
-    onChange?: (value?: string) => void;
+    /**
+     * This function will be called when the user chooses an option. The new
+     * value will be passed to this function.
+     */
+    onChange?: (value: string) => void;
+    /**
+     * This function will be called when the radio group loses the focus. An
+     * object including the value and the error will be passed to this
+     * function. If there is no error, error will not be defined.
+     */
     onBlur?: (val: {
         value?: string;
         error?: string;
     }) => void;
+    /**
+     * If it is a defined value and also a truthy string, the component will
+     * change its appearance, showing the error below the radio group. 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;
+    /**
+     * Value of the tabindex attribute.
+     */
+    tabIndex?: number;
 };
+/**
+ * Reference to the component.
+ */
 export declare type RefType = HTMLDivElement;
+/**
+ * Single radio prop types.
+ */
 export declare type RadioProps = {
     option: Option;
     currentValue?: string;
     onClick: () => void;
-    onFocus: () => void;
     error?: string;
     disabled: boolean;
     focused: boolean;
     readonly: boolean;
+    tabIndex: number;
 };
 export default RadioGroupProps;

package/resultsetTable/ResultsetTable.test.js

@@ -0,0 +1,306 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _react = _interopRequireDefault(require("react"));
+
+var _react2 = require("@testing-library/react");
+
+var _userEvent = _interopRequireDefault(require("@testing-library/user-event"));
+
+var _ResultsetTable = _interopRequireDefault(require("./ResultsetTable"));
+
+var columns = [{
+  displayValue: "Id",
+  isSortable: false
+}, {
+  displayValue: "Name",
+  isSortable: true
+}, {
+  displayValue: "City",
+  isSortable: false
+}];
+var rows = [[{
+  displayValue: "001",
+  sortValue: "001"
+}, {
+  displayValue: "Peter",
+  sortValue: "Peter"
+}, {
+  displayValue: "Oviedo",
+  sortValue: "Oviedo"
+}], [{
+  displayValue: "002",
+  sortValue: "002"
+}, {
+  displayValue: "Louis",
+  sortValue: "Louis"
+}, {
+  displayValue: "Oviedo",
+  sortValue: "Oviedo"
+}, {
+  displayValue: ""
+}], [{
+  displayValue: "003",
+  sortValue: "003"
+}, {
+  displayValue: "Lana",
+  sortValue: "Lana"
+}, {
+  displayValue: "Albacete",
+  sortValue: "Albacete"
+}], [{
+  displayValue: "004",
+  sortValue: "004"
+}, {
+  displayValue: "Rick",
+  sortValue: "Rick"
+}, {
+  displayValue: "Albacete",
+  sortValue: "Albacete"
+}], [{
+  displayValue: "005",
+  sortValue: "005"
+}, {
+  displayValue: "Mark",
+  sortValue: "Mark"
+}, {
+  displayValue: "Madrid",
+  sortValue: "Madrid"
+}], [{
+  displayValue: "006",
+  sortValue: "006"
+}, {
+  displayValue: "Cris",
+  sortValue: "Cris"
+}, {
+  displayValue: "Barcelona",
+  sortValue: "Barcelona"
+}, {
+  displayValue: ""
+}], [{
+  displayValue: "007",
+  sortValue: "007"
+}, {
+  displayValue: "Susan",
+  sortValue: "Susan"
+}, {
+  displayValue: "Madrid",
+  sortValue: "Madrid"
+}], [{
+  displayValue: "008",
+  sortValue: "008"
+}, {
+  displayValue: "Tina",
+  sortValue: "Tina"
+}, {
+  displayValue: "Barcelona",
+  sortValue: "Barcelona"
+}], [{
+  displayValue: "009",
+  sortValue: "009"
+}, {
+  displayValue: "Kevin",
+  sortValue: "Kevin"
+}, {
+  displayValue: "Oviedo",
+  sortValue: "Oviedo"
+}, {
+  displayValue: ""
+}], [{
+  displayValue: "010",
+  sortValue: "010"
+}, {
+  displayValue: "Cosmin",
+  sortValue: "Cosmin"
+}, {
+  displayValue: "Barcelona",
+  sortValue: "Barcelona"
+}, {
+  displayValue: ""
+}]];
+var rows2 = [[{
+  displayValue: "546",
+  sortValue: "465"
+}, {
+  displayValue: "OtherValue",
+  sortValue: "OtherValue"
+}, {
+  displayValue: "OtherValue",
+  sortValue: "OtherValue"
+}], [{
+  displayValue: "978",
+  sortValue: "465"
+}, {
+  displayValue: "OtherValue",
+  sortValue: "OtherValue"
+}, {
+  displayValue: "OtherValue",
+  sortValue: "OtherValue"
+}, {
+  displayValue: ""
+}], [{
+  displayValue: "678",
+  sortValue: "344"
+}, {
+  displayValue: "OtherValue",
+  sortValue: "OtherValue"
+}, {
+  displayValue: "OtherValue",
+  sortValue: "OtherValue"
+}]];
+describe("ResultsetTable component tests", function () {
+  test("ResultsetTable rendered correctly", function () {
+    var _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3
+    })),
+        getByText = _render.getByText;
+
+    expect(getByText("Peter")).toBeTruthy();
+  });
+  test("Resultsettable shows as many rows as itemsPerPage", function () {
+    var _render2 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3
+    })),
+        getAllByRole = _render2.getAllByRole;
+
+    expect(getAllByRole("row").length - 1).toEqual(3);
+  });
+  test("Resultsettable shows rows on second page", function () {
+    var _render3 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3
+    })),
+        getByText = _render3.getByText,
+        getAllByRole = _render3.getAllByRole;
+
+    expect(getByText("Peter")).toBeTruthy();
+    expect(getByText("Louis")).toBeTruthy();
+    expect(getByText("Lana")).toBeTruthy();
+    expect(getAllByRole("row").length - 1).toEqual(3);
+    var nextButton = getAllByRole("button")[2];
+
+    _react2.fireEvent.click(nextButton);
+
+    expect(getByText("4 to 6 of 10")).toBeTruthy(); // expect(getByText("Page: 2 of 4")).toBeTruthy();
+
+    expect(getByText("Rick")).toBeTruthy();
+    expect(getByText("Mark")).toBeTruthy();
+    expect(getByText("Cris")).toBeTruthy();
+    expect(getAllByRole("row").length - 1).toEqual(3);
+  });
+  test("Resultsettable goToPage works as expected", function () {
+    window.HTMLElement.prototype.scrollIntoView = function () {};
+
+    window.HTMLElement.prototype.scrollTo = function () {};
+
+    var _render4 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      showGoToPage: true,
+      rows: rows,
+      itemsPerPage: 3
+    })),
+        getByText = _render4.getByText,
+        getAllByRole = _render4.getAllByRole,
+        getByRole = _render4.getByRole;
+
+    expect(getByText("Peter")).toBeTruthy();
+    expect(getByText("Louis")).toBeTruthy();
+    expect(getByText("Lana")).toBeTruthy();
+    expect(getAllByRole("row").length - 1).toEqual(3);
+    var goToPageSelect = getAllByRole("button")[2];
+    (0, _react2.act)(function () {
+      _userEvent["default"].click(goToPageSelect);
+    });
+    var goToPageOption = getByText("2");
+    (0, _react2.act)(function () {
+      _userEvent["default"].click(goToPageOption);
+    });
+    expect(getByText("4 to 6 of 10")).toBeTruthy();
+    expect(getByText("Rick")).toBeTruthy();
+    expect(getByText("Mark")).toBeTruthy();
+    expect(getByText("Cris")).toBeTruthy();
+    expect(getAllByRole("row").length - 1).toEqual(3);
+  });
+  test("Resultsettable going to the last page shows only one row", function () {
+    var _render5 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3
+    })),
+        getByText = _render5.getByText,
+        getAllByRole = _render5.getAllByRole;
+
+    var lastButton = getAllByRole("button")[3];
+
+    _react2.fireEvent.click(lastButton);
+
+    expect(getByText("10 to 10 of 10")).toBeTruthy();
+    expect(getAllByRole("row")).toHaveLength(2);
+    expect(getByText("Cosmin")).toBeTruthy();
+  });
+  test("Resultsettable sort rows by column", function () {
+    var component = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3
+    }));
+    expect(component.queryByText("Peter")).toBeTruthy();
+
+    _react2.fireEvent.click(component.queryByText("Name"));
+
+    expect(component.queryByText("Tina")).not.toBeTruthy();
+    expect(component.queryByText("Cosmin")).toBeTruthy();
+
+    _react2.fireEvent.click(component.queryByText("Name"));
+
+    expect(component.queryByText("Tina")).toBeTruthy();
+    expect(component.queryByText("Cosmin")).not.toBeTruthy();
+  });
+  test("Resultsettable change rows should go to first page", function () {
+    var _render6 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3
+    })),
+        queryByText = _render6.queryByText,
+        rerender = _render6.rerender;
+
+    expect(queryByText("Peter")).toBeTruthy();
+    rerender( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows2,
+      itemsPerPage: 3
+    }));
+    expect(queryByText("1 to 3 of 3")).toBeTruthy();
+  });
+  test("Resultsettable change itemsPerPage should go to first page", function () {
+    var _render7 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 3,
+      itemsPerPageOptions: [2, 3]
+    })),
+        getAllByRole = _render7.getAllByRole,
+        queryByText = _render7.queryByText,
+        rerender = _render7.rerender;
+
+    var lastButton = getAllByRole("button")[3];
+
+    _react2.fireEvent.click(lastButton);
+
+    expect(getAllByRole("row").length - 1).toEqual(1);
+    rerender( /*#__PURE__*/_react["default"].createElement(_ResultsetTable["default"], {
+      columns: columns,
+      rows: rows,
+      itemsPerPage: 6
+    }));
+    expect(getAllByRole("row").length - 1).toEqual(6);
+    expect(queryByText("Peter")).toBeTruthy();
+  });
+});

package/row/types.d.ts

@@ -1,10 +1,28 @@
 /// <reference types="react" />
 declare type Props = {
+    /**
+     * Space applied between each child.
+     */
     gutter?: "none" | "xxxsmall" | "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge" | "xxxlarge";
+    /**
+     * Alignment applied to children.
+     */
     align?: "start" | "center" | "end" | "baseline" | "stretch";
+    /**
+     * Justification applied to children.
+     */
     justify?: "start" | "center" | "end" | "spaceBetween" | "spaceAround" | "spaceEvenly";
+    /**
+     * If true, children will wrap onto multiple rows.
+     */
     wrap?: boolean;
+    /**
+     * If true, children are shown in reverse order.
+     */
     reverse?: boolean;
+    /**
+     * Custom content inside the row.
+     */
     children: React.ReactNode;
 };
 export default Props;

package/select/Icons.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+declare const selectIcons: {
+    error: JSX.Element;
+    arrowUp: JSX.Element;
+    arrowDown: JSX.Element;
+    clear: JSX.Element;
+    selected: JSX.Element;
+    searchOff: JSX.Element;
+};
+export default selectIcons;

package/select/Icons.js

@@ -0,0 +1,93 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var selectIcons = {
+  error: /*#__PURE__*/_react["default"].createElement("svg", {
+    role: "img",
+    xmlns: "http://www.w3.org/2000/svg",
+    height: "24px",
+    viewBox: "0 0 24 24",
+    width: "24px",
+    fill: "currentColor"
+  }, /*#__PURE__*/_react["default"].createElement("path", {
+    d: "M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-2h2v2zm0-4h-2V7h2v6z"
+  })),
+  arrowUp: /*#__PURE__*/_react["default"].createElement("svg", {
+    role: "img",
+    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 0h24v24H0V0z",
+    fill: "none"
+  }), /*#__PURE__*/_react["default"].createElement("path", {
+    d: "M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6 1.41 1.41z"
+  })),
+  arrowDown: /*#__PURE__*/_react["default"].createElement("svg", {
+    role: "img",
+    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 0h24v24H0V0z",
+    fill: "none"
+  }), /*#__PURE__*/_react["default"].createElement("path", {
+    d: "M7.41 8.59L12 13.17l4.59-4.58L18 10l-6 6-6-6 1.41-1.41z"
+  })),
+  clear: /*#__PURE__*/_react["default"].createElement("svg", {
+    role: "img",
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "24",
+    height: "24",
+    viewBox: "0 0 24 24",
+    fill: "currentColor"
+  }, /*#__PURE__*/_react["default"].createElement("path", {
+    d: "M0 0h24v24H0V0z",
+    fill: "none"
+  }), /*#__PURE__*/_react["default"].createElement("path", {
+    d: "M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"
+  })),
+  selected: /*#__PURE__*/_react["default"].createElement("svg", {
+    role: "img",
+    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: "M9 16.2L4.8 12l-1.4 1.4L9 19 21 7l-1.4-1.4L9 16.2z"
+  })),
+  searchOff: /*#__PURE__*/_react["default"].createElement("svg", {
+    role: "img",
+    xmlns: "http://www.w3.org/2000/svg",
+    height: "24px",
+    viewBox: "0 0 24 24",
+    width: "24px",
+    fill: "currentColor"
+  }, /*#__PURE__*/_react["default"].createElement("g", null, /*#__PURE__*/_react["default"].createElement("rect", {
+    fill: "none",
+    height: "24",
+    width: "24"
+  })), /*#__PURE__*/_react["default"].createElement("g", null, /*#__PURE__*/_react["default"].createElement("g", null, /*#__PURE__*/_react["default"].createElement("path", {
+    d: "M15.5,14h-0.79l-0.28-0.27C15.41,12.59,16,11.11,16,9.5C16,5.91,13.09,3,9.5,3C6.08,3,3.28,5.64,3.03,9h2.02 C5.3,6.75,7.18,5,9.5,5C11.99,5,14,7.01,14,9.5S11.99,14,9.5,14c-0.17,0-0.33-0.03-0.5-0.05v2.02C9.17,15.99,9.33,16,9.5,16 c1.61,0,3.09-0.59,4.23-1.57L14,14.71v0.79l5,4.99L20.49,19L15.5,14z"
+  }), /*#__PURE__*/_react["default"].createElement("polygon", {
+    points: "6.47,10.82 4,13.29 1.53,10.82 0.82,11.53 3.29,14 0.82,16.47 1.53,17.18 4,14.71 6.47,17.18 7.18,16.47 4.71,14 7.18,11.53"
+  }))))
+};
+var _default = selectIcons;
+exports["default"] = _default;

package/select/Listbox.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { ListboxProps } from "./types";
+declare const _default: React.MemoExoticComponent<React.ForwardRefExoticComponent<ListboxProps & React.RefAttributes<HTMLUListElement>>>;
+export default _default;