@pingux/astro 1.17.0-alpha.3 → 1.17.0

package/lib/components/RadioField/RadioField.js

@@ -0,0 +1,165 @@
+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 _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+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 _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+
+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 _context, _context2; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(source), !0)).call(_context, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context2 = ownKeys(Object(source))).call(_context2, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+import React, { forwardRef, createContext, useContext, useRef, useImperativeHandle } from 'react';
+import PropTypes from 'prop-types';
+import { useRadio } from '@react-aria/radio';
+import { useField, usePropWarning } from '../../hooks';
+import statuses from '../../utils/devUtils/constants/statuses';
+import Box from '../Box';
+import Radio from '../Radio';
+import Label from '../Label';
+import FieldHelperText from '../FieldHelperText';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export var RadioContext = /*#__PURE__*/createContext();
+/**
+ * Combines a radio, label, and helper text for a complete, form-ready solution.
+ *
+ * Utilizes [useRadio](https://react-spectrum.adobe.com/react-aria/useRadioGroup.html) from React
+ * Aria.
+ */
+
+var RadioField = /*#__PURE__*/forwardRef(function (props, ref) {
+  var checkedContent = props.checkedContent,
+      controlProps = props.controlProps,
+      hasAutoFocus = props.hasAutoFocus,
+      helperText = props.helperText,
+      radioDisabled = props.isDisabled,
+      label = props.label,
+      status = props.status;
+  var radioFieldRef = useRef();
+  usePropWarning(props, 'disabled', 'isDisabled');
+  /* istanbul ignore next */
+
+  useImperativeHandle(ref, function () {
+    return radioFieldRef.current;
+  });
+  var state = useContext(RadioContext);
+  var groupDisabled = state.isDisabled;
+  var isDisabled = radioDisabled || groupDisabled;
+
+  var _useRadio = useRadio(_objectSpread(_objectSpread({
+    children: label,
+    autoFocus: hasAutoFocus,
+    isDisabled: isDisabled
+  }, props), controlProps), state, radioFieldRef),
+      inputProps = _useRadio.inputProps;
+
+  var isChecked = inputProps.checked;
+  var statusClasses = {
+    isDisabled: isDisabled,
+    isChecked: isChecked
+  };
+
+  var _useField = useField(_objectSpread(_objectSpread({
+    statusClasses: statusClasses
+  }, props), {}, {
+    controlProps: _objectSpread(_objectSpread({}, controlProps), inputProps)
+  })),
+      fieldContainerProps = _useField.fieldContainerProps,
+      fieldControlProps = _useField.fieldControlProps,
+      fieldLabelProps = _useField.fieldLabelProps;
+
+  return ___EmotionJSX(Box, _extends({
+    variant: "forms.radioField"
+  }, fieldContainerProps), ___EmotionJSX(Label, _extends({
+    variant: "forms.label.radio"
+  }, fieldLabelProps), ___EmotionJSX(Radio, _extends({
+    ref: radioFieldRef
+  }, fieldControlProps)), label), helperText && ___EmotionJSX(FieldHelperText, {
+    status: status
+  }, helperText), isChecked && checkedContent && ___EmotionJSX(Box, {
+    variant: "boxes.radioCheckedContent"
+  }, checkedContent));
+});
+RadioField.propTypes = {
+  /** Content to display when the radio is checked. */
+  checkedContent: PropTypes.node,
+
+  /** The rendered label for the field. */
+  label: PropTypes.node,
+
+  /** Whether the element should receive focus on render. */
+  hasAutoFocus: PropTypes.bool,
+
+  /** Text rendered below the input. */
+  helperText: PropTypes.node,
+
+  /** If present this prop will cause a help hint to render in the label of the field. */
+  hintText: PropTypes.string,
+
+  /** The element's unique identifier. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id). */
+  id: PropTypes.string,
+
+  /**
+   * Whether the radio button is disabled or not. Shows that a selection exists, but is not
+   * available in that circumstance.
+  */
+  isDisabled: PropTypes.bool,
+
+  /** Whether the Radio can be interacted with but cannot have its selection state changed. */
+  isReadOnly: PropTypes.bool,
+
+  /** Whether the Radio is required. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required). */
+  isRequired: PropTypes.bool,
+
+  /** Determines the textarea status indicator and helper text styling. */
+  status: PropTypes.oneOf(_Object$values(statuses)),
+
+  /** The value of the input element, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefvalue). */
+  value: PropTypes.string,
+
+  /** Handler that is called when the element receives focus. */
+  onFocus: PropTypes.func,
+
+  /** Handler that is called when the element loses focus. */
+  onBlur: PropTypes.func,
+
+  /** Handler that is called when the element's focus status changes. */
+  onFocusChange: PropTypes.func,
+
+  /** Handler that is called when a key is pressed. */
+  onKeyDown: PropTypes.func,
+
+  /** Handler that is called when a key is released. */
+  onKeyUp: PropTypes.func,
+
+  /** Defines a string value that labels the current element. */
+  'aria-label': PropTypes.string,
+
+  /** Identifies the element (or elements) that labels the current element. */
+  'aria-labelledby': PropTypes.string,
+
+  /** Identifies the element (or elements) that describes the object. */
+  'aria-describedby': PropTypes.string,
+
+  /**
+   * Identifies the element (or elements) that provide a detailed, extended description for the
+   * object.
+  */
+  'aria-details': PropTypes.string,
+
+  /** Props object that is spread directly into the root (top-level) element. */
+  containerProps: PropTypes.shape({}),
+
+  /** Props object that is spread directly into the input element. */
+  controlProps: PropTypes.shape({}),
+
+  /** Props object that is spread directly into the label element. */
+  labelProps: PropTypes.shape({})
+};
+RadioField.displayName = 'RadioField';
+export default RadioField;

package/lib/components/RadioField/RadioField.test.js

@@ -0,0 +1,74 @@
+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 RadioField, { RadioContext } from './RadioField';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var testId = 'test-radio';
+var testLabel = 'Test Label';
+var testValue = 'test';
+var defaultProps = {
+  'data-testid': testId,
+  label: testLabel,
+  controlProps: {
+    'data-testid': "".concat(testId, "-input")
+  },
+  value: testValue
+};
+var defaultState = {
+  setLastFocusedValue: function setLastFocusedValue() {}
+};
+
+var getComponent = function getComponent() {
+  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var state = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : defaultState;
+  return render(___EmotionJSX(RadioContext.Provider, {
+    value: state
+  }, ___EmotionJSX(RadioField, _extends({}, defaultProps, props))));
+};
+
+afterEach(function () {
+  jest.restoreAllMocks();
+}); // Need to be added to each test file to test accessibility using axe.
+
+axeTest(getComponent);
+test('default radio', function () {
+  getComponent();
+  var container = screen.getByTestId(testId);
+  var input = screen.getByLabelText(testLabel);
+  var label = screen.getByText(testLabel);
+  expect(container).toBeInstanceOf(HTMLDivElement);
+  expect(input).toBeInstanceOf(HTMLInputElement);
+  expect(label).toBeInstanceOf(HTMLLabelElement);
+  expect(container).toBeInTheDocument();
+  expect(input).toBeInTheDocument();
+  expect(label).toBeInTheDocument();
+});
+test('disabled radio', function () {
+  getComponent({
+    isDisabled: true
+  });
+  var label = screen.getByText(testLabel);
+  var input = screen.getByLabelText(testLabel);
+  var icon = input.nextSibling;
+  expect(label).toHaveClass('is-disabled');
+  expect(icon).toHaveClass('is-disabled');
+});
+test('radio with checked content does not display if not checked', function () {
+  var testContent = 'test content';
+  getComponent({
+    checkedContent: ___EmotionJSX("div", null, testContent)
+  });
+  var content = screen.queryByText(testContent);
+  expect(content).not.toBeInTheDocument();
+});
+test('radio with checked content displays if checked', function () {
+  var testContent = 'test content';
+  getComponent({
+    checkedContent: ___EmotionJSX("div", null, testContent)
+  }, {
+    selectedValue: testValue
+  });
+  var content = screen.queryByText(testContent);
+  expect(content).toBeInTheDocument();
+});

package/lib/components/RadioField/index.js

@@ -0,0 +1,2 @@
+export { default } from './RadioField';
+export * from './RadioField';

package/lib/components/RadioGroupField/RadioGroupField.js

@@ -0,0 +1,145 @@
+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 _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+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 _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+
+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 _context, _context2; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(source), !0)).call(_context, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context2 = ownKeys(Object(source))).call(_context2, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+import React, { forwardRef } from 'react';
+import PropTypes from 'prop-types';
+import { useRadioGroup } from '@react-aria/radio';
+import { useRadioGroupState } from '@react-stately/radio';
+import statuses from '../../utils/devUtils/constants/statuses';
+import Box from '../Box';
+import Label from '../Label';
+import { RadioContext } from '../RadioField';
+import FieldHelperText from '../FieldHelperText';
+import { useStatusClasses, usePropWarning } from '../../hooks';
+import ORIENTATION from '../../utils/devUtils/constants/orientation';
+/**
+ * Radio group component for a single-choice list of options.
+ *
+ * Utilizes [useRadioGroup](https://react-spectrum.adobe.com/react-aria/useRadioGroup.html) from
+ * React Aria and
+ * [useRadioGroupState](https://react-spectrum.adobe.com/react-stately/useRadioGroupState.html)
+ * from React Stately.
+ */
+
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var RadioGroupField = /*#__PURE__*/forwardRef(function (props, ref) {
+  var children = props.children,
+      className = props.className,
+      helperText = props.helperText,
+      isDisabled = props.isDisabled,
+      isRequired = props.isRequired,
+      hintText = props.hintText,
+      label = props.label,
+      orientation = props.orientation,
+      status = props.status;
+  var state = useRadioGroupState(props);
+
+  var _useRadioGroup = useRadioGroup(props, state),
+      radioGroupProps = _useRadioGroup.radioGroupProps,
+      labelProps = _useRadioGroup.labelProps;
+
+  var _useStatusClasses = useStatusClasses(className, {
+    'is-horizontal': orientation === ORIENTATION.HORIZONTAL
+  }),
+      classNames = _useStatusClasses.classNames;
+
+  usePropWarning(props, 'disabled', 'isDisabled');
+  return ___EmotionJSX(Box, _extends({
+    ref: ref,
+    className: classNames
+  }, radioGroupProps), ___EmotionJSX(Label, _extends({
+    isDisabled: isDisabled,
+    hintText: hintText,
+    isRequired: isRequired,
+    variant: "forms.label.radioGroup"
+  }, labelProps), label), ___EmotionJSX(Box, {
+    variant: "forms.radioGroupWrapper",
+    isRow: orientation === ORIENTATION.HORIZONTAL
+  }, ___EmotionJSX(RadioContext.Provider, {
+    value: _objectSpread({
+      isDisabled: isDisabled
+    }, state)
+  }, children)), helperText && ___EmotionJSX(FieldHelperText, {
+    status: status,
+    sx: {
+      pt: 'xs'
+    }
+  }, helperText));
+});
+RadioGroupField.propTypes = {
+  /** The name of the RadioGroupField, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name_and_radio_buttons). */
+  name: PropTypes.string,
+
+  /** The current value (controlled). */
+  value: PropTypes.string,
+
+  /** The default value (uncontrolled). */
+  defaultValue: PropTypes.string,
+
+  /** Text to display after the radio group label. Useful for errors or other info. */
+  helperText: PropTypes.node,
+
+  /** If present this prop will cause a help hint to render in the label of the field. */
+  hintText: PropTypes.string,
+
+  /** Determines the arrangement of the radios. */
+  orientation: PropTypes.oneOf(['horizontal', 'vertical']),
+
+  /** Determines the helper text styling. */
+  status: PropTypes.oneOf(_Object$values(statuses)),
+
+  /**
+   * Handler that is called when the value changes.
+   *
+   * `(newValue) => void`
+   */
+  onChange: PropTypes.func,
+
+  /** Whether the radio group is disabled. */
+  isDisabled: PropTypes.bool,
+
+  /** Whether user input is required on the input before form submission. */
+  isRequired: PropTypes.bool,
+
+  /**
+   * The content to display as the label. If not set, It is recommended to set an aria-label or
+   * aria-labelledby attribute for accessibility.
+  */
+  label: PropTypes.node,
+
+  /** The element's unique identifier. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id). */
+  id: PropTypes.string,
+
+  /** Defines a string value that labels the current element. */
+  'aria-label': PropTypes.string,
+
+  /** Identifies the element (or elements) that labels the current element. */
+  'aria-labelledby': PropTypes.string,
+
+  /** Identifies the element (or elements) that describes the object. */
+  'aria-describedby': PropTypes.string,
+
+  /**
+   * Identifies the element (or elements) that provide a detailed, extended description for the
+   * object.
+  */
+  'aria-details': PropTypes.string,
+
+  /** Identifies the element that provides an error message for the object. */
+  'aria-errormessage': PropTypes.string
+};
+RadioGroupField.displayName = 'RadioGroupField';
+export default RadioGroupField;

package/lib/components/RadioGroupField/RadioGroupField.stories.js

@@ -0,0 +1,171 @@
+import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
+import React, { useState } from 'react';
+import RadioGroupField from '.';
+import RadioField from '../RadioField';
+import statuses from '../../utils/devUtils/constants/statuses';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export default {
+  title: 'Form/RadioGroupField',
+  component: RadioGroupField,
+  argTypes: {
+    label: {
+      control: {
+        type: 'text'
+      },
+      defaultValue: 'Pick one'
+    },
+    helperText: {
+      control: {
+        type: 'text'
+      }
+    },
+    hintText: {
+      control: {
+        type: 'text'
+      }
+    },
+    status: {
+      control: {
+        type: 'select',
+        options: statuses
+      },
+      defaultValue: statuses.DEFAULT
+    },
+    defaultValue: {
+      defaultValue: 'A'
+    },
+    orientation: {},
+    isDisabled: {},
+    isRequired: {},
+    name: {},
+    id: {},
+    'aria-label': {
+      control: {
+        type: 'text'
+      }
+    },
+    'aria-labelledby': {
+      control: {
+        type: 'text'
+      }
+    },
+    'aria-describedby': {
+      control: {
+        type: 'text'
+      }
+    },
+    'aria-details': {
+      control: {
+        type: 'text'
+      }
+    },
+    'aria-errormessage': {
+      control: {
+        type: 'text'
+      }
+    },
+    value: {
+      control: {
+        type: 'none'
+      }
+    }
+  }
+};
+export var Default = function Default(args) {
+  return ___EmotionJSX(RadioGroupField, args, ___EmotionJSX(RadioField, {
+    value: "A",
+    label: "A"
+  }), ___EmotionJSX(RadioField, {
+    value: "B",
+    label: "B"
+  }), ___EmotionJSX(RadioField, {
+    value: "C",
+    label: "C"
+  }));
+};
+export var Controlled = function Controlled() {
+  var _useState = useState('A'),
+      _useState2 = _slicedToArray(_useState, 2),
+      value = _useState2[0],
+      setValue = _useState2[1];
+
+  return ___EmotionJSX(RadioGroupField, {
+    label: "Pick one",
+    value: value,
+    onChange: function onChange(newValue) {
+      return setValue(newValue);
+    }
+  }, ___EmotionJSX(RadioField, {
+    value: "A",
+    label: "A"
+  }), ___EmotionJSX(RadioField, {
+    value: "B",
+    label: "B"
+  }), ___EmotionJSX(RadioField, {
+    value: "C",
+    label: "C"
+  }));
+};
+export var Required = function Required() {
+  return ___EmotionJSX(RadioGroupField, {
+    label: "Pick one",
+    isRequired: true
+  }, ___EmotionJSX(RadioField, {
+    value: "A",
+    label: "A"
+  }), ___EmotionJSX(RadioField, {
+    value: "B",
+    label: "B"
+  }), ___EmotionJSX(RadioField, {
+    value: "C",
+    label: "C"
+  }));
+};
+export var CheckedContent = function CheckedContent() {
+  return ___EmotionJSX(RadioGroupField, {
+    label: "Pick one"
+  }, ___EmotionJSX(RadioField, {
+    value: "A",
+    label: "A",
+    checkedContent: "You chose A..."
+  }), ___EmotionJSX(RadioField, {
+    value: "B",
+    label: "B",
+    checkedContent: "You chose B..."
+  }), ___EmotionJSX(RadioField, {
+    value: "C",
+    label: "C",
+    checkedContent: "You chose C..."
+  }));
+};
+export var HelperText = function HelperText() {
+  return ___EmotionJSX(RadioGroupField, {
+    label: "Pick one",
+    helperText: "Here is some helpful text...",
+    status: "error"
+  }, ___EmotionJSX(RadioField, {
+    value: "A",
+    label: "A"
+  }), ___EmotionJSX(RadioField, {
+    value: "B",
+    label: "B"
+  }), ___EmotionJSX(RadioField, {
+    value: "C",
+    label: "C"
+  }));
+};
+export var HorizontalOrientation = function HorizontalOrientation() {
+  return ___EmotionJSX(RadioGroupField, {
+    label: "Pick one",
+    orientation: "horizontal"
+  }, ___EmotionJSX(RadioField, {
+    value: "A",
+    label: "A"
+  }), ___EmotionJSX(RadioField, {
+    value: "B",
+    label: "B"
+  }), ___EmotionJSX(RadioField, {
+    value: "C",
+    label: "C"
+  }));
+};