@pingux/astro 1.27.0-alpha.24 → 1.27.0-alpha.26

package/lib/components/FieldHelperText/FieldHelperText.js

@@ -0,0 +1,44 @@
+import _Object$values from "@babel/runtime-corejs3/core-js-stable/object/values";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
+var _excluded = ["className", "status"];
+import React, { forwardRef } from 'react';
+import PropTypes from 'prop-types';
+import { useStatusClasses } from '../../hooks';
+import statuses from '../../utils/devUtils/constants/statuses';
+import Text from '../Text';
+/**
+ * Displays a styled message.
+ *
+ * **NOTE**: Specialized field components contain built-in support for helper text. It's
+ * recommended to use those instead of a standalone `FieldHelperText`.
+ */
+
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var FieldHelperText = /*#__PURE__*/forwardRef(function (props, ref) {
+  var className = props.className,
+      status = props.status,
+      others = _objectWithoutProperties(props, _excluded);
+
+  var _useStatusClasses = useStatusClasses(className, _defineProperty({}, "is-".concat(status), true)),
+      classNames = _useStatusClasses.classNames;
+
+  return ___EmotionJSX(Text, _extends({
+    ref: ref,
+    pt: "sm",
+    variant: "fieldHelperText",
+    role: "status"
+  }, others, {
+    className: classNames
+  }));
+});
+FieldHelperText.propTypes = {
+  /** Determines the color of the field message. */
+  status: PropTypes.oneOf(_Object$values(statuses))
+};
+FieldHelperText.defaultProps = {
+  status: statuses.DEFAULT
+};
+FieldHelperText.displayName = 'FieldHelperText';
+export default FieldHelperText;

package/lib/components/FieldHelperText/FieldHelperText.stories.js

@@ -0,0 +1,35 @@
+import React from 'react';
+import FieldHelperText from '.';
+import statuses from '../../utils/devUtils/constants/statuses';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export default {
+  title: 'Form/Base Components/FieldHelperText',
+  component: FieldHelperText,
+  argTypes: {
+    status: {
+      control: {
+        type: 'select',
+        options: statuses
+      },
+      defaultValue: statuses.DEFAULT
+    }
+  }
+};
+export var Default = function Default(args) {
+  return ___EmotionJSX(FieldHelperText, args, "Look at me!");
+};
+export var Error = function Error() {
+  return ___EmotionJSX(FieldHelperText, {
+    status: "error"
+  }, "Look at me!");
+};
+export var Success = function Success() {
+  return ___EmotionJSX(FieldHelperText, {
+    status: "success"
+  }, "Look at me!");
+};
+export var Warning = function Warning() {
+  return ___EmotionJSX(FieldHelperText, {
+    status: "warning"
+  }, "Look at me!");
+};

package/lib/components/FieldHelperText/FieldHelperText.test.js

@@ -0,0 +1,52 @@
+import _Object$values from "@babel/runtime-corejs3/core-js-stable/object/values";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import React from 'react';
+import axeTest from '../../utils/testUtils/testAxe';
+import { render, screen } from '../../utils/testUtils/testWrapper';
+import FieldHelperText from '.';
+import statuses from '../../utils/devUtils/constants/statuses';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var testId = 'test-field';
+var children = 'example text';
+var defaultProps = {
+  'data-testid': testId,
+  children: children
+};
+
+var getComponent = function getComponent() {
+  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+
+  var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+      _ref$renderFn = _ref.renderFn,
+      renderFn = _ref$renderFn === void 0 ? render : _ref$renderFn;
+
+  return renderFn(___EmotionJSX(FieldHelperText, _extends({}, defaultProps, props)));
+}; // Need to be added to each test file to test accessibility using axe.
+
+
+axeTest(getComponent);
+test('basic field message', function () {
+  getComponent();
+  var fieldHelperText = screen.getByText(children);
+  expect(fieldHelperText).toHaveAttribute('data-testid', testId);
+  expect(fieldHelperText).toHaveClass("is-".concat(statuses.DEFAULT));
+  expect(fieldHelperText).toBeInTheDocument();
+});
+test('status field message', function () {
+  var _context;
+
+  var _getComponent = getComponent(),
+      rerender = _getComponent.rerender;
+
+  var fieldHelperText = screen.getByText(children);
+
+  _forEachInstanceProperty(_context = _Object$values(statuses)).call(_context, function (status) {
+    getComponent({
+      status: status
+    }, {
+      renderFn: rerender
+    });
+    expect(fieldHelperText).toHaveClass("is-".concat(status));
+  });
+});

package/lib/components/FieldHelperText/index.js

@@ -0,0 +1 @@
+export { default } from './FieldHelperText';

package/lib/components/FileInputField/FileInputField.js

@@ -0,0 +1,284 @@
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
+import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _Object$getOwnPropertyDescriptor from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor";
+import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
+import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
+import _Object$values from "@babel/runtime-corejs3/core-js-stable/object/values";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import _URL from "@babel/runtime-corejs3/core-js-stable/url";
+import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/map";
+import _sliceInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/slice";
+import _Array$from from "@babel/runtime-corejs3/core-js-stable/array/from";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
+var _excluded = ["defaultButtonText", "defaultFileList", "fileList", "helperText", "isDisabled", "isLoading", "isMultiple", "onFileSelect", "onRemove", "status", "textProps"];
+
+function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = _filterInstanceProperty(symbols).call(symbols, function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context2, _context3; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context2 = ownKeys(Object(source), !0)).call(_context2, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context3 = ownKeys(Object(source))).call(_context3, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+import React, { forwardRef, useCallback, useImperativeHandle, useMemo, useRef, useState } from 'react';
+import { useVisuallyHidden } from '@react-aria/visually-hidden';
+import { useDropzone } from 'react-dropzone';
+import PropTypes from 'prop-types';
+import { mergeProps } from '@react-aria/utils';
+import { v4 as uuidv4 } from 'uuid';
+import { Box, Input, FieldHelperText, Label, Loader } from '../../index';
+import FileItem from './FileItem';
+import FileSelect from './FileSelect';
+import useStatusClasses from '../../hooks/useStatusClasses';
+import useField from '../../hooks/useField';
+import statuses from '../../utils/devUtils/constants/statuses';
+/**
+ * The FileInputField component allows users to upload one or more files by
+ * clicking the button or via drag and drop.
+ *
+ * We utilize [react-dropzone](https://react-dropzone.js.org/) for the drag and drop functionality.
+ * */
+
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var FileInputField = /*#__PURE__*/forwardRef(function (props, ref) {
+  var defaultButtonText = props.defaultButtonText,
+      defaultFileList = props.defaultFileList,
+      uploadedFilesImperative = props.fileList,
+      helperText = props.helperText,
+      isDisabled = props.isDisabled,
+      isLoading = props.isLoading,
+      isMultiple = props.isMultiple,
+      onFileSelect = props.onFileSelect,
+      onRemove = props.onRemove,
+      status = props.status,
+      textProps = props.textProps,
+      others = _objectWithoutProperties(props, _excluded);
+
+  var _useState = useState(defaultFileList || []),
+      _useState2 = _slicedToArray(_useState, 2),
+      uploadedFiles = _useState2[0],
+      setUploadedFiles = _useState2[1];
+
+  var inputRef = useRef();
+  /* istanbul ignore next */
+
+  useImperativeHandle(ref, function () {
+    return inputRef.current;
+  });
+
+  var _useField = useField(_objectSpread({
+    status: status,
+    isDisabled: isDisabled
+  }, others)),
+      fieldContainerProps = _useField.fieldContainerProps,
+      fieldControlProps = _useField.fieldControlProps,
+      fieldLabelProps = _useField.fieldLabelProps;
+
+  var _useVisuallyHidden = useVisuallyHidden(),
+      visuallyHiddenProps = _useVisuallyHidden.visuallyHiddenProps;
+
+  var handleFileSelect = useCallback(function () {
+    inputRef.current.value = null;
+    inputRef.current.click();
+  }, [inputRef]);
+  var handleFileUpload = useCallback(function (event, newFiles) {
+    if (onFileSelect) {
+      onFileSelect(event, newFiles);
+    }
+
+    var arrayWithNewFiles = _Array$from(newFiles);
+
+    if (!isMultiple) {
+      arrayWithNewFiles = _sliceInstanceProperty(arrayWithNewFiles).call(arrayWithNewFiles, 0, 1);
+    }
+
+    var newFilesWithIdAndLink = _mapInstanceProperty(arrayWithNewFiles).call(arrayWithNewFiles, function (newFile) {
+      return {
+        fileObj: newFile,
+        name: newFile.name,
+        id: uuidv4(),
+        downloadLink: _URL.createObjectURL(newFile),
+        status: statuses.DEFAULT
+      };
+    });
+
+    if (isMultiple) {
+      setUploadedFiles(function (prevFiles) {
+        var _context;
+
+        return _concatInstanceProperty(_context = []).call(_context, prevFiles, newFilesWithIdAndLink);
+      });
+    } else {
+      setUploadedFiles(newFilesWithIdAndLink);
+    }
+  }, [isMultiple, onFileSelect]);
+  var onDrop = useCallback(function (acceptedFiles, fileRejections, event) {
+    handleFileUpload(event, acceptedFiles);
+  }, [handleFileUpload]);
+
+  var _useDropzone = useDropzone({
+    onDrop: onDrop,
+    noKeyboard: true,
+    disabled: isDisabled || isLoading
+  }),
+      getRootProps = _useDropzone.getRootProps,
+      getInputProps = _useDropzone.getInputProps,
+      isDragActive = _useDropzone.isDragActive;
+
+  var handleOnChange = useCallback(function (event) {
+    handleFileUpload(event, event.target.files);
+  }, [handleFileUpload]);
+  var handleFileDelete = useCallback(function (e, fileId) {
+    if (onRemove) {
+      onRemove(e, fileId);
+    }
+
+    setUploadedFiles(function (prevFiles) {
+      return _filterInstanceProperty(prevFiles).call(prevFiles, function (_ref) {
+        var id = _ref.id;
+        return id !== fileId;
+      });
+    });
+  }, [onRemove]);
+  var filesListNode = useMemo(function () {
+    var filesToRender = uploadedFilesImperative || uploadedFiles;
+
+    if (!(filesToRender !== null && filesToRender !== void 0 && filesToRender.length)) {
+      return null;
+    }
+
+    return _mapInstanceProperty(filesToRender).call(filesToRender, function (fileProps) {
+      return ___EmotionJSX(FileItem, _extends({
+        handleFileDelete: handleFileDelete,
+        isDisabled: isDisabled || isLoading,
+        key: fileProps.id,
+        textProps: textProps
+      }, fileProps));
+    });
+  }, [uploadedFilesImperative, uploadedFiles, handleFileDelete, isDisabled, isLoading, textProps]);
+
+  var _useStatusClasses = useStatusClasses('fileInputFieldWrapper', _defineProperty({
+    isDragActive: isDragActive,
+    isLoading: isLoading
+  }, "is-".concat(status), true)),
+      classNames = _useStatusClasses.classNames;
+
+  var shouldFileSelectRender = useCallback(function () {
+    var isFileUploaded;
+
+    if (uploadedFilesImperative) {
+      isFileUploaded = Boolean(uploadedFilesImperative === null || uploadedFilesImperative === void 0 ? void 0 : uploadedFilesImperative.length);
+    } else {
+      isFileUploaded = Boolean(uploadedFiles === null || uploadedFiles === void 0 ? void 0 : uploadedFiles.length);
+    }
+
+    return isMultiple || !isFileUploaded;
+  }, [uploadedFiles, uploadedFilesImperative, isMultiple]);
+  return ___EmotionJSX(React.Fragment, null, ___EmotionJSX(Label, fieldLabelProps), ___EmotionJSX(Box, _extends({
+    variant: "boxes.fileInputFieldWrapper"
+  }, mergeProps(fieldContainerProps, others), {
+    className: classNames
+  }, getRootProps(), {
+    // to pass accessibility test, this removes focusable dependents
+    role: "none"
+  }), ___EmotionJSX(Input, _extends({}, mergeProps(visuallyHiddenProps, fieldControlProps, getInputProps()), {
+    "aria-label": "File Input",
+    multiple: isMultiple,
+    onChange: handleOnChange,
+    ref: inputRef,
+    type: "file"
+  })), filesListNode, shouldFileSelectRender() && ___EmotionJSX(FileSelect, {
+    buttonText: defaultButtonText,
+    handleFileSelect: handleFileSelect,
+    isDisabled: isDisabled || isLoading,
+    textProps: textProps
+  }), isLoading && ___EmotionJSX(Loader, {
+    color: "active",
+    sx: {
+      position: 'absolute'
+    },
+    "data-testid": "file-input-field__loader"
+  })), helperText && ___EmotionJSX(FieldHelperText, {
+    status: status
+  }, helperText));
+});
+FileInputField.displayName = 'FileInputField';
+FileInputField.propTypes = {
+  /** The rendered label for the field. */
+  label: PropTypes.node,
+
+  /** Text rendered below the input. */
+  helperText: PropTypes.node,
+
+  /** Determines the component border status color indicator and helper text styling. */
+  status: PropTypes.oneOf(_Object$values(statuses)),
+
+  /** Default button text that will be changed on the file name once file is uploaded */
+  defaultButtonText: PropTypes.string,
+
+  /** Defines whether input can accept multiple files or not */
+  isMultiple: PropTypes.bool,
+
+  /** Determines whether the loading indicator is shown. */
+  isLoading: PropTypes.bool,
+
+  /** Whether the field is disabled. */
+  isDisabled: PropTypes.bool,
+
+  /** Array of objects for uploaded files.
+   * Objects should have the following structure:
+   *
+   * {
+   *
+   *  fileObj: File object (optional),
+   *
+   *  id: file id (required - will be returned on delete),
+   *
+   *  name: file name that will be displayed (required - will be displayed),
+   *
+   *  downloadLink: link for the file download (optional),
+   *
+   *  status: file status (if error - icon of the
+   *  component will be red icon and warning sign)(optional),
+   *
+   * }
+   * */
+  fileList: PropTypes.arrayOf(PropTypes.shape({
+    fileObj: PropTypes.shape({}),
+    id: PropTypes.string.isRequired,
+    name: PropTypes.string.isRequired,
+    downloadLink: PropTypes.string,
+    status: PropTypes.oneOf(_Object$values(statuses))
+  })),
+
+  /** Default array of objects for uploaded files. */
+  defaultFileList: PropTypes.arrayOf(PropTypes.shape({
+    fileObj: PropTypes.shape({}),
+    id: PropTypes.string.isRequired,
+    name: PropTypes.string.isRequired,
+    downloadLink: PropTypes.string,
+    status: PropTypes.oneOf(_Object$values(statuses))
+  })),
+
+  /** The handler that is called when the input files is uploaded.
+   *
+   * `(event, files) => void`
+   * */
+  onFileSelect: PropTypes.func,
+
+  /** The handler that is called when an uploaded file got removed.
+   *
+   * `(fileId) => void`
+   * */
+  onRemove: PropTypes.func,
+
+  /** These props will be spread to the field text component. */
+  textProps: PropTypes.shape({})
+};
+FileInputField.defaultProps = {
+  defaultButtonText: 'Select a file',
+  status: statuses.DEFAULT
+};
+export default FileInputField;

package/lib/components/FileInputField/FileInputField.stories.js

@@ -0,0 +1,206 @@
+import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import React, { useState } from 'react';
+import { v4 as uuidv4 } from 'uuid';
+import FileInputField from './';
+import { Box } from '../../index';
+import statuses from '../../utils/devUtils/constants/statuses';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export default {
+  title: 'Form/FileInputField',
+  component: FileInputField,
+  parameters: {
+    docs: {
+      source: {
+        type: 'code'
+      }
+    }
+  },
+  argTypes: {
+    label: {
+      control: {
+        type: 'text'
+      },
+      defaultValue: 'Field Label'
+    },
+    helperText: {
+      control: {
+        type: 'text'
+      }
+    },
+    status: {
+      control: {
+        type: 'select',
+        options: statuses
+      },
+      defaultValue: statuses.DEFAULT
+    },
+    defaultButtonText: {
+      control: {
+        type: 'text'
+      }
+    },
+    isMultiple: {
+      control: {
+        type: 'boolean'
+      }
+    },
+    isLoading: {
+      control: {
+        type: 'boolean'
+      }
+    },
+    isDisabled: {
+      control: {
+        type: 'boolean'
+      }
+    },
+    fileList: {
+      control: {
+        type: 'none'
+      }
+    },
+    defaultFileList: {
+      control: {
+        type: 'none'
+      }
+    },
+    textProps: {
+      control: {
+        type: 'none'
+      }
+    }
+  }
+};
+var fitContentWidthSx = {
+  width: 'fit-content'
+};
+export var Default = function Default(args) {
+  return ___EmotionJSX(FileInputField, _extends({
+    sx: fitContentWidthSx
+  }, args));
+};
+export var CustomButtonText = function CustomButtonText() {
+  return ___EmotionJSX(FileInputField, {
+    defaultButtonText: "Original Button Name",
+    label: "Custom Button Text",
+    sx: fitContentWidthSx
+  });
+};
+export var ControlledState = function ControlledState() {
+  var _useState = useState([]),
+      _useState2 = _slicedToArray(_useState, 2),
+      userFiles = _useState2[0],
+      setUserFiles = _useState2[1];
+
+  var _useState3 = useState(),
+      _useState4 = _slicedToArray(_useState3, 2),
+      error = _useState4[0],
+      setError = _useState4[1];
+
+  var handleFileSelect = function handleFileSelect(event, files) {
+    // this is approximate conversion just for an example
+    var uploadedFileSizeMb = files[0].size / 1e6;
+
+    if (uploadedFileSizeMb > 2) {
+      setError('Only files under 2 MB can be uploaded.');
+    } else {
+      setUserFiles([{
+        id: uuidv4(),
+        name: files[0].name,
+        downloadLink: 'link for testing purposes'
+      }]);
+      setError(null);
+    }
+  }; // you would want to handle this differently in case you have multiple files
+
+
+  var handleFileRemove = function handleFileRemove() {
+    setUserFiles([]);
+    setError(null);
+  };
+
+  return ___EmotionJSX(FileInputField, {
+    label: "Controlled State With limit on file size upload below 2 mb",
+    onFileSelect: handleFileSelect,
+    onRemove: handleFileRemove,
+    fileList: userFiles,
+    sx: fitContentWidthSx,
+    status: error && statuses.ERROR,
+    helperText: error
+  });
+};
+export var DefaultFileListUncontrolled = function DefaultFileListUncontrolled() {
+  return ___EmotionJSX(FileInputField, {
+    defaultFileList: [{
+      id: 'test-id1',
+      name: 'PingId Mobile (Android)',
+      downloadLink: 'https://download.pingidentity.com/public/PingID/android/PingID.apk'
+    }, {
+      id: 'test-id2',
+      name: 'PingId Desktop (macOS)',
+      downloadLink: 'https://downloads.pingidentity.com/pingid/mac-client/PingID.pkg'
+    }, {
+      id: 'test-id3',
+      name: 'PingId Desktop (Windows)',
+      downloadLink: 'https://download.pingidentity.com/public/PingID/PingID_1.7.2.zip'
+    }],
+    isMultiple: true,
+    label: "Uncontrolled File List with default files",
+    sx: fitContentWidthSx
+  });
+};
+export var ErrorStatusSingleFile = function ErrorStatusSingleFile() {
+  return ___EmotionJSX(FileInputField, {
+    defaultFileList: [{
+      id: 'test-id3',
+      name: 'PingId Desktop (Windows)',
+      downloadLink: 'https://download.pingidentity.com/public/PingID/PingID_1.7.2.zip',
+      status: statuses.ERROR
+    }],
+    label: "Error Status Single File",
+    sx: fitContentWidthSx,
+    helperText: "There is an error",
+    status: statuses.ERROR
+  });
+};
+export var ErrorWithMultipleFiles = function ErrorWithMultipleFiles() {
+  return ___EmotionJSX(FileInputField, {
+    defaultFileList: [{
+      id: 'test-id3',
+      name: 'PingId Desktop (Windows)',
+      downloadLink: 'https://download.pingidentity.com/public/PingID/PingID_1.7.2.zip',
+      status: statuses.ERROR
+    }, {
+      id: 'test-id2',
+      name: 'PingId Desktop (macOS)',
+      downloadLink: 'https://downloads.pingidentity.com/pingid/mac-client/PingID.pkg'
+    }],
+    label: "Error Status With Multiple Files but without a red border",
+    sx: fitContentWidthSx,
+    helperText: "There is an error but helperText text will be default since no status passed",
+    isMultiple: true
+  });
+};
+export var WithCustomWidth = function WithCustomWidth() {
+  var textSx = {
+    textOverflow: 'ellipsis',
+    overflow: 'hidden',
+    whiteSpace: 'nowrap'
+  };
+  return ___EmotionJSX(Box, {
+    width: 200
+  }, ___EmotionJSX(FileInputField, {
+    defaultButtonText: "Long Long Button Text With A Lot of Words In It",
+    defaultFileList: [{
+      id: 'test-id1',
+      name: 'Really Long File Name That Cant Fit',
+      downloadLink: 'https://download.pingidentity.com/public/PingID/android/PingID.apk'
+    }],
+    label: "Custom Width",
+    textProps: {
+      sx: textSx
+    },
+    isMultiple: true
+  }));
+};