@pingux/astro 2.84.0-alpha.2 → 2.84.0-alpha.3

package/lib/cjs/components/LinkSelectField/LinkSelectField.stories.js

@@ -181,18 +181,15 @@ exports.Controlled = Controlled;
 var WithNoneOption = function WithNoneOption() {
   return (0, _react2.jsx)(_index.LinkSelectField, {
     label: "What's your favorite color?"
-  }, (0, _react2.jsx)(_index.Item, {
+  }, (0, _react2.jsx)(_index.Section, null, (0, _react2.jsx)(_index.Item, {
     key: "none"
-  }, "None"), (0, _react2.jsx)(_index.Item, {
-    isSeparator: true,
-    textValue: "-"
-  }, (0, _react2.jsx)(_index.Separator, null)), (0, _react2.jsx)(_index.Item, {
+  }, "None")), (0, _react2.jsx)(_index.Section, null, (0, _react2.jsx)(_index.Item, {
     key: "red"
   }, "Red"), (0, _react2.jsx)(_index.Item, {
     key: "blue"
   }, "Blue"), (0, _react2.jsx)(_index.Item, {
     key: "yellow"
-  }, "Yellow"));
+  }, "Yellow")));
 };
 exports.WithNoneOption = WithNoneOption;
 var DisabledField = function DisabledField() {

package/lib/cjs/components/Menu/Menu.js

@@ -30,6 +30,7 @@ var _hooks = require("../../hooks");
 var _orientation = _interopRequireDefault(require("../../utils/devUtils/constants/orientation"));
 var _Box = _interopRequireDefault(require("../Box"));
 var _MenuItem = _interopRequireDefault(require("../MenuItem"));
+var _MenuSection = _interopRequireDefault(require("../MenuSection"));
 var _react2 = require("@emotion/react");
 var _excluded = ["isDisabled", "isNotFocusedOnHover", "onAction", "onHoverChange", "onHoverEnd", "onHoverStart", "onSelectionChange", "selectionMode"];
 function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
@@ -77,10 +78,21 @@ var Menu = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
     "aria-orientation": _orientation["default"].VERTICAL
   }, others, (0, _reactAria.mergeProps)(focusProps, menuProps, hoverProps), {
     role: "menu"
-  }), (0, _map["default"])(_context = (0, _from["default"])(state.collection)).call(_context, function (item) {
+  }), (0, _map["default"])(_context = (0, _from["default"])(state.collection)).call(_context, function (element) {
+    if (element.type === 'section') {
+      return (0, _react2.jsx)(_MenuSection["default"], {
+        key: element.key,
+        section: element,
+        state: state,
+        onAction: onAction,
+        isDisabled: isDisabled,
+        isFocusVisible: isFocusVisible,
+        isNotFocusedOnHover: isNotFocusedOnHover
+      });
+    }
     return (0, _react2.jsx)(_MenuItem["default"], {
-      key: item.key,
-      item: item,
+      key: element.key,
+      item: element,
       state: state,
       onAction: onAction,
       isDisabled: isDisabled,

package/lib/cjs/components/Menu/Menu.test.js

@@ -54,6 +54,29 @@ test('should render basic menu with children', function () {
   expect(menuItems).toHaveLength(3);
   expect(menu).toHaveAttribute('aria-orientation', _orientation["default"].VERTICAL);
 });
+test('should render sections when sections are passed as Children', function () {
+  var menuSections = [{
+    key: 'menuSection 1',
+    children: defaultItems
+  }, {
+    key: 'menuSection 2',
+    children: defaultItems
+  }];
+  (0, _testWrapper.render)((0, _react2.jsx)(_index.Menu, defaultProps, (0, _map["default"])(menuSections).call(menuSections, function (section) {
+    var _context;
+    return (0, _react2.jsx)(_index.Section, section, (0, _map["default"])(_context = section.children).call(_context, function (item) {
+      return (0, _react2.jsx)(_index.Item, (0, _extends2["default"])({
+        key: item.id
+      }, item));
+    }));
+  })));
+  var menu = _testWrapper.screen.queryByRole('menu');
+  expect(menu).toBeInTheDocument();
+  var menuSection = _testWrapper.screen.queryAllByRole('group');
+  expect(menuSection).toHaveLength(2);
+  var menuItems = _testWrapper.screen.getAllByRole('menuitem');
+  expect(menuItems).toHaveLength(6);
+});
 test('should render items when selectionMode is set to single', function () {
   getComponent({
     selectionMode: 'single'

package/lib/cjs/components/MenuSection/MenuSection.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { MenuSectionProps } from '../../types';
+/**
+ * Menu Section component intended to be used within Menu or PopupMenu.
+ * This component is not intented to be used outside of Menu or independently.
+ * Utilizes [React Aria](https://react-spectrum.adobe.com/react-aria/useMenu.html)
+ */
+declare const MenuSection: React.ForwardRefExoticComponent<MenuSectionProps & React.RefAttributes<HTMLDivElement>>;
+export default MenuSection;

package/lib/cjs/components/MenuSection/MenuSection.js

@@ -0,0 +1,76 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/map"));
+var _from = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/array/from"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
+var _react = _interopRequireWildcard(require("react"));
+var _reactAria = require("react-aria");
+var _hooks = require("../../hooks");
+var _Box = _interopRequireDefault(require("../Box"));
+var _MenuItem = _interopRequireDefault(require("../MenuItem"));
+var _Separator = _interopRequireDefault(require("../Separator"));
+var _react2 = require("@emotion/react");
+function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+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; }
+/**
+ * Menu Section component intended to be used within Menu or PopupMenu.
+ * This component is not intented to be used outside of Menu or independently.
+ * Utilizes [React Aria](https://react-spectrum.adobe.com/react-aria/useMenu.html)
+ */var MenuSection = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
+  var _context;
+  var section = props.section,
+    state = props.state,
+    onAction = props.onAction,
+    isDisabled = props.isDisabled,
+    isFocusVisible = props.isFocusVisible,
+    isNotFocusedOnHover = props.isNotFocusedOnHover;
+  var menuSectionRef = (0, _hooks.useLocalOrForwardRef)(ref);
+  var _useMenuSection = (0, _reactAria.useMenuSection)({
+      heading: section.rendered,
+      'aria-label': section['aria-label']
+    }),
+    itemProps = _useMenuSection.itemProps,
+    groupProps = _useMenuSection.groupProps,
+    headingProps = _useMenuSection.headingProps;
+  return (0, _react2.jsx)(_react["default"].Fragment, null, section.key !== state.collection.getFirstKey() && (0, _react2.jsx)(_Separator["default"], {
+    as: "li",
+    p: 0,
+    m: 0
+  }), (0, _react2.jsx)(_Box["default"], (0, _extends2["default"])({
+    as: "li"
+  }, itemProps, {
+    ref: menuSectionRef,
+    role: "presentation"
+  }), section.rendered && (0, _react2.jsx)(_Box["default"], (0, _extends2["default"])({
+    as: "span",
+    variant: "menuSection.sectionTitle"
+  }, headingProps, {
+    role: "presentation"
+  }), section.rendered), (0, _react2.jsx)(_Box["default"], (0, _extends2["default"])({
+    as: "ul",
+    variant: "menuSection.section"
+  }, groupProps, {
+    role: "group"
+  }), (0, _map["default"])(_context = (0, _from["default"])(section.childNodes)).call(_context, function (node) {
+    return (0, _react2.jsx)(_MenuItem["default"], {
+      key: node.key,
+      item: node,
+      state: state,
+      onAction: onAction,
+      isDisabled: isDisabled,
+      isFocusVisible: isFocusVisible,
+      isNotFocusedOnHover: isNotFocusedOnHover
+    });
+  }))));
+});
+var _default = MenuSection;
+exports["default"] = _default;

package/lib/cjs/components/MenuSection/MenuSection.styles.d.ts

@@ -0,0 +1,21 @@
+declare const _default: {
+    section: {
+        borderRadius: number;
+        padding: number;
+        margin: number;
+        listStyle: string;
+        maxWidth: number;
+        outline: string;
+        overflow: string;
+        minWidth: string;
+    };
+    sectionTitle: {
+        fontSize: string;
+        fontWeight: string;
+        color: string;
+        height: string;
+        ml: string;
+        justifyContent: string;
+    };
+};
+export default _default;

package/lib/cjs/components/MenuSection/MenuSection.styles.js

@@ -0,0 +1,35 @@
+"use strict";
+
+var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
+var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols");
+var _filterInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/filter");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
+var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors");
+var _Object$defineProperties = require("@babel/runtime-corejs3/core-js-stable/object/define-properties");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
+var _Menu = _interopRequireDefault(require("../Menu/Menu.styles"));
+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) { (0, _defineProperty2["default"])(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; }
+var section = _objectSpread(_objectSpread({}, _Menu["default"]), {}, {
+  borderRadius: 0
+});
+var sectionTitle = {
+  fontSize: 'sm',
+  fontWeight: '3',
+  color: 'text.secondary',
+  height: '36px',
+  ml: 'sm',
+  justifyContent: 'center'
+};
+var _default = {
+  section: section,
+  sectionTitle: sectionTitle
+};
+exports["default"] = _default;

package/lib/cjs/components/MenuSection/MenuSection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/cjs/components/MenuSection/MenuSection.test.js

@@ -0,0 +1,100 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
+var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/map"));
+var _reduce = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/reduce"));
+var _react = _interopRequireDefault(require("react"));
+var _index = require("../../index");
+var _testWrapper = require("../../utils/testUtils/testWrapper");
+var _universalComponentTest = require("../../utils/testUtils/universalComponentTest");
+var _react2 = require("@emotion/react");
+var testId = 'testId';
+var defaultMenuSections = [{
+  key: 'menuSection 1',
+  'data-id': 'menuSection1',
+  title: 'Section 1',
+  children: [{
+    key: 'menuItem1',
+    children: 'MenuItem 1',
+    'data-id': 'menuItem1',
+    isPressed: false,
+    backgroundColor: 'orange'
+  }]
+}, {
+  key: 'menuSection 2',
+  'data-id': 'menuSection2',
+  children: [{
+    key: 'menuItem2',
+    children: 'MenuItem 2',
+    'data-id': 'menuItem1',
+    isPressed: false
+  }, {
+    key: 'menuItem3',
+    children: 'MenuItem 3',
+    'data-id': 'menuItem1',
+    isPressed: false
+  }]
+}];
+var defaultProps = {
+  'data-testid': testId,
+  defaultSelectedKey: 'menuItem1',
+  'aria-label': 'testLabel'
+};
+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$items = _ref.items,
+    items = _ref$items === void 0 ? defaultMenuSections : _ref$items,
+    _ref$renderFn = _ref.renderFn,
+    renderFn = _ref$renderFn === void 0 ? _testWrapper.render : _ref$renderFn;
+  return renderFn((0, _react2.jsx)(_index.Menu, (0, _extends2["default"])({}, defaultProps, props), (0, _map["default"])(items).call(items, function (section) {
+    var _context;
+    return (0, _react2.jsx)(_index.Section, section, (0, _map["default"])(_context = section.children).call(_context, function (li) {
+      return (0, _react2.jsx)(_index.Item, li);
+    }));
+  })));
+};
+
+// Needs to be added to each components test file
+(0, _universalComponentTest.universalComponentTests)({
+  renderComponent: function renderComponent(props) {
+    return (0, _react2.jsx)(_index.Menu, (0, _extends2["default"])({}, defaultProps, props), (0, _map["default"])(defaultMenuSections).call(defaultMenuSections, function (section) {
+      var _context2;
+      return (0, _react2.jsx)(_index.Section, section, (0, _map["default"])(_context2 = section.children).call(_context2, function (li) {
+        return (0, _react2.jsx)(_index.Item, (0, _extends2["default"])({}, li, {
+          sx: {
+            backgroundColor: 'orange'
+          }
+        }));
+      }));
+    }));
+  }
+});
+test('renders menu with menu sections and titles', function () {
+  getComponent();
+  var menu = _testWrapper.screen.getByRole('menu');
+  var menuSections = _testWrapper.screen.getAllByRole('group');
+  var menuTitle = _testWrapper.screen.getByText('Section 1');
+  expect(menu).toBeInTheDocument();
+  expect(menuTitle).toBeInTheDocument();
+  expect(menuSections).toHaveLength(defaultMenuSections.length);
+});
+test('renders sections with menu items', function () {
+  getComponent();
+  var menuItems = _testWrapper.screen.getAllByRole('menuitem');
+  expect(menuItems).toHaveLength((0, _reduce["default"])(defaultMenuSections).call(defaultMenuSections, function (acc, section) {
+    return acc + section.children.length;
+  }, 0));
+});
+test('custom props are passed into menuItem', function () {
+  getComponent();
+  var itemText1 = defaultMenuSections[0].children[0].children;
+  var menuItem1 = _testWrapper.screen.getByText(itemText1);
+  expect(menuItem1).toHaveStyleRule('background-color', 'orange');
+});
+test('renders separator before menu section if it is not the first section', function () {
+  getComponent();
+  var separators = _testWrapper.screen.getByRole('separator');
+  expect(separators).toBeInTheDocument();
+});

package/lib/cjs/components/MenuSection/index.d.ts

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

package/lib/cjs/components/MenuSection/index.js

@@ -0,0 +1,14 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+_Object$defineProperty(exports, "default", {
+  enumerable: true,
+  get: function get() {
+    return _MenuSection["default"];
+  }
+});
+var _MenuSection = _interopRequireDefault(require("./MenuSection"));

package/lib/cjs/components/PopoverMenu/PopoverMenu.stories.d.ts

@@ -8,3 +8,5 @@ export declare const Controlled: StoryFn;
 export declare const Placement: StoryFn;
 export declare const NotFlippable: StoryFn;
 export declare const NotClosedOnSelect: StoryFn;
+export declare const WithSeparator: StoryFn<PopoverMenuProps>;
+export declare const WithSections: StoryFn<PopoverMenuProps>;

package/lib/cjs/components/PopoverMenu/PopoverMenu.stories.js

@@ -8,7 +8,7 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = exports.Placement = exports.NotFlippable = exports.NotClosedOnSelect = exports.DefaultOpen = exports.Default = exports.Controlled = void 0;
+exports["default"] = exports.WithSeparator = exports.WithSections = exports.Placement = exports.NotFlippable = exports.NotClosedOnSelect = exports.DefaultOpen = exports.Default = exports.Controlled = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/slicedToArray"));
 var _react = _interopRequireWildcard(require("react"));
 var _DotsVerticalIcon = _interopRequireDefault(require("@pingux/mdi-react/DotsVerticalIcon"));
@@ -103,12 +103,12 @@ var DefaultOpen = function DefaultOpen() {
       }
     })), (0, _react2.jsx)(_index.Menu, {
       onAction: (0, _addonActions.action)('onAction'),
-      disabledKeys: ['duplicate']
+      disabledKeys: ['disabledItem']
     }, (0, _react2.jsx)(_index.Item, {
       key: "edit"
     }, "Edit"), (0, _react2.jsx)(_index.Item, {
-      key: "duplicate"
-    }, "Duplicate"), (0, _react2.jsx)(_index.Item, {
+      key: "disabledItem"
+    }, "Disabled Item"), (0, _react2.jsx)(_index.Item, {
       key: "delete",
       textValue: "delete"
     }, (0, _react2.jsx)(_index.Text, {
@@ -242,4 +242,72 @@ var NotClosedOnSelect = function NotClosedOnSelect() {
     }, "Delete")))))
   );
 };
-exports.NotClosedOnSelect = NotClosedOnSelect;
+exports.NotClosedOnSelect = NotClosedOnSelect;
+var WithSeparator = function WithSeparator(args) {
+  return (
+    // Application must be wrapped in an OverlayProvider so that it can be hidden from screen
+    // readers when an overlay opens.
+    (0, _react2.jsx)(_index.OverlayProvider, null, (0, _react2.jsx)(_index.PopoverMenu, args, (0, _react2.jsx)(_index.IconButton, {
+      "aria-label": "more options",
+      variant: "inverted"
+    }, (0, _react2.jsx)(_index.Icon, {
+      icon: _DotsVerticalIcon["default"],
+      size: "md",
+      title: {
+        name: 'Dots Vertical Icon'
+      }
+    })), (0, _react2.jsx)(_index.Menu, {
+      onAction: (0, _addonActions.action)('onAction'),
+      disabledKeys: ['disabledItem']
+    }, (0, _react2.jsx)(_index.Section, null, (0, _react2.jsx)(_index.Item, {
+      key: "edit"
+    }, "Edit")), (0, _react2.jsx)(_index.Section, null, (0, _react2.jsx)(_index.Item, {
+      key: "disabledItem"
+    }, "Disabled Item"), (0, _react2.jsx)(_index.Item, {
+      key: "delete",
+      textValue: "delete"
+    }, (0, _react2.jsx)(_index.Text, {
+      color: "critical.bright"
+    }, "Delete"))))))
+  );
+};
+exports.WithSeparator = WithSeparator;
+var WithSections = function WithSections(args) {
+  return (
+    // Application must be wrapped in an OverlayProvider so that it can be hidden from screen
+    // readers when an overlay opens.
+    (0, _react2.jsx)(_index.OverlayProvider, null, (0, _react2.jsx)(_index.PopoverMenu, args, (0, _react2.jsx)(_index.IconButton, {
+      "aria-label": "more options",
+      variant: "inverted"
+    }, (0, _react2.jsx)(_index.Icon, {
+      icon: _DotsVerticalIcon["default"],
+      size: "md",
+      title: {
+        name: 'Dots Vertical Icon'
+      }
+    })), (0, _react2.jsx)(_index.Menu, {
+      onAction: (0, _addonActions.action)('onAction'),
+      disabledKeys: ['disabledItem']
+    }, (0, _react2.jsx)(_index.Section, {
+      key: "section 1",
+      title: "Section 1"
+    }, (0, _react2.jsx)(_index.Item, {
+      key: "edit"
+    }, "Edit"), (0, _react2.jsx)(_index.Item, {
+      key: "disabledItem"
+    }, "Disabled Item"), (0, _react2.jsx)(_index.Item, {
+      key: "copy"
+    }, "Copy")), (0, _react2.jsx)(_index.Section, {
+      key: "section 2",
+      title: "Section 2"
+    }, (0, _react2.jsx)(_index.Item, {
+      key: "duplicate"
+    }, "Duplicate"), (0, _react2.jsx)(_index.Item, {
+      key: "delete",
+      textValue: "delete"
+    }, (0, _react2.jsx)(_index.Text, {
+      color: "critical.bright"
+    }, "Delete"))))))
+  );
+};
+exports.WithSections = WithSections;

package/lib/cjs/components/SelectField/SelectField.stories.js

@@ -264,18 +264,15 @@ exports.Controlled = Controlled;
 var WithNoneOption = function WithNoneOption() {
   return (0, _react2.jsx)(_index.SelectField, {
     label: "What's your favorite color?"
-  }, (0, _react2.jsx)(_index.Item, {
+  }, (0, _react2.jsx)(_index.Section, null, (0, _react2.jsx)(_index.Item, {
     key: "none"
-  }, "None"), (0, _react2.jsx)(_index.Item, {
-    isSeparator: true,
-    textValue: "-"
-  }, (0, _react2.jsx)(_index.Separator, null)), (0, _react2.jsx)(_index.Item, {
+  }, "None")), (0, _react2.jsx)(_index.Section, null, (0, _react2.jsx)(_index.Item, {
     key: "red"
   }, "Red"), (0, _react2.jsx)(_index.Item, {
     key: "blue"
   }, "Blue"), (0, _react2.jsx)(_index.Item, {
     key: "yellow"
-  }, "Yellow"));
+  }, "Yellow")));
 };
 exports.WithNoneOption = WithNoneOption;
 var WithSlots = function WithSlots() {

package/lib/cjs/styles/variants/variants.js

@@ -41,6 +41,7 @@ var _ListViewItem = _interopRequireDefault(require("../../components/ListViewIte
 var _Loader = _interopRequireDefault(require("../../components/Loader/Loader.styles"));
 var _Menu = _interopRequireDefault(require("../../components/Menu/Menu.styles"));
 var _MenuItem = _interopRequireDefault(require("../../components/MenuItem/MenuItem.styles"));
+var _MenuSection = _interopRequireDefault(require("../../components/MenuSection/MenuSection.styles"));
 var _Message = _interopRequireDefault(require("../../components/Messages/Message.styles"));
 var _Modal = _interopRequireDefault(require("../../components/Modal/Modal.styles"));
 var _NavBar = _interopRequireDefault(require("../../components/NavBar/NavBar.styles"));
@@ -90,6 +91,7 @@ var _default = _objectSpread({
   loader: _Loader["default"],
   menu: _Menu["default"],
   menuItem: _MenuItem["default"],
+  menuSection: _MenuSection["default"],
   message: _Message["default"],
   modal: _Modal["default"],
   navBar: _NavBar["default"],

package/lib/cjs/types/index.d.ts

@@ -30,6 +30,7 @@ export * from './listItem';
 export * from './loader';
 export * from './menu';
 export * from './menuItem';
+export * from './menuSection';
 export * from './messages';
 export * from './Modal';
 export * from './navBar';

package/lib/cjs/types/index.js

@@ -1,6 +1,6 @@
 "use strict";
 
-var _context, _context2, _context3, _context4, _context5, _context6, _context7, _context8, _context9, _context10, _context11, _context12, _context13, _context14, _context15, _context16, _context17, _context18, _context19, _context20, _context21, _context22, _context23, _context24, _context25, _context26, _context27, _context28, _context29, _context30, _context31, _context32, _context33, _context34, _context35, _context36, _context37, _context38, _context39, _context40, _context41, _context42, _context43, _context44, _context45, _context46, _context47, _context48, _context49, _context50, _context51, _context52;
+var _context, _context2, _context3, _context4, _context5, _context6, _context7, _context8, _context9, _context10, _context11, _context12, _context13, _context14, _context15, _context16, _context17, _context18, _context19, _context20, _context21, _context22, _context23, _context24, _context25, _context26, _context27, _context28, _context29, _context30, _context31, _context32, _context33, _context34, _context35, _context36, _context37, _context38, _context39, _context40, _context41, _context42, _context43, _context44, _context45, _context46, _context47, _context48, _context49, _context50, _context51, _context52, _context53;
 var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
 var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
 var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
@@ -359,8 +359,19 @@ _forEachInstanceProperty(_context32 = _Object$keys(_menuItem)).call(_context32,
     }
   });
 });
+var _menuSection = require("./menuSection");
+_forEachInstanceProperty(_context33 = _Object$keys(_menuSection)).call(_context33, function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _menuSection[key]) return;
+  _Object$defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _menuSection[key];
+    }
+  });
+});
 var _messages = require("./messages");
-_forEachInstanceProperty(_context33 = _Object$keys(_messages)).call(_context33, function (key) {
+_forEachInstanceProperty(_context34 = _Object$keys(_messages)).call(_context34, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _messages[key]) return;
   _Object$defineProperty(exports, key, {
@@ -371,7 +382,7 @@ _forEachInstanceProperty(_context33 = _Object$keys(_messages)).call(_context33,
   });
 });
 var _Modal = require("./Modal");
-_forEachInstanceProperty(_context34 = _Object$keys(_Modal)).call(_context34, function (key) {
+_forEachInstanceProperty(_context35 = _Object$keys(_Modal)).call(_context35, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _Modal[key]) return;
   _Object$defineProperty(exports, key, {
@@ -382,7 +393,7 @@ _forEachInstanceProperty(_context34 = _Object$keys(_Modal)).call(_context34, fun
   });
 });
 var _navBar = require("./navBar");
-_forEachInstanceProperty(_context35 = _Object$keys(_navBar)).call(_context35, function (key) {
+_forEachInstanceProperty(_context36 = _Object$keys(_navBar)).call(_context36, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _navBar[key]) return;
   _Object$defineProperty(exports, key, {
@@ -393,7 +404,7 @@ _forEachInstanceProperty(_context35 = _Object$keys(_navBar)).call(_context35, fu
   });
 });
 var _navSideBar = require("./navSideBar");
-_forEachInstanceProperty(_context36 = _Object$keys(_navSideBar)).call(_context36, function (key) {
+_forEachInstanceProperty(_context37 = _Object$keys(_navSideBar)).call(_context37, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _navSideBar[key]) return;
   _Object$defineProperty(exports, key, {
@@ -404,7 +415,7 @@ _forEachInstanceProperty(_context36 = _Object$keys(_navSideBar)).call(_context36
   });
 });
 var _overlayPanel = require("./overlayPanel");
-_forEachInstanceProperty(_context37 = _Object$keys(_overlayPanel)).call(_context37, function (key) {
+_forEachInstanceProperty(_context38 = _Object$keys(_overlayPanel)).call(_context38, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _overlayPanel[key]) return;
   _Object$defineProperty(exports, key, {
@@ -415,7 +426,7 @@ _forEachInstanceProperty(_context37 = _Object$keys(_overlayPanel)).call(_context
   });
 });
 var _popoverContainer = require("./popoverContainer");
-_forEachInstanceProperty(_context38 = _Object$keys(_popoverContainer)).call(_context38, function (key) {
+_forEachInstanceProperty(_context39 = _Object$keys(_popoverContainer)).call(_context39, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _popoverContainer[key]) return;
   _Object$defineProperty(exports, key, {
@@ -426,7 +437,7 @@ _forEachInstanceProperty(_context38 = _Object$keys(_popoverContainer)).call(_con
   });
 });
 var _popoverMenu = require("./popoverMenu");
-_forEachInstanceProperty(_context39 = _Object$keys(_popoverMenu)).call(_context39, function (key) {
+_forEachInstanceProperty(_context40 = _Object$keys(_popoverMenu)).call(_context40, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _popoverMenu[key]) return;
   _Object$defineProperty(exports, key, {
@@ -437,7 +448,7 @@ _forEachInstanceProperty(_context39 = _Object$keys(_popoverMenu)).call(_context3
   });
 });
 var _progressBar = require("./progressBar");
-_forEachInstanceProperty(_context40 = _Object$keys(_progressBar)).call(_context40, function (key) {
+_forEachInstanceProperty(_context41 = _Object$keys(_progressBar)).call(_context41, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _progressBar[key]) return;
   _Object$defineProperty(exports, key, {
@@ -448,7 +459,7 @@ _forEachInstanceProperty(_context40 = _Object$keys(_progressBar)).call(_context4
   });
 });
 var _requirementsList = require("./requirementsList");
-_forEachInstanceProperty(_context41 = _Object$keys(_requirementsList)).call(_context41, function (key) {
+_forEachInstanceProperty(_context42 = _Object$keys(_requirementsList)).call(_context42, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _requirementsList[key]) return;
   _Object$defineProperty(exports, key, {
@@ -459,7 +470,7 @@ _forEachInstanceProperty(_context41 = _Object$keys(_requirementsList)).call(_con
   });
 });
 var _rockerButtonGroup = require("./rockerButtonGroup");
-_forEachInstanceProperty(_context42 = _Object$keys(_rockerButtonGroup)).call(_context42, function (key) {
+_forEachInstanceProperty(_context43 = _Object$keys(_rockerButtonGroup)).call(_context43, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _rockerButtonGroup[key]) return;
   _Object$defineProperty(exports, key, {
@@ -470,7 +481,7 @@ _forEachInstanceProperty(_context42 = _Object$keys(_rockerButtonGroup)).call(_co
   });
 });
 var _scrollBox = require("./scrollBox");
-_forEachInstanceProperty(_context43 = _Object$keys(_scrollBox)).call(_context43, function (key) {
+_forEachInstanceProperty(_context44 = _Object$keys(_scrollBox)).call(_context44, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _scrollBox[key]) return;
   _Object$defineProperty(exports, key, {
@@ -481,7 +492,7 @@ _forEachInstanceProperty(_context43 = _Object$keys(_scrollBox)).call(_context43,
   });
 });
 var _separator = require("./separator");
-_forEachInstanceProperty(_context44 = _Object$keys(_separator)).call(_context44, function (key) {
+_forEachInstanceProperty(_context45 = _Object$keys(_separator)).call(_context45, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _separator[key]) return;
   _Object$defineProperty(exports, key, {
@@ -492,7 +503,7 @@ _forEachInstanceProperty(_context44 = _Object$keys(_separator)).call(_context44,
   });
 });
 var _shared = require("./shared");
-_forEachInstanceProperty(_context45 = _Object$keys(_shared)).call(_context45, function (key) {
+_forEachInstanceProperty(_context46 = _Object$keys(_shared)).call(_context46, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _shared[key]) return;
   _Object$defineProperty(exports, key, {
@@ -503,7 +514,7 @@ _forEachInstanceProperty(_context45 = _Object$keys(_shared)).call(_context45, fu
   });
 });
 var _tab = require("./tab");
-_forEachInstanceProperty(_context46 = _Object$keys(_tab)).call(_context46, function (key) {
+_forEachInstanceProperty(_context47 = _Object$keys(_tab)).call(_context47, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _tab[key]) return;
   _Object$defineProperty(exports, key, {
@@ -514,7 +525,7 @@ _forEachInstanceProperty(_context46 = _Object$keys(_tab)).call(_context46, funct
   });
 });
 var _table = require("./table");
-_forEachInstanceProperty(_context47 = _Object$keys(_table)).call(_context47, function (key) {
+_forEachInstanceProperty(_context48 = _Object$keys(_table)).call(_context48, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _table[key]) return;
   _Object$defineProperty(exports, key, {
@@ -525,7 +536,7 @@ _forEachInstanceProperty(_context47 = _Object$keys(_table)).call(_context47, fun
   });
 });
 var _tabs = require("./tabs");
-_forEachInstanceProperty(_context48 = _Object$keys(_tabs)).call(_context48, function (key) {
+_forEachInstanceProperty(_context49 = _Object$keys(_tabs)).call(_context49, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _tabs[key]) return;
   _Object$defineProperty(exports, key, {
@@ -536,7 +547,7 @@ _forEachInstanceProperty(_context48 = _Object$keys(_tabs)).call(_context48, func
   });
 });
 var _text = require("./text");
-_forEachInstanceProperty(_context49 = _Object$keys(_text)).call(_context49, function (key) {
+_forEachInstanceProperty(_context50 = _Object$keys(_text)).call(_context50, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _text[key]) return;
   _Object$defineProperty(exports, key, {
@@ -547,7 +558,7 @@ _forEachInstanceProperty(_context49 = _Object$keys(_text)).call(_context49, func
   });
 });
 var _textField = require("./textField");
-_forEachInstanceProperty(_context50 = _Object$keys(_textField)).call(_context50, function (key) {
+_forEachInstanceProperty(_context51 = _Object$keys(_textField)).call(_context51, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _textField[key]) return;
   _Object$defineProperty(exports, key, {
@@ -558,7 +569,7 @@ _forEachInstanceProperty(_context50 = _Object$keys(_textField)).call(_context50,
   });
 });
 var _timefield = require("./timefield");
-_forEachInstanceProperty(_context51 = _Object$keys(_timefield)).call(_context51, function (key) {
+_forEachInstanceProperty(_context52 = _Object$keys(_timefield)).call(_context52, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _timefield[key]) return;
   _Object$defineProperty(exports, key, {
@@ -569,7 +580,7 @@ _forEachInstanceProperty(_context51 = _Object$keys(_timefield)).call(_context51,
   });
 });
 var _tooltipTrigger = require("./tooltipTrigger");
-_forEachInstanceProperty(_context52 = _Object$keys(_tooltipTrigger)).call(_context52, function (key) {
+_forEachInstanceProperty(_context53 = _Object$keys(_tooltipTrigger)).call(_context53, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _tooltipTrigger[key]) return;
   _Object$defineProperty(exports, key, {

package/lib/cjs/types/menuSection.d.ts

@@ -0,0 +1,24 @@
+import { Node, TreeState } from 'react-stately';
+import { TestingAttributes } from './shared/test';
+import { BoxProps } from './box';
+export interface MenuSectionProps extends BoxProps, TestingAttributes {
+    /** Whether the menu item is currently pressed. */
+    isPressed?: boolean;
+    /**
+     * Whether the containing menu has keyboard focus.
+     * Used to determine when to present hover vs focus styling.
+    */
+    isFocusVisible?: boolean;
+    /**
+     * Whether menu item should receive focus state on hover.
+    */
+    isNotFocusedOnHover?: boolean;
+    /** A screen reader only label for the menu item. */
+    /** Handler that is called when the menu should close after selecting an item. */
+    onClose?: () => void;
+    /** Handler that is called when the user activates the item. */
+    onAction?: () => void;
+    section: Node<object>;
+    state: TreeState<object>;
+    defaultSelectedKey?: string | number;
+}

package/lib/cjs/types/menuSection.js

@@ -0,0 +1,6 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/components/LinkSelectField/LinkSelectField.stories.js

@@ -29,7 +29,7 @@ import React, { useState } from 'react';
 import { OverlayProvider } from 'react-aria';
 import { useAsyncList } from 'react-stately';
 import DocsLayout from '../../../.storybook/storybookDocsLayout';
-import { Box, Item, LinkSelectField, Separator } from '../../index';
+import { Box, Item, LinkSelectField, Section } from '../../index';
 import { ariaAttributeBaseArgTypes } from '../../utils/docUtils/ariaAttributes';
 import { inputFieldAttributeBaseArgTypes } from '../../utils/docUtils/fieldAttributes';
 import { statusArgTypes } from '../../utils/docUtils/statusProp';
@@ -166,18 +166,15 @@ export var Controlled = function Controlled() {
 export var WithNoneOption = function WithNoneOption() {
   return ___EmotionJSX(LinkSelectField, {
     label: "What's your favorite color?"
-  }, ___EmotionJSX(Item, {
+  }, ___EmotionJSX(Section, null, ___EmotionJSX(Item, {
     key: "none"
-  }, "None"), ___EmotionJSX(Item, {
-    isSeparator: true,
-    textValue: "-"
-  }, ___EmotionJSX(Separator, null)), ___EmotionJSX(Item, {
+  }, "None")), ___EmotionJSX(Section, null, ___EmotionJSX(Item, {
     key: "red"
   }, "Red"), ___EmotionJSX(Item, {
     key: "blue"
   }, "Blue"), ___EmotionJSX(Item, {
     key: "yellow"
-  }, "Yellow"));
+  }, "Yellow")));
 };
 export var DisabledField = function DisabledField() {
   return ___EmotionJSX(LinkSelectField, {

package/lib/components/Menu/Menu.js

@@ -24,6 +24,7 @@ import { useLocalOrForwardRef, usePropWarning } from '../../hooks';
 import ORIENTATION from '../../utils/devUtils/constants/orientation';
 import Box from '../Box';
 import MenuItem from '../MenuItem';
+import MenuSection from '../MenuSection';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var Menu = /*#__PURE__*/forwardRef(function (props, ref) {
   var _context;
@@ -66,10 +67,21 @@ var Menu = /*#__PURE__*/forwardRef(function (props, ref) {
     "aria-orientation": ORIENTATION.VERTICAL
   }, others, mergeProps(focusProps, menuProps, hoverProps), {
     role: "menu"
-  }), _mapInstanceProperty(_context = _Array$from(state.collection)).call(_context, function (item) {
+  }), _mapInstanceProperty(_context = _Array$from(state.collection)).call(_context, function (element) {
+    if (element.type === 'section') {
+      return ___EmotionJSX(MenuSection, {
+        key: element.key,
+        section: element,
+        state: state,
+        onAction: onAction,
+        isDisabled: isDisabled,
+        isFocusVisible: isFocusVisible,
+        isNotFocusedOnHover: isNotFocusedOnHover
+      });
+    }
     return ___EmotionJSX(MenuItem, {
-      key: item.key,
-      item: item,
+      key: element.key,
+      item: element,
       state: state,
       onAction: onAction,
       isDisabled: isDisabled,

package/lib/components/Menu/Menu.test.js

@@ -4,7 +4,7 @@ import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/inst
 import _Set from "@babel/runtime-corejs3/core-js-stable/set";
 import React from 'react';
 import userEvent from '@testing-library/user-event';
-import { Item, Menu } from '../../index';
+import { Item, Menu, Section } from '../../index';
 import ORIENTATION from '../../utils/devUtils/constants/orientation';
 import { fireEvent, render, screen } from '../../utils/testUtils/testWrapper';
 import { universalComponentTests } from '../../utils/testUtils/universalComponentTest';
@@ -51,6 +51,29 @@ test('should render basic menu with children', function () {
   expect(menuItems).toHaveLength(3);
   expect(menu).toHaveAttribute('aria-orientation', ORIENTATION.VERTICAL);
 });
+test('should render sections when sections are passed as Children', function () {
+  var menuSections = [{
+    key: 'menuSection 1',
+    children: defaultItems
+  }, {
+    key: 'menuSection 2',
+    children: defaultItems
+  }];
+  render(___EmotionJSX(Menu, defaultProps, _mapInstanceProperty(menuSections).call(menuSections, function (section) {
+    var _context;
+    return ___EmotionJSX(Section, section, _mapInstanceProperty(_context = section.children).call(_context, function (item) {
+      return ___EmotionJSX(Item, _extends({
+        key: item.id
+      }, item));
+    }));
+  })));
+  var menu = screen.queryByRole('menu');
+  expect(menu).toBeInTheDocument();
+  var menuSection = screen.queryAllByRole('group');
+  expect(menuSection).toHaveLength(2);
+  var menuItems = screen.getAllByRole('menuitem');
+  expect(menuItems).toHaveLength(6);
+});
 test('should render items when selectionMode is set to single', function () {
   getComponent({
     selectionMode: 'single'

package/lib/components/MenuSection/MenuSection.js

@@ -0,0 +1,64 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/map";
+import _Array$from from "@babel/runtime-corejs3/core-js-stable/array/from";
+import React, { forwardRef } from 'react';
+import { useMenuSection } from 'react-aria';
+import { useLocalOrForwardRef } from '../../hooks';
+import Box from '../Box';
+import MenuItem from '../MenuItem';
+import Separator from '../Separator';
+
+/**
+ * Menu Section component intended to be used within Menu or PopupMenu.
+ * This component is not intented to be used outside of Menu or independently.
+ * Utilizes [React Aria](https://react-spectrum.adobe.com/react-aria/useMenu.html)
+ */
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var MenuSection = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _context;
+  var section = props.section,
+    state = props.state,
+    onAction = props.onAction,
+    isDisabled = props.isDisabled,
+    isFocusVisible = props.isFocusVisible,
+    isNotFocusedOnHover = props.isNotFocusedOnHover;
+  var menuSectionRef = useLocalOrForwardRef(ref);
+  var _useMenuSection = useMenuSection({
+      heading: section.rendered,
+      'aria-label': section['aria-label']
+    }),
+    itemProps = _useMenuSection.itemProps,
+    groupProps = _useMenuSection.groupProps,
+    headingProps = _useMenuSection.headingProps;
+  return ___EmotionJSX(React.Fragment, null, section.key !== state.collection.getFirstKey() && ___EmotionJSX(Separator, {
+    as: "li",
+    p: 0,
+    m: 0
+  }), ___EmotionJSX(Box, _extends({
+    as: "li"
+  }, itemProps, {
+    ref: menuSectionRef,
+    role: "presentation"
+  }), section.rendered && ___EmotionJSX(Box, _extends({
+    as: "span",
+    variant: "menuSection.sectionTitle"
+  }, headingProps, {
+    role: "presentation"
+  }), section.rendered), ___EmotionJSX(Box, _extends({
+    as: "ul",
+    variant: "menuSection.section"
+  }, groupProps, {
+    role: "group"
+  }), _mapInstanceProperty(_context = _Array$from(section.childNodes)).call(_context, function (node) {
+    return ___EmotionJSX(MenuItem, {
+      key: node.key,
+      item: node,
+      state: state,
+      onAction: onAction,
+      isDisabled: isDisabled,
+      isFocusVisible: isFocusVisible,
+      isNotFocusedOnHover: isNotFocusedOnHover
+    });
+  }))));
+});
+export default MenuSection;

package/lib/components/MenuSection/MenuSection.styles.js

@@ -0,0 +1,27 @@
+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";
+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 menu from '../Menu/Menu.styles';
+var section = _objectSpread(_objectSpread({}, menu), {}, {
+  borderRadius: 0
+});
+var sectionTitle = {
+  fontSize: 'sm',
+  fontWeight: '3',
+  color: 'text.secondary',
+  height: '36px',
+  ml: 'sm',
+  justifyContent: 'center'
+};
+export default {
+  section: section,
+  sectionTitle: sectionTitle
+};

package/lib/components/MenuSection/MenuSection.test.js

@@ -0,0 +1,97 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/map";
+import _reduceInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/reduce";
+import React from 'react';
+import { Item, Menu, Section } from '../../index';
+import { render, screen } from '../../utils/testUtils/testWrapper';
+import { universalComponentTests } from '../../utils/testUtils/universalComponentTest';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var testId = 'testId';
+var defaultMenuSections = [{
+  key: 'menuSection 1',
+  'data-id': 'menuSection1',
+  title: 'Section 1',
+  children: [{
+    key: 'menuItem1',
+    children: 'MenuItem 1',
+    'data-id': 'menuItem1',
+    isPressed: false,
+    backgroundColor: 'orange'
+  }]
+}, {
+  key: 'menuSection 2',
+  'data-id': 'menuSection2',
+  children: [{
+    key: 'menuItem2',
+    children: 'MenuItem 2',
+    'data-id': 'menuItem1',
+    isPressed: false
+  }, {
+    key: 'menuItem3',
+    children: 'MenuItem 3',
+    'data-id': 'menuItem1',
+    isPressed: false
+  }]
+}];
+var defaultProps = {
+  'data-testid': testId,
+  defaultSelectedKey: 'menuItem1',
+  'aria-label': 'testLabel'
+};
+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$items = _ref.items,
+    items = _ref$items === void 0 ? defaultMenuSections : _ref$items,
+    _ref$renderFn = _ref.renderFn,
+    renderFn = _ref$renderFn === void 0 ? render : _ref$renderFn;
+  return renderFn(___EmotionJSX(Menu, _extends({}, defaultProps, props), _mapInstanceProperty(items).call(items, function (section) {
+    var _context;
+    return ___EmotionJSX(Section, section, _mapInstanceProperty(_context = section.children).call(_context, function (li) {
+      return ___EmotionJSX(Item, li);
+    }));
+  })));
+};
+
+// Needs to be added to each components test file
+universalComponentTests({
+  renderComponent: function renderComponent(props) {
+    return ___EmotionJSX(Menu, _extends({}, defaultProps, props), _mapInstanceProperty(defaultMenuSections).call(defaultMenuSections, function (section) {
+      var _context2;
+      return ___EmotionJSX(Section, section, _mapInstanceProperty(_context2 = section.children).call(_context2, function (li) {
+        return ___EmotionJSX(Item, _extends({}, li, {
+          sx: {
+            backgroundColor: 'orange'
+          }
+        }));
+      }));
+    }));
+  }
+});
+test('renders menu with menu sections and titles', function () {
+  getComponent();
+  var menu = screen.getByRole('menu');
+  var menuSections = screen.getAllByRole('group');
+  var menuTitle = screen.getByText('Section 1');
+  expect(menu).toBeInTheDocument();
+  expect(menuTitle).toBeInTheDocument();
+  expect(menuSections).toHaveLength(defaultMenuSections.length);
+});
+test('renders sections with menu items', function () {
+  getComponent();
+  var menuItems = screen.getAllByRole('menuitem');
+  expect(menuItems).toHaveLength(_reduceInstanceProperty(defaultMenuSections).call(defaultMenuSections, function (acc, section) {
+    return acc + section.children.length;
+  }, 0));
+});
+test('custom props are passed into menuItem', function () {
+  getComponent();
+  var itemText1 = defaultMenuSections[0].children[0].children;
+  var menuItem1 = screen.getByText(itemText1);
+  expect(menuItem1).toHaveStyleRule('background-color', 'orange');
+});
+test('renders separator before menu section if it is not the first section', function () {
+  getComponent();
+  var separators = screen.getByRole('separator');
+  expect(separators).toBeInTheDocument();
+});

package/lib/components/MenuSection/index.js

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

package/lib/components/PopoverMenu/PopoverMenu.stories.js

@@ -4,7 +4,7 @@ import DotsVerticalIcon from '@pingux/mdi-react/DotsVerticalIcon';
 import { action } from '@storybook/addon-actions';
 import { withDesign } from 'storybook-addon-designs';
 import DocsLayout from '../../../.storybook/storybookDocsLayout';
-import { Icon, IconButton, Item, Menu, OverlayProvider, PopoverMenu, Text } from '../../index';
+import { Icon, IconButton, Item, Menu, OverlayProvider, PopoverMenu, Section, Text } from '../../index';
 import { FIGMA_LINKS } from '../../utils/designUtils/figmaLinks';
 import PopoverMenuReadme from './PopoverMenu.mdx';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -88,12 +88,12 @@ export var DefaultOpen = function DefaultOpen() {
       }
     })), ___EmotionJSX(Menu, {
       onAction: action('onAction'),
-      disabledKeys: ['duplicate']
+      disabledKeys: ['disabledItem']
     }, ___EmotionJSX(Item, {
       key: "edit"
     }, "Edit"), ___EmotionJSX(Item, {
-      key: "duplicate"
-    }, "Duplicate"), ___EmotionJSX(Item, {
+      key: "disabledItem"
+    }, "Disabled Item"), ___EmotionJSX(Item, {
       key: "delete",
       textValue: "delete"
     }, ___EmotionJSX(Text, {
@@ -222,4 +222,70 @@ export var NotClosedOnSelect = function NotClosedOnSelect() {
       color: "critical.bright"
     }, "Delete")))))
   );
+};
+export var WithSeparator = function WithSeparator(args) {
+  return (
+    // Application must be wrapped in an OverlayProvider so that it can be hidden from screen
+    // readers when an overlay opens.
+    ___EmotionJSX(OverlayProvider, null, ___EmotionJSX(PopoverMenu, args, ___EmotionJSX(IconButton, {
+      "aria-label": "more options",
+      variant: "inverted"
+    }, ___EmotionJSX(Icon, {
+      icon: DotsVerticalIcon,
+      size: "md",
+      title: {
+        name: 'Dots Vertical Icon'
+      }
+    })), ___EmotionJSX(Menu, {
+      onAction: action('onAction'),
+      disabledKeys: ['disabledItem']
+    }, ___EmotionJSX(Section, null, ___EmotionJSX(Item, {
+      key: "edit"
+    }, "Edit")), ___EmotionJSX(Section, null, ___EmotionJSX(Item, {
+      key: "disabledItem"
+    }, "Disabled Item"), ___EmotionJSX(Item, {
+      key: "delete",
+      textValue: "delete"
+    }, ___EmotionJSX(Text, {
+      color: "critical.bright"
+    }, "Delete"))))))
+  );
+};
+export var WithSections = function WithSections(args) {
+  return (
+    // Application must be wrapped in an OverlayProvider so that it can be hidden from screen
+    // readers when an overlay opens.
+    ___EmotionJSX(OverlayProvider, null, ___EmotionJSX(PopoverMenu, args, ___EmotionJSX(IconButton, {
+      "aria-label": "more options",
+      variant: "inverted"
+    }, ___EmotionJSX(Icon, {
+      icon: DotsVerticalIcon,
+      size: "md",
+      title: {
+        name: 'Dots Vertical Icon'
+      }
+    })), ___EmotionJSX(Menu, {
+      onAction: action('onAction'),
+      disabledKeys: ['disabledItem']
+    }, ___EmotionJSX(Section, {
+      key: "section 1",
+      title: "Section 1"
+    }, ___EmotionJSX(Item, {
+      key: "edit"
+    }, "Edit"), ___EmotionJSX(Item, {
+      key: "disabledItem"
+    }, "Disabled Item"), ___EmotionJSX(Item, {
+      key: "copy"
+    }, "Copy")), ___EmotionJSX(Section, {
+      key: "section 2",
+      title: "Section 2"
+    }, ___EmotionJSX(Item, {
+      key: "duplicate"
+    }, "Duplicate"), ___EmotionJSX(Item, {
+      key: "delete",
+      textValue: "delete"
+    }, ___EmotionJSX(Text, {
+      color: "critical.bright"
+    }, "Delete"))))))
+  );
 };

package/lib/components/SelectField/SelectField.stories.js

@@ -31,7 +31,7 @@ import { OverlayProvider } from 'react-aria';
 import { useAsyncList } from 'react-stately';
 import CalendarRangeIcon from '@pingux/mdi-react/CalendarRangeIcon';
 import DocsLayout from '../../../.storybook/storybookDocsLayout';
-import { Icon, Item, Section, SelectField, Separator } from '../../index';
+import { Icon, Item, Section, SelectField } from '../../index';
 import { modes as labelModes } from '../../utils/devUtils/constants/labelModes';
 import { ariaAttributeBaseArgTypes } from '../../utils/docUtils/ariaAttributes';
 import { inputFieldAttributeBaseArgTypes } from '../../utils/docUtils/fieldAttributes';
@@ -247,18 +247,15 @@ export var Controlled = function Controlled() {
 export var WithNoneOption = function WithNoneOption() {
   return ___EmotionJSX(SelectField, {
     label: "What's your favorite color?"
-  }, ___EmotionJSX(Item, {
+  }, ___EmotionJSX(Section, null, ___EmotionJSX(Item, {
     key: "none"
-  }, "None"), ___EmotionJSX(Item, {
-    isSeparator: true,
-    textValue: "-"
-  }, ___EmotionJSX(Separator, null)), ___EmotionJSX(Item, {
+  }, "None")), ___EmotionJSX(Section, null, ___EmotionJSX(Item, {
     key: "red"
   }, "Red"), ___EmotionJSX(Item, {
     key: "blue"
   }, "Blue"), ___EmotionJSX(Item, {
     key: "yellow"
-  }, "Yellow"));
+  }, "Yellow")));
 };
 export var WithSlots = function WithSlots() {
   return ___EmotionJSX(SelectField, {

package/lib/styles/variants/variants.js

@@ -34,6 +34,7 @@ import listViewItem from '../../components/ListViewItem/ListViewItem.styles';
 import loader from '../../components/Loader/Loader.styles';
 import menu from '../../components/Menu/Menu.styles';
 import menuItem from '../../components/MenuItem/MenuItem.styles';
+import menuSection from '../../components/MenuSection/MenuSection.styles';
 import message from '../../components/Messages/Message.styles';
 import modal from '../../components/Modal/Modal.styles';
 import navBar from '../../components/NavBar/NavBar.styles';
@@ -79,6 +80,7 @@ export default _objectSpread({
   loader: loader,
   menu: menu,
   menuItem: menuItem,
+  menuSection: menuSection,
   message: message,
   modal: modal,
   navBar: navBar,

package/lib/types/index.js

@@ -30,6 +30,7 @@ export * from './listItem';
 export * from './loader';
 export * from './menu';
 export * from './menuItem';
+export * from './menuSection';
 export * from './messages';
 export * from './Modal';
 export * from './navBar';

package/lib/types/menuSection.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pingux/astro",
-  "version": "2.84.0-alpha.2",
+  "version": "2.84.0-alpha.3",
   "description": "React component library for Ping Identity's design system",
   "repository": {
     "type": "git",