@primer/components 0.0.0-2021111171525 → 0.0.0-20211111716

package/lib/Dropdown.js

@@ -7,19 +7,17 @@ exports.default = void 0;
 
 var _react = _interopRequireDefault(require("react"));
 
-var _propTypes = _interopRequireDefault(require("prop-types"));
-
 var _styledComponents = _interopRequireDefault(require("styled-components"));
 
 var _Button = _interopRequireDefault(require("./Button"));
 
-var _Details = _interopRequireDefault(require("./Details"));
-
 var _constants = require("./constants");
 
+var _Details = _interopRequireDefault(require("./Details"));
+
 var _DropdownStyles = _interopRequireDefault(require("./DropdownStyles"));
 
-var _theme = _interopRequireDefault(require("./theme"));
+var _useDetails = _interopRequireDefault(require("./hooks/useDetails"));
 
 var _sx = _interopRequireDefault(require("./sx"));
 
@@ -29,7 +27,7 @@ function _extends() { _extends = Object.assign || function (target) { for (var i
 
 const StyledDetails = (0, _styledComponents.default)(_Details.default).withConfig({
   displayName: "Dropdown__StyledDetails",
-  componentId: "sc-3wysgd-0"
+  componentId: "sc-16yoecj-0"
 })(["position:relative;display:inline-block;"]);
 
 const Dropdown = ({
@@ -37,73 +35,60 @@ const Dropdown = ({
   className,
   ...rest
 }) => {
+  const {
+    getDetailsProps
+  } = (0, _useDetails.default)({
+    closeOnOutsideClick: true
+  });
   return /*#__PURE__*/_react.default.createElement(StyledDetails, _extends({
-    closeOnOutsideClick: true,
     className: className
-  }, rest), children);
+  }, getDetailsProps(), rest), children);
 };
 
 Dropdown.displayName = "Dropdown";
 
-Dropdown.Button = ({
+const DropdownButton = ({
   children,
   ...rest
 }) => {
   return /*#__PURE__*/_react.default.createElement(_Button.default, _extends({
     as: "summary",
     "aria-haspopup": "true"
-  }, rest), children, /*#__PURE__*/_react.default.createElement(Dropdown.Caret, null));
+  }, rest), children, /*#__PURE__*/_react.default.createElement(DropdownCaret, null));
 };
 
-Dropdown.Caret = _styledComponents.default.div.withConfig({
-  displayName: "Dropdown__Caret",
-  componentId: "sc-3wysgd-1"
-})(["border:4px solid transparent;margin-left:12px;border-top-color:currentcolor;border-bottom-width:0;content:'';display:inline-block;height:0;vertical-align:middle;width:0;", ";", ";"], _constants.COMMON, _sx.default);
-Dropdown.Menu = _styledComponents.default.ul.withConfig({
-  displayName: "Dropdown__Menu",
-  componentId: "sc-3wysgd-2"
-})(["background-clip:padding-box;background-color:", ";border:1px solid rgba(27,31,35,0.15);border-radius:", ";box-shadow:0 3px 12px rgba(27,31,35,0.15);left:0;list-style:none;margin-top:2px;padding:5px 0 5px 0 !important;position:absolute;top:100%;width:160px;z-index:100;&::before{position:absolute;display:inline-block;content:'';}&::after{position:absolute;display:inline-block;content:'';}&::before{border:8px solid transparent;border-bottom-color:", ";}&::after{border:7px solid transparent;border-bottom-color:", ";}> ul{list-style:none;}", ";", ";", ";"], (0, _constants.get)('colors.white'), (0, _constants.get)('radii.2'), (0, _constants.get)('colors.blackfade15'), (0, _constants.get)('colors.white'), props => props.direction ? (0, _DropdownStyles.default)(props.theme, props.direction) : '', _constants.COMMON, _sx.default);
-Dropdown.Item = _styledComponents.default.li.withConfig({
-  displayName: "Dropdown__Item",
-  componentId: "sc-3wysgd-3"
-})(["display:block;padding:", " 10px ", " 15px;overflow:hidden;color:", ";text-overflow:ellipsis;white-space:nowrap;a{color:", ";text-decoration:none;display:block;overflow:hidden;color:", ";text-overflow:ellipsis;white-space:nowrap;}&:focus,a:focus{color:", ";text-decoration:none;background-color:", ";}&:hover,&:hover a{color:", ";text-decoration:none;background-color:", ";outline:none;}", ";", ";"], (0, _constants.get)('space.1'), (0, _constants.get)('space.1'), (0, _constants.get)('colors.gray.9'), (0, _constants.get)('colors.gray.9'), (0, _constants.get)('colors.gray.9'), (0, _constants.get)('colors.white'), (0, _constants.get)('colors.blue.5'), (0, _constants.get)('colors.white'), (0, _constants.get)('colors.blue.5'), _constants.COMMON, _sx.default);
-Dropdown.Menu.propTypes = {
-  direction: _propTypes.default.oneOf(['ne', 'e', 'se', 's', 'sw', 'w']),
-  ..._constants.COMMON.propTypes,
-  ..._sx.default.propTypes
-};
-Dropdown.Menu.defaultProps = {
-  direction: 'sw',
-  theme: _theme.default
-};
-Dropdown.Menu.displayName = 'Dropdown.Menu';
-Dropdown.Item.defaultProps = {
-  theme: _theme.default
-};
-Dropdown.Item.propTypes = { ..._constants.COMMON.propTypes,
-  ..._sx.default.propTypes
-};
-Dropdown.Item.displayName = 'Dropdown.Item';
-Dropdown.Button.defaultProps = {
-  theme: _theme.default,
-  ..._Button.default.defaultProps
-};
-Dropdown.Button.propTypes = { ..._Button.default.propTypes
-};
-Dropdown.Button.displayName = 'Dropdown.Button';
-Dropdown.Caret.defaultProps = {
-  theme: _theme.default
-};
-Dropdown.Caret.propTypes = { ..._constants.COMMON.propTypes,
-  ..._sx.default.propTypes
-};
-Dropdown.Caret.displayName = 'Dropdown.Caret';
-Dropdown.defaultProps = {
-  theme: _theme.default,
-  ..._Details.default.defaultProps
-};
-Dropdown.propTypes = { ..._Details.default.propTypes,
-  ..._constants.COMMON.propTypes
+DropdownButton.displayName = "DropdownButton";
+
+const DropdownCaret = _styledComponents.default.div.withConfig({
+  displayName: "Dropdown__DropdownCaret",
+  componentId: "sc-16yoecj-1"
+})(["border:4px solid transparent;margin-left:12px;border-top-color:currentcolor;border-bottom-width:0;content:'';display:inline-block;height:0;vertical-align:middle;width:0;", ";"], _sx.default);
+
+const DropdownMenu = _styledComponents.default.ul.withConfig({
+  displayName: "Dropdown__DropdownMenu",
+  componentId: "sc-16yoecj-2"
+})(["background-clip:padding-box;background-color:", ";border:1px solid ", ";border-radius:", ";box-shadow:", ";left:0;list-style:none;margin-top:2px;padding:5px 0 5px 0 !important;position:absolute;top:100%;width:160px;z-index:100;&::before{position:absolute;display:inline-block;content:'';}&::after{position:absolute;display:inline-block;content:'';}&::before{border:8px solid transparent;border-bottom-color:", ";}&::after{border:7px solid transparent;border-bottom-color:", ";}> ul{list-style:none;}", ";", ";"], (0, _constants.get)('colors.canvas.overlay'), (0, _constants.get)('colors.border.default'), (0, _constants.get)('radii.2'), (0, _constants.get)('shadows.shadow.large'), (0, _constants.get)('colors.canvas.overlay'), (0, _constants.get)('colors.canvas.overlay'), props => props.direction ? (0, _DropdownStyles.default)(props.theme, props.direction) : '', _sx.default);
+
+const DropdownItem = _styledComponents.default.li.withConfig({
+  displayName: "Dropdown__DropdownItem",
+  componentId: "sc-16yoecj-3"
+})(["display:block;padding:", " 10px ", " 15px;overflow:hidden;color:", ";text-overflow:ellipsis;white-space:nowrap;a{color:", ";text-decoration:none;display:block;overflow:hidden;color:", ";text-overflow:ellipsis;white-space:nowrap;}&:focus,a:focus{color:", ";text-decoration:none;background-color:", ";}&:hover,&:hover a{color:", ";text-decoration:none;background-color:", ";outline:none;}", ";"], (0, _constants.get)('space.1'), (0, _constants.get)('space.1'), (0, _constants.get)('colors.fg.default'), (0, _constants.get)('colors.fg.default'), (0, _constants.get)('colors.fg.default'), (0, _constants.get)('colors.fg.onEmphasis'), (0, _constants.get)('colors.accent.emphasis'), (0, _constants.get)('colors.fg.onEmphasis'), (0, _constants.get)('colors.accent.emphasis'), _sx.default);
+
+DropdownMenu.defaultProps = {
+  direction: 'sw'
 };
-var _default = Dropdown;
+DropdownMenu.displayName = 'Dropdown.Menu';
+DropdownItem.displayName = 'Dropdown.Item';
+DropdownButton.defaultProps = _Button.default.defaultProps;
+DropdownButton.displayName = 'Dropdown.Button';
+DropdownCaret.displayName = 'Dropdown.Caret';
+Dropdown.defaultProps = _Details.default.defaultProps;
+
+var _default = Object.assign(Dropdown, {
+  Caret: DropdownCaret,
+  Menu: DropdownMenu,
+  Item: DropdownItem,
+  Button: DropdownButton
+});
+
 exports.default = _default;

package/lib/DropdownMenu/DropdownButton.d.ts

@@ -0,0 +1,280 @@
+import React from 'react';
+import { ButtonProps } from '../Button/Button';
+export declare type DropdownButtonProps = ButtonProps;
+export declare const DropdownButton: React.ForwardRefExoticComponent<Pick<React.PropsWithChildren<{
+    color?: string | undefined;
+    translate?: "yes" | "no" | undefined;
+    hidden?: boolean | undefined;
+    children?: React.ReactNode;
+    value?: string | number | readonly string[] | undefined;
+    ref?: ((instance: HTMLButtonElement | null) => void) | React.RefObject<HTMLButtonElement> | null | undefined;
+    form?: string | undefined;
+    slot?: string | undefined;
+    style?: React.CSSProperties | undefined;
+    title?: string | undefined;
+    variant?: "small" | "medium" | "large" | undefined;
+    role?: React.AriaRole | undefined;
+    sx?: import("../sx").BetterSystemStyleObject | undefined;
+    type?: "button" | "reset" | "submit" | undefined;
+    name?: string | undefined;
+    key?: React.Key | null | undefined;
+    defaultChecked?: boolean | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined;
+    suppressHydrationWarning?: boolean | undefined;
+    accessKey?: string | undefined;
+    className?: string | undefined;
+    contentEditable?: "inherit" | (boolean | "false" | "true") | undefined;
+    contextMenu?: string | undefined;
+    dir?: string | undefined;
+    draggable?: (boolean | "false" | "true") | undefined;
+    id?: string | undefined;
+    lang?: string | undefined;
+    placeholder?: string | undefined;
+    spellCheck?: (boolean | "false" | "true") | undefined;
+    tabIndex?: number | undefined;
+    radioGroup?: string | undefined;
+    about?: string | undefined;
+    datatype?: string | undefined;
+    inlist?: any;
+    prefix?: string | undefined;
+    property?: string | undefined;
+    resource?: string | undefined;
+    typeof?: string | undefined;
+    vocab?: string | undefined;
+    autoCapitalize?: string | undefined;
+    autoCorrect?: string | undefined;
+    autoSave?: string | undefined;
+    itemProp?: string | undefined;
+    itemScope?: boolean | undefined;
+    itemType?: string | undefined;
+    itemID?: string | undefined;
+    itemRef?: string | undefined;
+    results?: number | undefined;
+    security?: string | undefined;
+    unselectable?: "on" | "off" | undefined;
+    inputMode?: "search" | "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | undefined;
+    is?: string | undefined;
+    'aria-activedescendant'?: string | undefined;
+    'aria-atomic'?: boolean | "false" | "true" | undefined;
+    'aria-autocomplete'?: "none" | "both" | "inline" | "list" | undefined;
+    'aria-busy'?: boolean | "false" | "true" | undefined;
+    'aria-checked'?: boolean | "mixed" | "false" | "true" | undefined;
+    'aria-colcount'?: number | undefined;
+    'aria-colindex'?: number | undefined;
+    'aria-colspan'?: number | undefined;
+    'aria-controls'?: string | undefined;
+    'aria-current'?: boolean | "time" | "page" | "false" | "true" | "step" | "location" | "date" | undefined;
+    'aria-describedby'?: string | undefined;
+    'aria-details'?: string | undefined;
+    'aria-disabled'?: boolean | "false" | "true" | undefined;
+    'aria-dropeffect'?: "link" | "none" | "copy" | "move" | "execute" | "popup" | undefined;
+    'aria-errormessage'?: string | undefined;
+    'aria-expanded'?: boolean | "false" | "true" | undefined;
+    'aria-flowto'?: string | undefined;
+    'aria-grabbed'?: boolean | "false" | "true" | undefined;
+    'aria-haspopup'?: boolean | "grid" | "dialog" | "menu" | "listbox" | "false" | "true" | "tree" | undefined;
+    'aria-hidden'?: boolean | "false" | "true" | undefined;
+    'aria-invalid'?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    'aria-keyshortcuts'?: string | undefined;
+    'aria-label'?: string | undefined;
+    'aria-labelledby'?: string | undefined;
+    'aria-level'?: number | undefined;
+    'aria-live'?: "off" | "assertive" | "polite" | undefined;
+    'aria-modal'?: boolean | "false" | "true" | undefined;
+    'aria-multiline'?: boolean | "false" | "true" | undefined;
+    'aria-multiselectable'?: boolean | "false" | "true" | undefined;
+    'aria-orientation'?: "horizontal" | "vertical" | undefined;
+    'aria-owns'?: string | undefined;
+    'aria-placeholder'?: string | undefined;
+    'aria-posinset'?: number | undefined;
+    'aria-pressed'?: boolean | "mixed" | "false" | "true" | undefined;
+    'aria-readonly'?: boolean | "false" | "true" | undefined;
+    'aria-relevant'?: "all" | "text" | "additions" | "additions removals" | "additions text" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
+    'aria-required'?: boolean | "false" | "true" | undefined;
+    'aria-roledescription'?: string | undefined;
+    'aria-rowcount'?: number | undefined;
+    'aria-rowindex'?: number | undefined;
+    'aria-rowspan'?: number | undefined;
+    'aria-selected'?: boolean | "false" | "true" | undefined;
+    'aria-setsize'?: number | undefined;
+    'aria-sort'?: "none" | "ascending" | "descending" | "other" | undefined;
+    'aria-valuemax'?: number | undefined;
+    'aria-valuemin'?: number | undefined;
+    'aria-valuenow'?: number | undefined;
+    'aria-valuetext'?: string | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string;
+    } | undefined;
+    onCopy?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCopyCapture?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCut?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCutCapture?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onPaste?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onPasteCapture?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCompositionEnd?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionEndCapture?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionStart?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionStartCapture?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionUpdate?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onFocus?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onFocusCapture?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onBlur?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onBlurCapture?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onChange?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onChangeCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onBeforeInput?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onBeforeInputCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInput?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInputCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onReset?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onResetCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onSubmit?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onSubmitCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInvalid?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInvalidCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onLoad?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onError?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onErrorCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onKeyDown?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyPress?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyPressCapture?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyUp?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyUpCapture?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onAbort?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onAbortCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlay?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlayCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlayThrough?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlayThroughCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onDurationChange?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onDurationChangeCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEmptied?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEmptiedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEncrypted?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEncryptedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEnded?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEndedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedData?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedDataCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedMetadata?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedMetadataCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadStart?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadStartCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPause?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPauseCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlay?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlayCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlaying?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlayingCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onProgress?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onProgressCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onRateChange?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onRateChangeCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeeked?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeekedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeeking?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeekingCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onStalled?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onStalledCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSuspend?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSuspendCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onTimeUpdate?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onTimeUpdateCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onVolumeChange?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onVolumeChangeCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onWaiting?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onWaitingCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onAuxClick?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onAuxClickCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onClick?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onClickCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onContextMenu?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onContextMenuCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onDoubleClick?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onDoubleClickCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onDrag?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEnd?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEndCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEnter?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEnterCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragExit?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragExitCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragLeave?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragLeaveCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragOver?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragOverCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragStart?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragStartCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDrop?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDropCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onMouseDown?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseDownCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseEnter?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseLeave?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseMove?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseMoveCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOut?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOutCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOver?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOverCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseUp?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseUpCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onSelect?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSelectCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onTouchCancel?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchCancelCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchEnd?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchEndCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchMove?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchMoveCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchStart?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchStartCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onPointerDown?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerDownCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerMove?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerMoveCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerUp?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerUpCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerCancel?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerCancelCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerEnter?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerEnterCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerLeave?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerLeaveCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOver?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOverCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOut?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOutCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onGotPointerCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onLostPointerCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onScroll?: React.UIEventHandler<HTMLButtonElement> | undefined;
+    onScrollCapture?: React.UIEventHandler<HTMLButtonElement> | undefined;
+    onWheel?: React.WheelEventHandler<HTMLButtonElement> | undefined;
+    onWheelCapture?: React.WheelEventHandler<HTMLButtonElement> | undefined;
+    onAnimationStart?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationStartCapture?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationEnd?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationEndCapture?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationIteration?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationIterationCapture?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onTransitionEnd?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionEndCapture?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    css?: import("@emotion/core").InterpolationWithTheme<any>;
+    as?: string | React.ComponentClass<any, any> | React.FunctionComponent<any> | undefined;
+    disabled?: boolean | undefined;
+    autoFocus?: boolean | undefined;
+    formAction?: string | undefined;
+    formEncType?: string | undefined;
+    formMethod?: string | undefined;
+    formNoValidate?: boolean | undefined;
+    formTarget?: string | undefined;
+} & {
+    theme?: any;
+}>, "color" | "translate" | "hidden" | "children" | "theme" | "value" | "form" | "slot" | "style" | "title" | "variant" | "role" | "sx" | "type" | "name" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "css" | "as" | "disabled" | "autoFocus" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget"> & React.RefAttributes<HTMLElement>>;

package/lib/DropdownMenu/DropdownButton.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DropdownButton = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _octiconsReact = require("@primer/octicons-react");
+
+var _Button = _interopRequireDefault(require("../Button/Button"));
+
+var _StyledOcticon = _interopRequireDefault(require("../StyledOcticon"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+const DropdownButton = /*#__PURE__*/_react.default.forwardRef(({
+  children,
+  ...props
+}, ref) => /*#__PURE__*/_react.default.createElement(_Button.default, _extends({
+  ref: ref,
+  type: "button"
+}, props), children, /*#__PURE__*/_react.default.createElement(_StyledOcticon.default, {
+  icon: _octiconsReact.TriangleDownIcon,
+  sx: {
+    ml: 1
+  }
+})));
+
+exports.DropdownButton = DropdownButton;

package/lib/DropdownMenu/DropdownMenu.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="react" />
+import { GroupedListProps, ListPropsBase, ItemInput } from '../ActionList/List';
+import { OverlayProps } from '../Overlay';
+import { AnchoredOverlayWrapperAnchorProps } from '../AnchoredOverlay/AnchoredOverlay';
+interface DropdownMenuBaseProps extends Partial<Omit<GroupedListProps, keyof ListPropsBase>>, ListPropsBase {
+    /**
+     * A placeholder value to display on the trigger button when no selection has been made.
+     */
+    placeholder?: string;
+    /**
+     * An `ItemProps` item from the list of `items` which is currently selected.  This item will receive a checkmark next to it in the menu.
+     */
+    selectedItem?: ItemInput;
+    /**
+     * A callback which receives the selected item or `undefined` when an item is activated in the menu.  If the activated item is the same as the current
+     * `selectedItem`, `undefined` will be passed.
+     */
+    onChange?: (item?: ItemInput) => unknown;
+    /**
+     * Props to be spread on the internal `Overlay` component.
+     */
+    overlayProps?: Partial<OverlayProps>;
+    /**
+     * If defined, will control the open/closed state of the overlay. If not defined, the overlay will manage its own state (in other words, an
+     * uncontrolled component). Must be used in conjuction with `onOpenChange`.
+     */
+    open?: boolean;
+    /**
+     * If defined, will control the open/closed state of the overlay. Must be used in conjuction with `open`.
+     */
+    onOpenChange?: (open: boolean) => void;
+}
+export declare type DropdownMenuProps = DropdownMenuBaseProps & AnchoredOverlayWrapperAnchorProps;
+/**
+ * A `DropdownMenu` provides an anchor (button by default) that will open a floating menu of selectable items.  The menu can be
+ * opened and navigated using keyboard or mouse.  When an item is selected, the menu will close and the `onChange` callback will be called.
+ * If the default anchor button is used, the anchor contents will be updated with the selection.
+ */
+export declare function DropdownMenu({ renderAnchor, anchorRef: externalAnchorRef, placeholder, selectedItem, onChange, overlayProps, items, open, onOpenChange, ...listProps }: DropdownMenuProps): JSX.Element;
+export declare namespace DropdownMenu {
+    var displayName: string;
+}
+export {};

package/lib/DropdownMenu/DropdownMenu.js

@@ -0,0 +1,94 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DropdownMenu = DropdownMenu;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _List = require("../ActionList/List");
+
+var _DropdownButton = require("./DropdownButton");
+
+var _AnchoredOverlay = require("../AnchoredOverlay");
+
+var _useProvidedRefOrCreate = require("../hooks/useProvidedRefOrCreate");
+
+var _useProvidedStateOrCreate = require("../hooks/useProvidedStateOrCreate");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (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; }
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+/**
+ * A `DropdownMenu` provides an anchor (button by default) that will open a floating menu of selectable items.  The menu can be
+ * opened and navigated using keyboard or mouse.  When an item is selected, the menu will close and the `onChange` callback will be called.
+ * If the default anchor button is used, the anchor contents will be updated with the selection.
+ */
+function DropdownMenu({
+  renderAnchor = props => /*#__PURE__*/_react.default.createElement(_DropdownButton.DropdownButton, props),
+  anchorRef: externalAnchorRef,
+  placeholder,
+  selectedItem,
+  onChange,
+  overlayProps,
+  items,
+  open,
+  onOpenChange,
+  ...listProps
+}) {
+  const [combinedOpenState, setCombinedOpenState] = (0, _useProvidedStateOrCreate.useProvidedStateOrCreate)(open, onOpenChange, false);
+  const onOpen = (0, _react.useCallback)(() => setCombinedOpenState(true), [setCombinedOpenState]);
+  const onClose = (0, _react.useCallback)(() => setCombinedOpenState(false), [setCombinedOpenState]);
+  const anchorRef = (0, _useProvidedRefOrCreate.useProvidedRefOrCreate)(externalAnchorRef);
+  const renderMenuAnchor = (0, _react.useMemo)(() => {
+    if (renderAnchor === null) {
+      return null;
+    }
+
+    return props => {
+      var _selectedItem$text;
+
+      return renderAnchor({ ...props,
+        children: (_selectedItem$text = selectedItem === null || selectedItem === void 0 ? void 0 : selectedItem.text) !== null && _selectedItem$text !== void 0 ? _selectedItem$text : placeholder
+      });
+    };
+  }, [placeholder, renderAnchor, selectedItem === null || selectedItem === void 0 ? void 0 : selectedItem.text]);
+  const itemsToRender = (0, _react.useMemo)(() => {
+    return items.map(item => {
+      return { ...item,
+        role: 'option',
+        selected: item === selectedItem,
+        onAction: (itemFromAction, event) => {
+          var _item$onAction;
+
+          (_item$onAction = item.onAction) === null || _item$onAction === void 0 ? void 0 : _item$onAction.call(item, itemFromAction, event);
+
+          if (event.defaultPrevented) {
+            return;
+          }
+
+          onClose();
+          onChange === null || onChange === void 0 ? void 0 : onChange(item === selectedItem ? undefined : item);
+        }
+      };
+    });
+  }, [items, onChange, onClose, selectedItem]);
+  return /*#__PURE__*/_react.default.createElement(_AnchoredOverlay.AnchoredOverlay, {
+    renderAnchor: renderMenuAnchor,
+    anchorRef: anchorRef,
+    open: combinedOpenState,
+    onOpen: onOpen,
+    onClose: onClose,
+    overlayProps: overlayProps
+  }, /*#__PURE__*/_react.default.createElement(_List.List, _extends({}, listProps, {
+    role: "listbox",
+    items: itemsToRender
+  })));
+}
+
+DropdownMenu.displayName = "DropdownMenu";
+DropdownMenu.displayName = 'DropdownMenu';

package/lib/DropdownMenu/index.d.ts

@@ -0,0 +1,4 @@
+export { DropdownMenu } from './DropdownMenu';
+export type { DropdownMenuProps } from './DropdownMenu';
+export { DropdownButton } from './DropdownButton';
+export type { DropdownButtonProps } from './DropdownButton';

package/lib/DropdownMenu/index.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DropdownMenu", {
+  enumerable: true,
+  get: function () {
+    return _DropdownMenu.DropdownMenu;
+  }
+});
+Object.defineProperty(exports, "DropdownButton", {
+  enumerable: true,
+  get: function () {
+    return _DropdownButton.DropdownButton;
+  }
+});
+
+var _DropdownMenu = require("./DropdownMenu");
+
+var _DropdownButton = require("./DropdownButton");