import React from 'react';
import { BorderWidth } from '@instructure/emotion';
import type { Shadow, Stacking, WithStyleProps } from '@instructure/emotion';
import type { PlacementPropValues, PositionConstraint, PositionMountNode, PositionObject } from '@instructure/ui-position';
import type { TextDirectionContextConsumerProps } from '@instructure/ui-i18n';
import type { LiveRegion, UIElement, Renderable, PopoverTheme } from '@instructure/shared-types';
import type { WithDeterministicIdProps } from '@instructure/ui-react-utils';
type PopoverOwnProps = {
    /**
     * Whether or not the `<Popover />` content is shown
     */
    isShowingContent?: boolean;
    /**
     * Whether or not to show the content by default, when uncontrolled
     */
    defaultIsShowingContent?: boolean;
    /**
     * The action that causes the content to display (`click`, `hover`, `focus`)
     */
    on?: ('click' | 'hover' | 'focus') | ('click' | 'hover' | 'focus')[];
    /**
     * Whether or not an arrow pointing to the trigger should be rendered
     */
    withArrow?: boolean;
    /**
     * Color variant of the popover content
     */
    color?: 'primary' | 'primary-inverse';
    /**
     * Controls the shadow depth for the `<Popover />`
     */
    shadow?: Shadow;
    /**
     * Controls the z-index depth for the `<Popover />` content
     */
    stacking?: Stacking;
    /**
     * A function that returns a reference to the content element
     */
    contentRef?: (contentElement: Element | null) => void;
    /**
     * An element or a function returning an element to focus by default
     */
    defaultFocusElement?: UIElement;
    /**
     * An element, function returning an element, or array of elements that will
     * not be hidden from the screen reader when the `<Popover />` is open
     */
    liveRegion?: LiveRegion;
    /**
     * An accessible label for the `<Popover />` content
     */
    screenReaderLabel?: string;
    /**
     * The horizontal offset for the positioned content
     */
    offsetX?: string | number;
    /**
     * The vertical offset for the positioned content
     */
    offsetY?: string | number;
    /**
     * The placement of the content in relation to the trigger
     *
     * One of: 'top', 'bottom', 'start', 'end', 'top start', 'top center',
     * 'top end', 'top stretch', 'bottom start', 'bottom center', 'bottom end',
     * 'bottom stretch', 'start top', 'start center', 'start bottom',
     * 'start stretch', 'end top', 'end center', 'end bottom', 'end stretch',
     * 'center start', 'center end', 'offscreen'
     */
    placement?: PlacementPropValues;
    /**
     * The parent in which to constrain the popover.
     *
     * One of: 'window', 'scroll-parent', 'parent', 'none', an element,
     * or a function returning an element
     */
    constrain?: PositionConstraint;
    /**
     * An element or a function returning an element to use as the mount node
     * for the `<Popover />` (defaults to `document.body`)
     */
    mountNode?: PositionMountNode;
    /**
     * Target element for positioning the Popover (if it differs from the trigger)
     */
    positionTarget?: PositionMountNode;
    /**
     * Set the CSS `display` property on the `<span>` container element of the underlying Position component
     */
    positionContainerDisplay?: 'inline-block' | 'block';
    /**
     * Insert the element at the 'top' of the mountNode or at the 'bottom'
     */
    insertAt?: 'bottom' | 'top';
    /**
     * An id is generated if not supplied.
     */
    id?: string;
    /**
     * Whether or not the content should offset to align by its arrow
     */
    shouldAlignArrow?: boolean;
    /**
     * Whether or not position should be tracked or just set on initial render
     */
    shouldTrackPosition?: boolean;
    /**
     * Should the `<Popover />` render offscreen when visually hidden
     */
    shouldRenderOffscreen?: boolean;
    /**
     * Whether focus should contained within the `<Popover/>` when it is open
     */
    shouldContainFocus?: boolean;
    /**
     * Whether focus should be returned to the trigger when the `<Popover/>` is closed
     */
    shouldReturnFocus?: boolean;
    /**
     * Should the `<Popover />` hide when clicks occur outside the content
     */
    shouldCloseOnDocumentClick?: boolean;
    /**
     * Should the `<Popover />` hide when the escape key is pressed
     */
    shouldCloseOnEscape?: boolean;
    /**
     * Should the content become focused when the trigger is blurred
     */
    shouldFocusContentOnTriggerBlur?: boolean;
    /**
     * Callback fired when content is shown. When controlled, this callback is
     * fired when the Popover expects to be shown
     */
    onShowContent?: (event: React.UIEvent | React.FocusEvent) => void;
    /**
     * Callback fired when content is hidden. When controlled, this callback is
     * fired when the Popover expects to be hidden
     */
    onHideContent?: (event: React.UIEvent | React.FocusEvent, args: {
        documentClick: boolean;
    }) => void;
    /**
     * Callback fired when content has been is initially positioned.
     * If `shouldRenderOffscreen` is true, it will only fire once, the first
     * time the content is shown
     */
    onPositioned?: (position: PositionObject) => void;
    /**
     * Callback fired when the position changes
     */
    onPositionChanged?: (position: PositionObject) => void;
    /**
     * Callback fired when component is clicked
     */
    onClick?: (event: React.MouseEvent) => void;
    /**
     * Callback fired when trigger is focused
     */
    onFocus?: (event: React.FocusEvent) => void;
    /**
     * Callback fired when component is blurred
     */
    onBlur?: (event: React.FocusEvent) => void;
    /**
     * Callback fired on keydown
     */
    onKeyDown?: (event: React.KeyboardEvent) => void;
    /**
     * Callback fired on keyup
     */
    onKeyUp?: (event: React.KeyboardEvent) => void;
    /**
     * Callback fired when mouse is over trigger
     */
    onMouseOver?: (event: React.MouseEvent) => void;
    /**
     * Callback fired when mouse leaves trigger
     */
    onMouseOut?: (event: React.MouseEvent) => void;
    /**
     * The element that triggers the popover
     */
    renderTrigger?: Renderable;
    /**
     * The content to be shown by the popover
     */
    children?: Renderable;
    /**
     * Provides a reference to the underlying HTML root element
     */
    elementRef?: (element: Element | null) => void;
    /**
     * Allowed values: 0, 'none', 'small', 'medium', 'large'.
     *
     * Accepts the familiar CSS shorthand to designate border widths corresponding to edges. (e.g. 'none large none large).
     *
     * Only applies to a Popover without an arrow.
     */
    borderWidth?: BorderWidth;
    /**
     * If true (default), then the aria-expanded prop is added to the trigger.
     * If its supplied via the aria-expanded prop then it takes the given value,
     * otherwise its calculated automatically based on whether the content is shown.
     */
    shouldSetAriaExpanded?: boolean;
};
type PopoverProps = PopoverOwnProps & TextDirectionContextConsumerProps & WithDeterministicIdProps & WithStyleProps<PopoverTheme, PopoverStyle>;
type PopoverState = {
    placement: PopoverOwnProps['placement'];
    offsetX: PopoverOwnProps['offsetX'];
    offsetY: PopoverOwnProps['offsetY'];
    isShowingContent?: boolean;
};
type PropKeys = keyof PopoverOwnProps;
type AllowedPropKeys = Readonly<Array<PropKeys>>;
type PopoverStyle = {
    borderColor: string;
};
declare const allowedProps: AllowedPropKeys;
export type { PopoverOwnProps, PopoverProps, PopoverState, PopoverStyle };
export { allowedProps };
//# sourceMappingURL=props.d.ts.map