@pingux/astro 2.9.2 → 2.13.0-alpha.4

package/lib/experimental/ListViewItem/ListViewItem.js

@@ -16,7 +16,7 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 import React, { forwardRef } from 'react';
 import { useHover } from '@react-aria/interactions';
 import { useStatusClasses } from '../../hooks';
-import { Box, Icon, Text } from '../../index';
+import { Box, Icon, Image, Text } from '../../index';
 import { listViewItemPropTypes } from './listViewItemAttributes';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var sx = {
@@ -40,6 +40,9 @@ var sx = {
     width: 25,
     color: 'accent.40'
   },
+  image: {
+    width: 35
+  },
   rightOfData: {
     alignSelf: 'center',
     ml: 'sm'
@@ -79,6 +82,7 @@ var ListViewItem = /*#__PURE__*/forwardRef(function (_ref, ref) {
     slots = _ref.slots,
     others = _objectWithoutProperties(_ref, _excluded);
   var icon = data.icon,
+    image = data.image,
     subtext = data.subtext,
     text = data.text;
   var shouldUseDefaultHover = isHovered === undefined;
@@ -94,15 +98,22 @@ var ListViewItem = /*#__PURE__*/forwardRef(function (_ref, ref) {
       isSelected: isSelected
     }),
     classNames = _useStatusClasses.classNames;
+  var iff = function iff(condition, then, otherwise) {
+    return condition ? then : otherwise;
+  };
   var wrapperStyles = slots !== null && slots !== void 0 && slots.leftOfData ? _objectSpread(_objectSpread({}, sx.wrapper), {}, {
     ml: 0
-  }) : sx.wrapper;
+  }) : iff(!icon && image, _objectSpread(_objectSpread({}, sx.wrapper), {}, {
+    ml: 10
+  }), sx.wrapper);
   var textStyles = slots !== null && slots !== void 0 && slots.leftOfData ? _objectSpread(_objectSpread({}, sx.text), {}, {
     ml: 0
-  }) : sx.text;
-  var renderIcon = ___EmotionJSX(Box, {
+  }) : iff(!icon && image, _objectSpread(_objectSpread({}, sx.wrapper), {}, {
+    ml: 10
+  }), sx.wrapper);
+  var renderIcon = icon && ___EmotionJSX(Box, {
     sx: sx.icon
-  }, icon && ___EmotionJSX(Icon, {
+  }, ___EmotionJSX(Icon, {
     icon: icon,
     size: "md",
     title: {
@@ -110,10 +121,17 @@ var ListViewItem = /*#__PURE__*/forwardRef(function (_ref, ref) {
       name: _concatInstanceProperty(_context2 = "".concat(text)).call(_context2, LIST_ITEM_ICON)
     }
   }));
+  var renderImage = !icon && image && ___EmotionJSX(Box, {
+    sx: sx.image
+  }, ___EmotionJSX(Image, {
+    src: image.src,
+    alt: image.alt,
+    "aria-label": image['aria-label']
+  }));
   var renderData = ___EmotionJSX(Box, {
     isRow: true,
     sx: sx.data
-  }, (slots === null || slots === void 0 ? void 0 : slots.leftOfData) || renderIcon, ___EmotionJSX(Box, {
+  }, (slots === null || slots === void 0 ? void 0 : slots.leftOfData) || renderIcon || renderImage, ___EmotionJSX(Box, {
     sx: textStyles
   }, text && ___EmotionJSX(Text, {
     variant: "bodyStrong",

package/lib/experimental/ListViewItem/ListViewItem.mdx

@@ -0,0 +1,36 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Experimental/ListViewItem" />
+
+# ListViewItem
+
+The ListViewItem allows easy creation of list items. Styles have been included to match Ping specs. Use the data prop to pass in text, subtext and an image, mdi or svg icon.
+
+### Recommended Use
+This component is intended to be used inside a ListView component. See the [ListAndPanel](./?path=/story/experimental-recipes-listandpanel--list-and-panel) and [ScrollableListView](./?path=/story/experimental-recipes-scrollablelistview--scrollable-list-view)
+recipes for a more detailed examples.
+
+#### Icons and Images
+Add an icon by passing an mdi or svg icon to the `data.icon` prop. Default size is 25px.
+
+Add an image by passing an object with a `src` key to the `data.image` prop. `alt` and `aria-label` keys are supported but not required. Default size is 35px.
+
+If both an icon and an image are provided the icon will be rendered.
+
+For other Icon or Image sizes use slots with `rightOfData`.
+
+#### Slots
+The slots prop has been provided for added flexibility. Use the `rightOfData` slot to add icons, badges or other elements to the right of the data
+section. Use the `leftOfData` slot to add elements to the left of the data element. Note that when the
+leftOfData slot is used, it will prevent an icon in the `data.icon` prop from rendering and remove all margins/padding on the left of the data.
+
+#### Children
+To add action controls, pass control elements as `{children}`. All elements passed in this way will be right justified and center aligned. Use one of the following
+styled control components to easily match Ping specs.
+- [ListViewItemEditButton](./?path=/story/experimental-styledlistitem-controls-listitemeditbutton--default)
+- [ListViewItemMenu](./?path=/story/experimental-styledlistitem-controls-listitemmenu--default)
+- [ListViewItemSwitchField](./?path=/story/experimental-styledlistitem-controls-listitemswitchfield--default)
+
+### Note:
+The nature of components that have been styled to match design specs is that as design specs are updated, so will the matching component. Be aware that styles 
+inside this component may be adjusted in small ways over time.

package/lib/experimental/ListViewItem/ListViewItem.stories.js

@@ -4,6 +4,7 @@ import AccountIcon from '@pingux/mdi-react/AccountIcon';
 import FormSelectIcon from '@pingux/mdi-react/FormSelectIcon';
 import DocsLayout from '../../../.storybook/storybookDocsLayout';
 import { Badge, Box, ListViewItem, ListViewItemEditButton, ListViewItemMenu, ListViewItemSwitchField, Separator, Text } from '../../index';
+import { pingImg } from '../../utils/devUtils/constants/images';
 import ListViewItemReadMe from './ListViewItem.mdx';
 import { listViewItemArgTypes } from './listViewItemAttributes';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -39,7 +40,8 @@ export var Default = function Default() {
     data: {
       icon: AccountIcon,
       text: 'Fons Vernall'
-    }
+    },
+    "aria-label": "Fons Vernall"
   }));
 };
 export var WithSubtext = function WithSubtext() {
@@ -48,6 +50,20 @@ export var WithSubtext = function WithSubtext() {
       icon: AccountIcon,
       subtext: 'rad_developer@pingidentity.com',
       text: 'Fons Vernall'
+    },
+    "aria-label": "Fons Vernall"
+  }));
+};
+export var WithImage = function WithImage() {
+  return ___EmotionJSX(Wrapper, null, ___EmotionJSX(ListViewItem, {
+    data: {
+      image: {
+        src: pingImg,
+        alt: 'avatar',
+        'aria-label': 'avatar'
+      },
+      subtext: 'rad_developer@pingidentity.com',
+      text: 'Fons Vernall'
     }
   }));
 };
@@ -56,8 +72,13 @@ export var WithControls = function WithControls() {
     data: {
       icon: FormSelectIcon,
       text: 'Fons Vernall'
-    }
-  }, ___EmotionJSX(ListViewItemEditButton, null), ___EmotionJSX(ListViewItemSwitchField, null), ___EmotionJSX(ListViewItemMenu, null, ___EmotionJSX(Item, {
+    },
+    "aria-label": "Fons Vernall"
+  }, ___EmotionJSX(ListViewItemEditButton, {
+    "aria-label": "edit-icon"
+  }), ___EmotionJSX(ListViewItemSwitchField, {
+    "aria-label": "active user"
+  }), ___EmotionJSX(ListViewItemMenu, null, ___EmotionJSX(Item, {
     key: "enable"
   }, "Enable user"), ___EmotionJSX(Item, {
     key: "disable"
@@ -84,7 +105,8 @@ export var WithRightOfDataSlot = function WithRightOfDataSlot() {
     },
     slots: {
       rightOfData: renderRightOfData
-    }
+    },
+    "aria-label": "Fons Vernall"
   }, ___EmotionJSX(ListViewItemMenu, null, ___EmotionJSX(Item, {
     key: "enable"
   }, "Enable user"), ___EmotionJSX(Item, {
@@ -111,7 +133,8 @@ export var WithLeftOfDataSlot = function WithLeftOfDataSlot() {
     ,
     slots: {
       leftOfData: renderLeftOfData
-    }
+    },
+    "aria-label": "Fons Vernall"
   }, ___EmotionJSX(ListViewItemMenu, null, ___EmotionJSX(Item, {
     key: "enable"
   }, "Enable user"), ___EmotionJSX(Item, {

package/lib/experimental/ListViewItem/ListViewItem.test.js

@@ -1,8 +1,21 @@
+import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
+import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import _Object$getOwnPropertyDescriptor from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
+import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
 import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
 import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+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 from 'react';
 import AccountIcon from '@pingux/mdi-react/AccountIcon';
+import { act } from '@testing-library/react';
 import { ListViewItem, ListViewItemSwitchField } from '../../index';
+import { pingImg } from '../../utils/devUtils/constants/images';
 import axeTest from '../../utils/testUtils/testAxe';
 import { render, screen } from '../../utils/testUtils/testWrapper';
 import { LIST_ITEM_ICON } from './ListViewItem';
@@ -11,13 +24,25 @@ var defaultProps = {
   data: {
     text: 'testText',
     subtext: 'testSubtext',
-    icon: AccountIcon
+    icon: AccountIcon,
+    image: {
+      src: pingImg,
+      alt: 'avatar',
+      'aria-label': 'avatar'
+    }
   }
 };
 var getComponent = function getComponent() {
   var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
   return render(___EmotionJSX(ListViewItem, _extends({}, defaultProps, props)));
 };
+var fallbackImageObj = null;
+jest.mock('../../hooks/useFallbackImage', function () {
+  return function (props) {
+    fallbackImageObj = _objectSpread({}, props);
+    return [];
+  };
+});
 
 // Need to be added to each test file to test accessibility using axe.
 axeTest(getComponent);
@@ -49,6 +74,25 @@ describe('ListViewItem', function () {
     });
     screen.getByText(TEST_TEXT);
   });
+  test('renders icon if both icon and image are passed', function () {
+    getComponent();
+    var icon = screen.getByRole('img');
+    expect(icon).not.toHaveAttribute('src', pingImg);
+    expect(icon.tagName.toLowerCase()).toBe('svg');
+    expect(icon.tagName.toLowerCase()).not.toBe('img');
+  });
+  test('renders image', function () {
+    delete defaultProps.data.icon;
+    getComponent();
+    act(function () {
+      fallbackImageObj.onImageLoad();
+    });
+    var image = screen.getByRole('img');
+    expect(image.tagName.toLowerCase()).toBe('img');
+    expect(image).toHaveAttribute('src', pingImg);
+    expect(image).toHaveAttribute('alt', 'avatar');
+    expect(image).toHaveAttribute('aria-label', 'avatar');
+  });
   describe('when there is a leftOfData slot', function () {
     test('renders leftOfData slot', function () {
       getComponent({

package/lib/experimental/ListViewItem/controls/ListViewItemEditButton.js

@@ -1,4 +1,3 @@
-import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
 import React from 'react';
 import CreateIcon from '@pingux/mdi-react/CreateIcon';
 import { iconButtonPropTypes } from '../../../components/IconButton/iconButtonAttributes';
@@ -13,9 +12,7 @@ import { Box, Icon, IconButton } from '../../../index';
 */
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var ListViewItemEditButton = function ListViewItemEditButton(props) {
-  return ___EmotionJSX(Box, null, ___EmotionJSX(IconButton, _extends({
-    "aria-label": "edit-icon"
-  }, props), ___EmotionJSX(Icon, {
+  return ___EmotionJSX(Box, null, ___EmotionJSX(IconButton, props, ___EmotionJSX(Icon, {
     icon: CreateIcon,
     size: "sm"
   })));

package/lib/experimental/ListViewItem/controls/ListViewItemEditButton.stories.js

@@ -1,3 +1,4 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
 import React from 'react';
 import { iconButtonArgs, iconButtonArgTypes } from '../../../components/IconButton/iconButtonAttributes';
 import { ListViewItemEditButton } from '../../../index';
@@ -18,5 +19,7 @@ export default {
   args: iconButtonArgs
 };
 export var Default = function Default(args) {
-  return ___EmotionJSX(ListViewItemEditButton, args);
+  return ___EmotionJSX(ListViewItemEditButton, _extends({
+    "aria-label": "edit-icon"
+  }, args));
 };

package/lib/experimental/ListViewItem/controls/ListViewItemSwitchField.js

@@ -13,6 +13,7 @@ import { SwitchField } from '../../../index';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var ListViewItemSwitchField = function ListViewItemSwitchField(props) {
   return ___EmotionJSX(SwitchField, _extends({
+    role: "group",
     "aria-label": "active user",
     isDefaultSelected: true,
     mr: 0

package/lib/experimental/ListViewItem/listViewItemAttributes.js

@@ -10,6 +10,7 @@ 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 PropTypes from 'prop-types';
+import { ariaAttributeBaseArgTypes, ariaAttributesBasePropTypes } from '../../utils/docUtils/ariaAttributes';
 import { booleanArg, stringOrStringArray } from '../../utils/docUtils/docArgTypes';
 import { onHoverArgTypes, onHoverPropTypes } from '../../utils/docUtils/hoverProps';
 var descriptions = {
@@ -20,19 +21,24 @@ var descriptions = {
   slots: 'Provides a way to insert markup in specified places.',
   linkProps: 'When present, provides meta click functionality'
 };
-export var listViewItemArgTypes = _objectSpread({
-  className: {
-    description: descriptions.className,
-    type: {
-      summary: stringOrStringArray
-    }
-  },
+export var SharedItemArgTypes = {
   data: {
     description: descriptions.data,
     type: {
-      summary: '{ icon, text, subtext }'
+      summary: '{ icon, image, text, subtext }'
+    },
+    control: {
+      type: 'none'
     }
   },
+  className: {
+    description: descriptions.className,
+    type: {
+      summary: stringOrStringArray
+    }
+  }
+};
+export var listViewItemArgTypes = _objectSpread(_objectSpread(_objectSpread({
   isSelected: _objectSpread(_objectSpread({}, booleanArg), {}, {
     description: descriptions.isSelected,
     control: {
@@ -54,14 +60,21 @@ export var listViewItemArgTypes = _objectSpread({
       summary: '{ leftOfData, rightOfData }'
     }
   }
-}, onHoverArgTypes);
-export var listViewItemPropTypes = _objectSpread({
+}, SharedItemArgTypes), onHoverArgTypes), ariaAttributeBaseArgTypes);
+export var SharedItemPropTypes = {
   className: PropTypes.oneOfType([PropTypes.string, PropTypes.arrayOf(PropTypes.string)]),
   data: PropTypes.shape({
     icon: PropTypes.elementType,
+    image: PropTypes.shape({
+      src: PropTypes.string,
+      alt: PropTypes.string,
+      'aria-label': PropTypes.string
+    }),
     subtext: PropTypes.string,
     text: PropTypes.string
-  }),
+  })
+};
+export var listViewItemPropTypes = _objectSpread(_objectSpread(_objectSpread({
   isSelected: PropTypes.bool,
   linkProps: PropTypes.object,
   onMetaClick: PropTypes.func,
@@ -69,4 +82,4 @@ export var listViewItemPropTypes = _objectSpread({
     leftOfData: PropTypes.node,
     rightOfData: PropTypes.node
   })
-}, onHoverPropTypes);
+}, SharedItemPropTypes), onHoverPropTypes), ariaAttributesBasePropTypes);

package/lib/experimental/PanelHeader/PanelHeader.js

@@ -0,0 +1,75 @@
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
+var _excluded = ["children", "className", "data"];
+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 _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
+import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import _Object$getOwnPropertyDescriptor from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
+import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import React, { forwardRef } from 'react';
+import { Box, Icon, Text } from '../../index';
+import { SharedItemPropTypes } from '../ListViewItem/listViewItemAttributes';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export var PANEL_HEADER_ICON = '-panel-header-icon';
+var PanelHeader = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var _context;
+  var children = _ref.children,
+    className = _ref.className,
+    data = _ref.data,
+    others = _objectWithoutProperties(_ref, _excluded);
+  var icon = data.icon,
+    subtext = data.subtext,
+    text = data.text;
+  var renderIcon = ___EmotionJSX(Box, {
+    sx: {
+      width: 25,
+      color: 'accent.40'
+    }
+  }, icon && ___EmotionJSX(Icon, {
+    icon: icon,
+    size: "md",
+    title: {
+      name: _concatInstanceProperty(_context = "".concat(text)).call(_context, PANEL_HEADER_ICON)
+    }
+  }));
+  var renderData = ___EmotionJSX(Box, {
+    isRow: true,
+    variant: "panelHeader.data"
+  }, renderIcon, ___EmotionJSX(Box, {
+    sx: {
+      ml: 'md'
+    }
+  }, text && ___EmotionJSX(Text, {
+    variant: "bodyStrong",
+    sx: {
+      alignSelf: 'start',
+      fontSize: 'md'
+    }
+  }, text), subtext && ___EmotionJSX(Text, {
+    variant: "subtitle",
+    sx: {
+      fontSize: 'sm',
+      lineHeight: '16px',
+      my: '1px'
+    }
+  }, subtext)));
+  return ___EmotionJSX(Box, _extends({
+    variant: "panelHeader.container",
+    className: className,
+    ref: ref
+  }, others), ___EmotionJSX(Box, {
+    variant: "panelHeader.wrapper"
+  }, renderData, ___EmotionJSX(Box, {
+    isRow: true,
+    variant: "panelHeader.controls"
+  }, children)));
+});
+PanelHeader.propTypes = _objectSpread({}, SharedItemPropTypes);
+export default PanelHeader;

package/lib/experimental/PanelHeader/PanelHeader.mdx

@@ -0,0 +1,19 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Experimental/PanelHeader" />
+
+# PanelHeader
+
+The PanelHeader component allows for easy creation of header items within a panel. It comes with pre-defined styles that match Ping specs. You can utilize the `data` prop to pass in text, subtext, and an mdi or svg icon.
+
+### Recommended Use
+This component is intended to be used as a header within a panel.
+
+#### Children
+To add action controls, include control elements as `{children}`. All elements passed in this way will be right-justified and center-aligned. You can use the following pre-styled control components to easily match Ping specs:
+- [PanelHeaderEditButton](./?path=/story/experimental-panelheader-controls-panelheadereditbutton--default)
+- [PanelHeaderMenu](./?path=/story/experimental-panelheader-controls-panelheadermenu--default)
+- [PanelHeaderSwitchField](./?path=/story/experimental-panelheader-controls-panelheaderswitchfield--default)
+
+### Note:
+Components styled to match design specs may be updated over time as design specs change. Be aware that styles within this component may undergo minor adjustments over time to stay in sync with the latest design specifications.

package/lib/experimental/PanelHeader/PanelHeader.stories.js

@@ -0,0 +1,59 @@
+import _objectDestructuringEmpty from "@babel/runtime-corejs3/helpers/esm/objectDestructuringEmpty";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import React from 'react';
+import AccountIcon from '@pingux/mdi-react/AccountIcon';
+import DocsLayout from '../../../.storybook/storybookDocsLayout';
+import { Item, PanelHeader, PanelHeaderCloseButton, PanelHeaderMenu, PanelHeaderSwitchField } from '../../index';
+import { SharedItemArgTypes } from '../ListViewItem/listViewItemAttributes';
+import PanelHeaderReadMe from './PanelHeader.mdx';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export default {
+  title: 'Experimental/PanelHeader',
+  component: PanelHeader,
+  parameters: {
+    docs: {
+      page: function page() {
+        return ___EmotionJSX(React.Fragment, null, ___EmotionJSX(PanelHeaderReadMe, null), ___EmotionJSX(DocsLayout, null));
+      },
+      source: {
+        type: 'code'
+      }
+    }
+  },
+  argTypes: SharedItemArgTypes
+};
+export var Default = function Default(_ref) {
+  var args = _extends({}, (_objectDestructuringEmpty(_ref), _ref));
+  return ___EmotionJSX(PanelHeader, _extends({}, args, {
+    data: {
+      icon: AccountIcon,
+      text: 'Fons Vernall'
+    }
+  }));
+};
+export var WithSubtext = function WithSubtext(_ref2) {
+  var args = _extends({}, (_objectDestructuringEmpty(_ref2), _ref2));
+  return ___EmotionJSX(PanelHeader, _extends({}, args, {
+    data: {
+      icon: AccountIcon,
+      subtext: 'rad_developer@pingidentity.com',
+      text: 'Fons Vernall'
+    }
+  }));
+};
+export var WithControls = function WithControls(_ref3) {
+  var args = _extends({}, (_objectDestructuringEmpty(_ref3), _ref3));
+  return ___EmotionJSX(PanelHeader, _extends({}, args, {
+    data: {
+      icon: AccountIcon,
+      text: 'Fons Vernall',
+      subtext: 'rad_developer@pingidentity.com'
+    }
+  }), ___EmotionJSX(PanelHeaderSwitchField, null), ___EmotionJSX(PanelHeaderMenu, null, ___EmotionJSX(Item, {
+    key: "enable"
+  }, "Enable user"), ___EmotionJSX(Item, {
+    key: "disable"
+  }, "Disable user"), ___EmotionJSX(Item, {
+    key: "delete"
+  }, "Delete user")), ___EmotionJSX(PanelHeaderCloseButton, null));
+};

package/lib/experimental/PanelHeader/PanelHeader.styles.js

@@ -0,0 +1,30 @@
+var container = {
+  bg: 'accent.99',
+  justifyContent: 'center',
+  minHeight: 60,
+  borderBottom: '1px',
+  borderBottomStyle: 'solid',
+  borderBottomColor: 'accent.90'
+};
+var controls = {
+  alignSelf: 'center',
+  alignItems: 'center',
+  gap: 'sm',
+  ml: 'auto'
+};
+var data = {
+  alignItems: 'center',
+  display: 'grid !important',
+  gridTemplateColumns: 'max-content auto'
+};
+var wrapper = {
+  display: 'grid !important',
+  gridTemplateColumns: 'auto auto',
+  mx: 'md'
+};
+export default {
+  container: container,
+  controls: controls,
+  data: data,
+  wrapper: wrapper
+};

package/lib/experimental/PanelHeader/PanelHeader.test.js

@@ -0,0 +1,43 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import React from 'react';
+import AccountIcon from '@pingux/mdi-react/AccountIcon';
+import { PanelHeader, PanelHeaderSwitchField } from '../../index';
+import axeTest from '../../utils/testUtils/testAxe';
+import { render, screen } from '../../utils/testUtils/testWrapper';
+import { PANEL_HEADER_ICON } from './PanelHeader';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var defaultProps = {
+  data: {
+    text: 'testText',
+    subtext: 'testSubtext',
+    icon: AccountIcon
+  }
+};
+var getComponent = function getComponent() {
+  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return render(___EmotionJSX(PanelHeader, _extends({}, defaultProps, props)));
+};
+
+// Need to be added to each test file to test accessibility using axe.
+axeTest(getComponent);
+describe('PanelHeader', function () {
+  test('renders data', function () {
+    var _context;
+    getComponent();
+    var _defaultProps$data = defaultProps.data,
+      text = _defaultProps$data.text,
+      subtext = _defaultProps$data.subtext;
+    screen.getByText(text);
+    screen.getByText(subtext);
+    screen.getByRole('img', {
+      name: _concatInstanceProperty(_context = "".concat(text)).call(_context, PANEL_HEADER_ICON)
+    });
+  });
+  test('renders children', function () {
+    getComponent({
+      children: ___EmotionJSX(PanelHeaderSwitchField, null)
+    });
+    screen.getByRole('switch');
+  });
+});

package/lib/experimental/PanelHeader/controls/PanelHeaderCloseButton.js

@@ -0,0 +1,25 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import React from 'react';
+import CloseIcon from '@pingux/mdi-react/CloseIcon';
+import { iconButtonPropTypes } from '../../../components/IconButton/iconButtonAttributes';
+import { Box, Icon, IconButton } from '../../../index';
+
+/**
+ * PanelHeaderCloseButton is one of several styled control components that can be used as a child
+ * nested inside of the [PanelHeader](./?path=/story/experimental-panelheader--default).
+ * Its a wrapper component around the [IconButton](./?path=/story/components-iconbutton--default),
+ * intended to make matching specs easy. Most props available to the IconButton are also available
+ * to PanelHeaderCloseButton.
+*/
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var PanelHeaderCloseButton = function PanelHeaderCloseButton(props) {
+  return ___EmotionJSX(Box, null, ___EmotionJSX(IconButton, _extends({
+    "aria-label": "close-icon"
+  }, props), ___EmotionJSX(Icon, {
+    icon: CloseIcon,
+    size: "md"
+  })));
+};
+PanelHeaderCloseButton.propTypes = iconButtonPropTypes;
+PanelHeaderCloseButton.displayName = 'PanelHeaderCloseButton';
+export default PanelHeaderCloseButton;

package/lib/experimental/PanelHeader/controls/PanelHeaderCloseButton.stories.js

@@ -0,0 +1,21 @@
+import React from 'react';
+import { iconButtonArgTypes } from '../../../components/IconButton/iconButtonAttributes';
+import { PanelHeaderCloseButton } from '../../../index';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+delete iconButtonArgTypes.size;
+delete iconButtonArgTypes.icon;
+export default {
+  title: 'Experimental/PanelHeader/Controls/PanelHeaderCloseButton',
+  component: PanelHeaderCloseButton,
+  parameters: {
+    docs: {
+      source: {
+        type: 'code'
+      }
+    }
+  },
+  argTypes: iconButtonArgTypes
+};
+export var Default = function Default(args) {
+  return ___EmotionJSX(PanelHeaderCloseButton, args);
+};