@pingux/astro 1.16.0-alpha.4 → 1.17.0-alpha.0

package/lib/cjs/components/Tab/Tab.js

@@ -52,6 +52,10 @@ function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "functi
 
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
+/**
+ * Tab control for dividing up closely-related content.
+ * Typically used as a child of the Tabs component.
+ */
 var CollectionTab = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
   var className = props.className,
       item = props.item,

package/lib/cjs/components/Tabs/Tabs.js

@@ -73,6 +73,10 @@ function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context6, _context7; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty2(_context6 = ownKeys(Object(source), !0)).call(_context6, function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty2(_context7 = ownKeys(Object(source))).call(_context7, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
 
 var TabsContext = /*#__PURE__*/_react["default"].createContext({});
+/**
+ * Tabs are used to divide content, navigate to other views, and indicate work progress.
+ */
+
 
 exports.TabsContext = TabsContext;
 var Tabs = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {

package/lib/components/ArrayField/ArrayField.js

@@ -32,6 +32,11 @@ import Text from '../Text';
 import Label from '../Label';
 import statuses from '../../utils/devUtils/constants/statuses';
 import isValidPositiveInt from '../../utils/devUtils/props/isValidPositiveInt';
+/**
+ * Displays array collections providing useful functions and
+ * optimizations for arrays.
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 
 var ArrayField = function ArrayField(props) {
@@ -77,7 +82,7 @@ var ArrayField = function ArrayField(props) {
     });
   }, []);
   var onFieldValueChange = useCallback(function (event, fieldId) {
-    var tempValue = event; // Checks if value receieved is a key or event
+    var tempValue = event; // Checks if value received is a key or event
 
     if (typeof event !== 'string') {
       tempValue = event.target.value;

package/lib/components/ArrayField/ArrayField.stories.js

@@ -9,6 +9,7 @@ import { ArrayField, ArrayFieldDeleteButton, Item, SelectField, TextField } from
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export default {
   title: 'Form/ArrayField',
+  component: ArrayField,
   parameters: {
     actions: {
       argTypesRegex: '^on.*'

package/lib/components/Button/Button.js

@@ -24,6 +24,12 @@ import { useFocusRing } from '@react-aria/focus';
 import { mergeProps } from '@react-aria/utils';
 import { useStatusClasses, usePropWarning, useAriaLabelWarning, useDeprecationWarning } from '../../hooks';
 import Loader from '../Loader';
+/**
+ * Buttons are used to trigger actions or events.
+ * This component is based on the [Button - Theme-UI](https://theme-ui.com/components/button/)
+ * and includes a variety of styles, such as primary action, secondary action, or warning.
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var Button = /*#__PURE__*/forwardRef(function (props, ref) {
   var className = props.className,

package/lib/components/ComboBoxField/ComboBoxField.js

@@ -11,13 +11,14 @@ import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
 import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
 import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
 var _excluded = ["shouldFocusOnHover", "shouldSelectOnPressUp"];
 
 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; }
+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, { useCallback, useRef, useState, forwardRef, useImperativeHandle } from 'react';
+import React, { useCallback, useRef, useState, forwardRef, useImperativeHandle, useEffect } from 'react';
 import PropTypes from 'prop-types';
 import { DismissButton, useOverlayPosition } from '@react-aria/overlays';
 import { useComboBox } from '@react-aria/combobox';
@@ -57,13 +58,14 @@ var ComboBoxField = /*#__PURE__*/forwardRef(function (props, ref) {
       onFocusChange = props.onFocusChange,
       onKeyDown = props.onKeyDown,
       onKeyUp = props.onKeyUp,
+      hasAddOption = props.hasAddOption,
       hasCustomValue = props.hasCustomValue,
       hasNoEmptySelection = props.hasNoEmptySelection,
       defaultSelectedKey = props.defaultSelectedKey,
       selectedKey = props.selectedKey,
       onSelectionChange = props.onSelectionChange,
-      defaultItems = props.defaultItems,
-      items = props.items,
+      initialDefaultItems = props.defaultItems,
+      initialItems = props.items,
       onOpenChange = props.onOpenChange,
       loadingState = props.loadingState,
       onLoadMore = props.onLoadMore,
@@ -91,13 +93,11 @@ var ComboBoxField = /*#__PURE__*/forwardRef(function (props, ref) {
     onFocusChange: onFocusChange,
     onKeyDown: onKeyDown,
     onKeyUp: onKeyUp,
-    allowsCustomValue: hasCustomValue,
+    allowsCustomValue: hasAddOption || hasCustomValue,
     disallowEmptySelection: hasNoEmptySelection,
     defaultSelectedKey: defaultSelectedKey,
     selectedKey: selectedKey,
     onSelectionChange: onSelectionChange,
-    defaultItems: defaultItems,
-    items: items,
     onOpenChange: onOpenChange,
     loadingState: loadingState,
     onLoadMore: onLoadMore,
@@ -123,18 +123,47 @@ var ComboBoxField = /*#__PURE__*/forwardRef(function (props, ref) {
 
   var onSelectionChangeHandler = function onSelectionChangeHandler(key) {
     var newVal = key || selectedKey || '';
+
+    if (hasAddOption && selectedKey !== inputValue) {
+      newVal = inputValue;
+    }
+
     if (onSelectionChange) onSelectionChange(newVal);
   };
 
+  var shouldShowAddOption = hasAddOption && inputValue && selectedKey !== inputValue;
+  var addOption = "ADD: ".concat(inputValue);
+
+  var getItemsArr = function getItemsArr(initialArr) {
+    if (initialArr && shouldShowAddOption) {
+      var _context;
+
+      return _concatInstanceProperty(_context = []).call(_context, initialArr, [{
+        name: addOption,
+        key: addOption
+      }]);
+    }
+
+    return initialArr;
+  };
+
+  var defaultItems = getItemsArr(initialDefaultItems);
+  var items = getItemsArr(initialItems);
+
   var _useFilter = useFilter({
     sensitivity: 'base'
   }),
       contains = _useFilter.contains;
 
   var state = useComboBoxState(_objectSpread(_objectSpread({}, comboBoxOptions), {}, {
-    onSelectionChange: hasCustomValue ? onSelectionChangeHandler : onSelectionChange,
+    defaultItems: defaultItems,
+    items: items,
+    onSelectionChange: hasAddOption || hasCustomValue ? onSelectionChangeHandler : onSelectionChange,
     defaultFilter: typeof defaultFilter !== 'undefined' ? defaultFilter : contains
   }));
+  useEffect(function () {
+    if (shouldShowAddOption) state.selectionManager.setFocusedKey(addOption);
+  }, [shouldShowAddOption, state, addOption]);
 
   var _useComboBox = useComboBox(_objectSpread(_objectSpread({}, comboBoxOptions), {}, {
     buttonRef: buttonRef,
@@ -241,6 +270,9 @@ var ComboBoxField = /*#__PURE__*/forwardRef(function (props, ref) {
   }, listbox));
 });
 ComboBoxField.propTypes = {
+  /* Whether or not adding new options to the list is enabled. */
+  hasAddOption: PropTypes.bool,
+
   /** Whether the ComboBox allows a non-item matching input value to be set. */
   hasCustomValue: PropTypes.bool,
 

package/lib/components/ComboBoxField/ComboBoxField.stories.js

@@ -1,3 +1,5 @@
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import _findInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/find";
 import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
 import _startsWithInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/starts-with";
 import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
@@ -469,4 +471,53 @@ export var CustomDefaultFilter = function CustomDefaultFilter() {
       key: item.name
     }, item.name);
   }));
+};
+export var ControlledWithAddOption = function ControlledWithAddOption() {
+  var _useState11 = useState(items),
+      _useState12 = _slicedToArray(_useState11, 2),
+      options = _useState12[0],
+      setOptions = _useState12[1];
+
+  var _useState13 = useState(''),
+      _useState14 = _slicedToArray(_useState13, 2),
+      inputValue = _useState14[0],
+      setInputValue = _useState14[1];
+
+  var _useState15 = useState(''),
+      _useState16 = _slicedToArray(_useState15, 2),
+      selectedKey = _useState16[0],
+      setSelectedKey = _useState16[1];
+
+  var onSelectionChange = function onSelectionChange(key) {
+    // Add new option to options array
+    if (key && !_findInstanceProperty(options).call(options, function (_ref2) {
+      var name = _ref2.name;
+      return name === key;
+    })) {
+      var _context2;
+
+      setOptions(_concatInstanceProperty(_context2 = []).call(_context2, options, [{
+        key: key,
+        name: key
+      }]));
+    }
+
+    setInputValue(key);
+    setSelectedKey(key);
+  };
+
+  return ___EmotionJSX(OverlayProvider, null, ___EmotionJSX(ComboBoxField, _extends({
+    label: "Example label",
+    defaultItems: options
+  }, actions, {
+    inputValue: inputValue,
+    selectedKey: selectedKey,
+    onInputChange: setInputValue,
+    onSelectionChange: onSelectionChange,
+    hasAddOption: true
+  }), function (item) {
+    return ___EmotionJSX(Item, {
+      key: item.name
+    }, item.name);
+  }));
 };

package/lib/components/ComboBoxField/ComboBoxField.test.js

@@ -9,6 +9,8 @@ import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance
 import _regeneratorRuntime from "@babel/runtime-corejs3/regenerator";
 import _asyncToGenerator from "@babel/runtime-corejs3/helpers/esm/asyncToGenerator";
 import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import _findInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/find";
 import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
 import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
 import _startsWithInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/starts-with";
@@ -16,7 +18,7 @@ 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 _context5, _context6; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context5 = ownKeys(Object(source), !0)).call(_context5, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context6 = ownKeys(Object(source))).call(_context6, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context6, _context7; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context6 = ownKeys(Object(source), !0)).call(_context6, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context7 = ownKeys(Object(source))).call(_context7, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
 
 import React, { useState, useMemo } from 'react';
 import { axe } from 'jest-axe';
@@ -83,6 +85,54 @@ var ComboBoxWithCustomFilter = function ComboBoxWithCustomFilter() {
   });
 };
 
+var ComboBoxWithAddOption = function ComboBoxWithAddOption() {
+  var _useState3 = useState(items),
+      _useState4 = _slicedToArray(_useState3, 2),
+      options = _useState4[0],
+      setOptions = _useState4[1];
+
+  var _useState5 = useState(''),
+      _useState6 = _slicedToArray(_useState5, 2),
+      inputValue = _useState6[0],
+      setInputValue = _useState6[1];
+
+  var _useState7 = useState(''),
+      _useState8 = _slicedToArray(_useState7, 2),
+      selectedKey = _useState8[0],
+      setSelectedKey = _useState8[1];
+
+  var onSelectionChange = function onSelectionChange(key) {
+    if (key && !_findInstanceProperty(options).call(options, function (_ref2) {
+      var name = _ref2.name;
+      return name === key;
+    })) {
+      var _context;
+
+      setOptions(_concatInstanceProperty(_context = []).call(_context, options, [{
+        key: key,
+        name: key
+      }]));
+    }
+
+    setInputValue(key);
+    setSelectedKey(key);
+  };
+
+  return ___EmotionJSX(ComboBoxField, {
+    label: "Example label",
+    defaultItems: options,
+    inputValue: inputValue,
+    selectedKey: selectedKey,
+    onInputChange: setInputValue,
+    onSelectionChange: onSelectionChange,
+    hasAddOption: true
+  }, function (item) {
+    return ___EmotionJSX(Item, {
+      key: item.name
+    }, item.name);
+  });
+};
+
 beforeAll(function () {
   jest.spyOn(window.HTMLElement.prototype, 'clientWidth', 'get').mockImplementation(function () {
     return 1000;
@@ -357,41 +407,41 @@ test('should use default contains filtering', function () {
 });
 test('should be able to use controlled filtering', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
   var options, input;
-  return _regeneratorRuntime.wrap(function _callee$(_context) {
+  return _regeneratorRuntime.wrap(function _callee$(_context2) {
     while (1) {
-      switch (_context.prev = _context.next) {
+      switch (_context2.prev = _context2.next) {
         case 0:
           render(___EmotionJSX(ComboBoxWithCustomFilter, null));
           input = screen.queryByRole('combobox'); // Should list all without filterable input
 
           userEvent.type(input, '{arrowdown}');
-          _context.next = 5;
+          _context2.next = 5;
           return screen.findAllByRole('option');
 
         case 5:
-          options = _context.sent;
+          options = _context2.sent;
           expect(options).toHaveLength(items.length); // Should only list the second option
 
           userEvent.type(input, 'k');
-          _context.next = 10;
+          _context2.next = 10;
           return screen.findAllByRole('option');
 
         case 10:
-          options = _context.sent;
+          options = _context2.sent;
           expect(options[0]).toHaveTextContent(items[1].name);
 
         case 12:
         case "end":
-          return _context.stop();
+          return _context2.stop();
       }
     }
   }, _callee);
 })));
 test('should be able to use custom default filtering', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
   var options, defaultFilter, input;
-  return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+  return _regeneratorRuntime.wrap(function _callee2$(_context3) {
     while (1) {
-      switch (_context2.prev = _context2.next) {
+      switch (_context3.prev = _context3.next) {
         case 0:
           defaultFilter = function defaultFilter(option, inputValue) {
             return _startsWithInstanceProperty(option).call(option, inputValue);
@@ -403,33 +453,33 @@ test('should be able to use custom default filtering', /*#__PURE__*/_asyncToGene
           input = screen.queryByRole('combobox'); // Should list all without filterable input
 
           userEvent.type(input, '{arrowdown}');
-          _context2.next = 6;
+          _context3.next = 6;
           return screen.findAllByRole('option');
 
         case 6:
-          options = _context2.sent;
+          options = _context3.sent;
           expect(options).toHaveLength(items.length); // Should only list the second option
 
           userEvent.type(input, 'K');
-          _context2.next = 11;
+          _context3.next = 11;
           return screen.findAllByRole('option');
 
         case 11:
-          options = _context2.sent;
+          options = _context3.sent;
           expect(options[0]).toHaveTextContent(items[1].name);
 
         case 13:
         case "end":
-          return _context2.stop();
+          return _context3.stop();
       }
     }
   }, _callee2);
 })));
 test('should show in input "textValue" if provided', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
   var newItems, input, options;
-  return _regeneratorRuntime.wrap(function _callee3$(_context3) {
+  return _regeneratorRuntime.wrap(function _callee3$(_context4) {
     while (1) {
-      switch (_context3.prev = _context3.next) {
+      switch (_context4.prev = _context4.next) {
         case 0:
           newItems = _mapInstanceProperty(items).call(items, function (item) {
             return _objectSpread(_objectSpread({}, item), {}, {
@@ -441,11 +491,11 @@ test('should show in input "textValue" if provided', /*#__PURE__*/_asyncToGenera
           });
           input = screen.queryByRole('combobox');
           userEvent.click(input);
-          _context3.next = 6;
+          _context4.next = 6;
           return screen.findAllByRole('option');
 
         case 6:
-          options = _context3.sent;
+          options = _context4.sent;
           userEvent.click(options[0]);
           expect(input).toHaveValue(newItems[0].textValue); // Check that on clicking again "textValue" still returning
 
@@ -454,7 +504,7 @@ test('should show in input "textValue" if provided', /*#__PURE__*/_asyncToGenera
 
         case 11:
         case "end":
-          return _context3.stop();
+          return _context4.stop();
       }
     }
   }, _callee3);
@@ -777,25 +827,56 @@ test('onSelectionChange works properly with custom value', function () {
   userEvent.type(input, '{selectall}{backspace}{enter}');
   expect(onSelectionChange).toHaveBeenCalledWith('');
 });
+test('add option shows when "hasAddOption" is provided', function () {
+  render(___EmotionJSX(ComboBoxWithAddOption, null));
+  var input = screen.queryByRole('combobox');
+  expect(input).toHaveValue('');
+  expect(screen.queryByRole('listbox')).not.toBeInTheDocument();
+  expect(screen.queryByRole('option')).not.toBeInTheDocument();
+  var inputValue = 'New value';
+  userEvent.type(input, inputValue);
+  expect(input).toHaveValue(inputValue);
+  expect(screen.queryByRole('listbox')).toBeInTheDocument();
+  var option = screen.queryByRole('option');
+  expect(option).toBeInTheDocument();
+  expect(option).toHaveClass('is-focused');
+  expect(option).toHaveTextContent("ADD: ".concat(inputValue));
+});
+test('if "hasAddOption" is provided, then custom value is added to listbox on blur', function () {
+  render(___EmotionJSX(ComboBoxWithAddOption, null));
+  var input = screen.queryByRole('combobox');
+  var inputValue = 'New value';
+  userEvent.type(input, inputValue);
+  expect(input).toHaveValue(inputValue); // blur input
+
+  userEvent.tab();
+  expect(screen.queryByRole('listbox')).not.toBeInTheDocument();
+  expect(screen.queryByRole('option')).not.toBeInTheDocument();
+  userEvent.click(input);
+  expect(input).toHaveValue(inputValue);
+  expect(screen.queryByRole('listbox')).toBeInTheDocument();
+  var options = screen.queryAllByRole('option');
+  expect(options[options.length - 1]).toHaveTextContent(inputValue);
+});
 test('should have no accessibility violations', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4() {
   var _getComponent6, container, results;
 
-  return _regeneratorRuntime.wrap(function _callee4$(_context4) {
+  return _regeneratorRuntime.wrap(function _callee4$(_context5) {
     while (1) {
-      switch (_context4.prev = _context4.next) {
+      switch (_context5.prev = _context5.next) {
         case 0:
           jest.useRealTimers();
           _getComponent6 = getComponent(), container = _getComponent6.container;
-          _context4.next = 4;
+          _context5.next = 4;
           return axe(container);
 
         case 4:
-          results = _context4.sent;
+          results = _context5.sent;
           expect(results).toHaveNoViolations();
 
         case 6:
         case "end":
-          return _context4.stop();
+          return _context5.stop();
       }
     }
   }, _callee4);

package/lib/components/Link/Link.js

@@ -9,6 +9,12 @@ import { useFocusRing } from '@react-aria/focus';
 import { useHover, usePress } from '@react-aria/interactions';
 import { mergeProps } from '@react-aria/utils';
 import { usePropWarning, useStatusClasses } from '../../hooks';
+/**
+ * Link uses the [Link - Theme-UI](https://theme-ui.com/components/link) component and
+ * React Aria's [useLink](https://react-spectrum.adobe.com/react-aria/useLink.html) hook.
+ *
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var Link = /*#__PURE__*/forwardRef(function (props, ref) {
   var className = props.className,

package/lib/components/ListView/ListView.js

@@ -58,6 +58,12 @@ export function useListLayout(state) {
   layout.disabledKeys = state.disabledKeys;
   return layout;
 }
+/**
+ * ListViews are used to display a list of items. Users can select,
+ * view, or edit items in this list. This virtualized component supports
+ * asynchronous data in infinitely scrollable lists.
+*/
+
 var ListView = /*#__PURE__*/forwardRef(function (props, ref) {
   var disabledKeys = props.disabledKeys,
       loadingState = props.loadingState,

package/lib/components/Messages/Messages.js

@@ -10,6 +10,11 @@ import { useListState } from '@react-stately/list';
 import statuses from '../../utils/devUtils/constants/statuses';
 import Message from './Message';
 import Box from '../Box';
+/**
+ *Messages are intended to display non-critical alerts that
+ attract the users’ attention, but do not interfere or temporarily block their work.
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var Messages = /*#__PURE__*/forwardRef(function (props, ref) {
   var _context;

package/lib/components/Modal/Modal.js

@@ -26,6 +26,12 @@ import IconButton from '../IconButton';
 import Icon from '../Icon';
 import Text from '../Text';
 import { useStatusClasses, useDeprecationWarning } from '../../hooks';
+/**
+  * Modals are overlays that interrupt a user’s workflow to convey an important message.
+  * The component must be wrapped in an OverlayProvider, and the first child should be a trigger,
+  * such as Button.
+*/
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var Modal = /*#__PURE__*/forwardRef(function (props, ref) {
   var className = props.className,

package/lib/components/NavBar/NavBar.stories.js

@@ -12,7 +12,7 @@ import { Separator, Box, Link, NavBar, NavBarSection, NavBarItemButton, NavBarIt
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export default {
   title: 'NavBar',
-  component: 'NavBar',
+  component: NavBar,
   subcomponents: {
     NavBarSection: NavBarSection,
     NavBarItemLink: NavBarItemLink,

package/lib/components/OverlayPanel/OverlayPanel.js

@@ -9,6 +9,10 @@ import { FocusScope } from '@react-aria/focus';
 import Box from '../Box';
 import { useStatusClasses, useOverlayPanelState } from '../../hooks';
 import { panelSizes } from '../../utils/devUtils/constants/panelSizes';
+/**
+ * In Astro, side panels are used to show details and present modal interactions.
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var OverlayPanel = /*#__PURE__*/forwardRef(function (props, ref) {
   var _props$sx;

package/lib/components/RequirementsList/RequirementsList.js

@@ -11,6 +11,11 @@ import DefaultCircle from 'mdi-react/CheckboxBlankCircleOutlineIcon';
 import Box from '../Box';
 import Text from '../Text';
 import Icon from '../Icon';
+/**
+ * List of requirements for a password, with indicators that can change to show when
+ * requirements are satisfied.
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var RequirementsList = /*#__PURE__*/forwardRef(function (props, ref) {
   var requirements = props.requirements,

package/lib/components/ScrollBox/ScrollBox.js

@@ -20,6 +20,10 @@ import React, { forwardRef, useImperativeHandle, useLayoutEffect, useRef, useSta
 import PropTypes from 'prop-types';
 import Box from '../Box';
 import useStatusClasses from '../../hooks/useStatusClasses';
+/**
+ * Scrollbox is a container that allows content to be scrolled
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var ScrollBox = /*#__PURE__*/forwardRef(function (props, ref) {
   var maxHeight = props.maxHeight,
@@ -31,7 +35,7 @@ var ScrollBox = /*#__PURE__*/forwardRef(function (props, ref) {
 
   var _useState = useState(0),
       _useState2 = _slicedToArray(_useState, 2),
-      scrollTopPostion = _useState2[0],
+      scrollTopPosition = _useState2[0],
       setScrollTopPosition = _useState2[1];
 
   var _useState3 = useState(false),
@@ -59,7 +63,7 @@ var ScrollBox = /*#__PURE__*/forwardRef(function (props, ref) {
         setIsTopShadowShowing(outerRef.current.firstChild.scrollTop !== 0);
       }
     }
-  }, [scrollTopPostion]);
+  }, [scrollTopPosition]);
   /* istanbul ignore next */
 
   var onScroll = function onScroll() {

package/lib/components/Stepper/Stepper.js

@@ -31,6 +31,12 @@ import { jsx as ___EmotionJSX } from "@emotion/react";
 var ACTIVE = stepStatuses.ACTIVE,
     COMPLETED = stepStatuses.COMPLETED,
     INACTIVE = stepStatuses.INACTIVE;
+/**
+ * The Stepper component acts as a wrapper for individual Step components.
+ * Stepper is used to display progress through a sequence of logical and numbered steps
+ *  usually within a configuration wizard.
+ */
+
 var Stepper = /*#__PURE__*/forwardRef(function (props, ref) {
   var activeStep = props.activeStep,
       onStepChange = props.onStepChange,

package/lib/components/Tab/Tab.js

@@ -13,6 +13,11 @@ import { useStatusClasses, usePropWarning } from '../../hooks';
 import ORIENTATION from '../../utils/devUtils/constants/orientation';
 import TabPicker from '../TabPicker';
 import { Box, Text, TooltipTrigger, Tooltip, Button } from '../..';
+/**
+ * Tab control for dividing up closely-related content.
+ * Typically used as a child of the Tabs component.
+ */
+
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var CollectionTab = /*#__PURE__*/forwardRef(function (props, ref) {
   var className = props.className,

package/lib/components/Tabs/Tabs.js

@@ -28,6 +28,10 @@ import ORIENTATION from '../../utils/devUtils/constants/orientation';
 import { usePropWarning } from '../../hooks';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var TabsContext = /*#__PURE__*/React.createContext({});
+/**
+ * Tabs are used to divide content, navigate to other views, and indicate work progress.
+ */
+
 var Tabs = /*#__PURE__*/forwardRef(function (props, ref) {
   var _context4, _context5;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pingux/astro",
-  "version": "1.16.0-alpha.4",
+  "version": "1.17.0-alpha.0",
   "description": "PingUX themeable React component library",
   "author": "ux-development@pingidentity.com",
   "license": "Apache-2.0",