@primer/components 0.0.0-2021112202242 → 0.0.0-202111221412

package/lib-esm/ActionMenu2.d.ts

@@ -0,0 +1,313 @@
+import { ButtonProps } from './Button';
+import React from 'react';
+import { OverlayProps } from './Overlay';
+import { AnchoredOverlayWrapperAnchorProps } from './AnchoredOverlay/AnchoredOverlay';
+declare type ActionMenuBaseProps = {
+    /**
+     * Recommended: `ActionMenu.Button` or `ActionMenu.Anchor` with ActionList`
+     */
+    children: React.ReactElement[] | React.ReactElement;
+    /**
+     * If defined, will control the open/closed state of the overlay. 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?: (s: boolean) => void;
+    /**
+     * Props to be spread on the internal `Overlay` component.
+     */
+    overlayProps?: Partial<OverlayProps>;
+};
+export declare type ActionMenuProps = ActionMenuBaseProps & AnchoredOverlayWrapperAnchorProps;
+export declare type MenuAnchorProps = {
+    children: React.ReactElement;
+};
+/** this component is syntactical sugar 🍭 */
+export declare type MenuButtonProps = ButtonProps;
+export declare const ActionMenu: React.FC<ActionMenuProps> & {
+    Button: React.ForwardRefExoticComponent<Pick<{
+        color?: string | undefined;
+        property?: 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;
+        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>;
+        disabled?: boolean | undefined;
+        as?: string | React.ComponentClass<any, any> | React.FunctionComponent<any> | undefined;
+        autoFocus?: boolean | undefined;
+        formAction?: string | undefined;
+        formEncType?: string | undefined;
+        formMethod?: string | undefined;
+        formNoValidate?: boolean | undefined;
+        formTarget?: string | undefined;
+    } & {
+        theme?: any;
+    }, "theme" | "sx" | "key" | keyof React.ButtonHTMLAttributes<HTMLButtonElement> | keyof {
+        as?: string | React.ComponentClass<any, any> | React.FunctionComponent<any> | undefined;
+        variant?: "small" | "medium" | "large" | undefined;
+    }> & React.RefAttributes<React.RefObject<HTMLElement> | undefined>>;
+    Anchor: React.ForwardRefExoticComponent<MenuAnchorProps & React.RefAttributes<React.RefObject<HTMLElement> | undefined>>;
+    Divider: React.FC<import("./sx").SxProp>;
+};
+export {};

package/lib-esm/ActionMenu2.js

@@ -0,0 +1,67 @@
+import Button from './Button';
+import React from 'react';
+import { AnchoredOverlay } from './AnchoredOverlay';
+import { useProvidedStateOrCreate } from './hooks/useProvidedStateOrCreate';
+import { useProvidedRefOrCreate } from './hooks';
+import { Divider } from './ActionList2/Divider';
+import { MenuContext as ActionListMenuContext } from './ActionList2/MenuContext';
+
+const ActionMenuBase = ({
+  anchorRef: externalAnchorRef,
+  open,
+  onOpenChange,
+  overlayProps,
+  children
+}) => {
+  const [combinedOpenState, setCombinedOpenState] = useProvidedStateOrCreate(open, onOpenChange, false);
+  const anchorRef = useProvidedRefOrCreate(externalAnchorRef);
+  const onOpen = React.useCallback(() => setCombinedOpenState(true), [setCombinedOpenState]);
+  const onClose = React.useCallback(() => setCombinedOpenState(false), [setCombinedOpenState]);
+  let renderAnchor = null;
+  const contents = [];
+  React.Children.map(children, child => {
+    if (child.type === MenuButton || child.type === Anchor) {
+      renderAnchor = anchorProps => /*#__PURE__*/React.cloneElement(child, anchorProps);
+    } else {
+      contents.push(child);
+    }
+  });
+  return /*#__PURE__*/React.createElement(AnchoredOverlay, {
+    renderAnchor: renderAnchor,
+    anchorRef: anchorRef,
+    open: combinedOpenState,
+    onOpen: onOpen,
+    onClose: onClose,
+    overlayProps: overlayProps
+  }, /*#__PURE__*/React.createElement(ActionListMenuContext.Provider, {
+    value: {
+      parent: 'ActionMenu',
+      listRole: 'menu',
+      itemRole: 'menuitem',
+      afterSelect: onClose
+    }
+  }, contents));
+};
+
+ActionMenuBase.displayName = "ActionMenuBase";
+const Anchor = /*#__PURE__*/React.forwardRef(({
+  children,
+  ...anchorProps
+}, anchorRef) => {
+  return /*#__PURE__*/React.cloneElement(children, { ...anchorProps,
+    ref: anchorRef
+  });
+});
+/** this component is syntactical sugar 🍭 */
+
+const MenuButton = /*#__PURE__*/React.forwardRef((props, anchorRef) => {
+  return /*#__PURE__*/React.createElement(Anchor, {
+    ref: anchorRef
+  }, /*#__PURE__*/React.createElement(Button, props));
+});
+ActionMenuBase.displayName = 'ActionMenu';
+export const ActionMenu = Object.assign(ActionMenuBase, {
+  Button: MenuButton,
+  Anchor,
+  Divider
+});

package/lib-esm/AnchoredOverlay/AnchoredOverlay.d.ts

@@ -0,0 +1,62 @@
+import React from 'react';
+import { OverlayProps } from '../Overlay';
+import { FocusTrapHookSettings } from '../hooks/useFocusTrap';
+import { FocusZoneHookSettings } from '../hooks/useFocusZone';
+import { PositionSettings } from '../behaviors/anchoredPosition';
+interface AnchoredOverlayPropsWithAnchor {
+    /**
+     * A custom function component used to render the anchor element.
+     * Will receive the selected text as `children` prop when an item is activated.
+     */
+    renderAnchor: <T extends React.HTMLAttributes<HTMLElement>>(props: T) => JSX.Element;
+    /**
+     * An override to the internal ref that will be spread on to the renderAnchor
+     */
+    anchorRef?: React.RefObject<HTMLElement>;
+}
+interface AnchoredOverlayPropsWithoutAnchor {
+    /**
+     * A custom function component used to render the anchor element.
+     * When renderAnchor is null, an anchorRef is required.
+     */
+    renderAnchor: null;
+    /**
+     * An override to the internal renderAnchor ref that will be used to position the overlay.
+     * When renderAnchor is null this can be used to make an anchor that is detached from ActionMenu.
+     */
+    anchorRef: React.RefObject<HTMLElement>;
+}
+export declare type AnchoredOverlayWrapperAnchorProps = Partial<AnchoredOverlayPropsWithAnchor> | AnchoredOverlayPropsWithoutAnchor;
+interface AnchoredOverlayBaseProps extends Pick<OverlayProps, 'height' | 'width'> {
+    /**
+     * Determines whether the overlay portion of the component should be shown or not
+     */
+    open: boolean;
+    /**
+     * A callback which is called whenever the overlay is currently closed and an "open gesture" is detected.
+     */
+    onOpen?: (gesture: 'anchor-click' | 'anchor-key-press') => unknown;
+    /**
+     * A callback which is called whenever the overlay is currently open and a "close gesture" is detected.
+     */
+    onClose?: (gesture: 'anchor-click' | 'click-outside' | 'escape') => unknown;
+    /**
+     * Props to be spread on the internal `Overlay` component.
+     */
+    overlayProps?: Partial<OverlayProps>;
+    /**
+     * Settings to apply to the Focus Zone on the internal `Overlay` component.
+     */
+    focusTrapSettings?: Partial<FocusTrapHookSettings>;
+    /**
+     * Settings to apply to the Focus Zone on the internal `Overlay` component.
+     */
+    focusZoneSettings?: Partial<FocusZoneHookSettings>;
+}
+export declare type AnchoredOverlayProps = AnchoredOverlayBaseProps & (AnchoredOverlayPropsWithAnchor | AnchoredOverlayPropsWithoutAnchor) & Partial<Pick<PositionSettings, 'align' | 'side'>>;
+/**
+ * An `AnchoredOverlay` provides an anchor that will open a floating overlay positioned relative to the anchor.
+ * The overlay can be opened and navigated using keyboard or mouse.
+ */
+export declare const AnchoredOverlay: React.FC<AnchoredOverlayProps>;
+export {};

package/lib-esm/AnchoredOverlay/AnchoredOverlay.js

@@ -0,0 +1,104 @@
+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); }
+
+import React, { useCallback, useEffect } from 'react';
+import Overlay from '../Overlay';
+import { useFocusTrap } from '../hooks/useFocusTrap';
+import { useFocusZone } from '../hooks/useFocusZone';
+import { useAnchoredPosition, useProvidedRefOrCreate, useRenderForcingRef } from '../hooks';
+import { useSSRSafeId } from '@react-aria/ssr';
+
+/**
+ * An `AnchoredOverlay` provides an anchor that will open a floating overlay positioned relative to the anchor.
+ * The overlay can be opened and navigated using keyboard or mouse.
+ */
+export const AnchoredOverlay = ({
+  renderAnchor,
+  anchorRef: externalAnchorRef,
+  children,
+  open,
+  onOpen,
+  onClose,
+  height,
+  width,
+  overlayProps,
+  focusTrapSettings,
+  focusZoneSettings,
+  side,
+  align
+}) => {
+  const anchorRef = useProvidedRefOrCreate(externalAnchorRef);
+  const [overlayRef, updateOverlayRef] = useRenderForcingRef();
+  const anchorId = useSSRSafeId();
+  const onClickOutside = useCallback(() => onClose === null || onClose === void 0 ? void 0 : onClose('click-outside'), [onClose]);
+  const onEscape = useCallback(() => onClose === null || onClose === void 0 ? void 0 : onClose('escape'), [onClose]);
+  const onAnchorKeyDown = useCallback(event => {
+    if (!event.defaultPrevented) {
+      if (!open && ['ArrowDown', 'ArrowUp', ' ', 'Enter'].includes(event.key)) {
+        onOpen === null || onOpen === void 0 ? void 0 : onOpen('anchor-key-press');
+        event.preventDefault();
+      }
+    }
+  }, [open, onOpen]);
+  const onAnchorClick = useCallback(event => {
+    if (event.defaultPrevented || event.button !== 0) {
+      return;
+    }
+
+    if (!open) {
+      onOpen === null || onOpen === void 0 ? void 0 : onOpen('anchor-click');
+    } else {
+      onClose === null || onClose === void 0 ? void 0 : onClose('anchor-click');
+    }
+  }, [open, onOpen, onClose]);
+  const {
+    position
+  } = useAnchoredPosition({
+    anchorElementRef: anchorRef,
+    floatingElementRef: overlayRef,
+    side,
+    align
+  }, [overlayRef.current]);
+  useEffect(() => {
+    // ensure overlay ref gets cleared when closed, so position can reset between closing/re-opening
+    if (!open && overlayRef.current) {
+      updateOverlayRef(null);
+    }
+  }, [open, overlayRef, updateOverlayRef]);
+  useFocusZone({
+    containerRef: overlayRef,
+    disabled: !open || !position,
+    ...focusZoneSettings
+  });
+  useFocusTrap({
+    containerRef: overlayRef,
+    disabled: !open || !position,
+    ...focusTrapSettings
+  });
+  return /*#__PURE__*/React.createElement(React.Fragment, null, renderAnchor && renderAnchor({
+    ref: anchorRef,
+    id: anchorId,
+    'aria-labelledby': anchorId,
+    'aria-haspopup': 'true',
+    tabIndex: 0,
+    onClick: onAnchorClick,
+    onKeyDown: onAnchorKeyDown
+  }), open ? /*#__PURE__*/React.createElement(Overlay, _extends({
+    returnFocusRef: anchorRef,
+    onClickOutside: onClickOutside,
+    ignoreClickRefs: [anchorRef],
+    onEscape: onEscape,
+    ref: updateOverlayRef,
+    role: "none",
+    visibility: position ? 'visible' : 'hidden',
+    height: height,
+    width: width,
+    top: (position === null || position === void 0 ? void 0 : position.top) || 0,
+    left: (position === null || position === void 0 ? void 0 : position.left) || 0,
+    anchorSide: position === null || position === void 0 ? void 0 : position.anchorSide
+  }, overlayProps), children) : null);
+};
+AnchoredOverlay.displayName = 'AnchoredOverlay';
+AnchoredOverlay.defaultProps = {
+  side: 'outside-bottom',
+  align: 'start'
+};

package/lib-esm/AnchoredOverlay/index.d.ts

@@ -0,0 +1,2 @@
+export { AnchoredOverlay } from './AnchoredOverlay';
+export type { AnchoredOverlayProps } from './AnchoredOverlay';

package/lib-esm/AnchoredOverlay/index.js

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