import React from 'react';
import { BaseComponentProps } from '../internal/base-component';
import { BaseNavigationDetail, CancelableEventHandler } from '../internal/events';
import { IconProps } from '../icon/interfaces';
import { InternalBaseComponentProps } from '../internal/hooks/use-base-component';
export interface ButtonDropdownProps extends BaseComponentProps {
    /**
     * Array of objects, each having the following properties:
  
     * - `id` (string) - allows to identify the item that the user clicked on. Mandatory for individual items, optional for categories.
  
     * - `text` (string) - description shown in the menu for this item. Mandatory for individual items, optional for categories.
  
     * - `disabled` (boolean) - whether the item is disabled. Disabled items are not clickable, but they can be highlighted with the keyboard to make them accessible.
  
     * - `disabledReason` (string) - (Optional) Displays text near the `text` property when item is disabled. Use to provide additional context.
  
     * - `items` (ReadonlyArray<Item>): an array of item objects. Items will be rendered as nested menu items but only for the first nesting level, multi-nesting is not supported.
     * An item which belongs to nested group has the following properties: `id`, `text`, `disabled` and `description`.
  
     * - `description` (string) - additional data that will be passed to a `data-description` attribute.
  
     * - `href` (string) - (Optional) Defines the target URL of the menu item, turning it into a link.
  
     * - `external` (boolean) - Marks a menu item as external by adding an icon after the menu item text. The link will open in a new tab when clicked. Note that this only works when `href` is also provided.
  
     * - `externalIconAriaLabel` (string) - Adds an `aria-label` to the external icon.
  
     * - `iconName` (string) - (Optional) Specifies the name of the icon, used with the [icon component](/components/icon/).
  
     * - `iconAlt` (string) - (Optional) Specifies alternate text for the icon when using `iconUrl`.
  
     * - `iconUrl` (string) - (Optional) Specifies the URL of a custom icon.
  
     * - `iconSvg` (ReactNode) - (Optional) Custom SVG icon. Equivalent to the `svg` slot of the [icon component](/components/icon/).
  
     */
    items: ReadonlyArray<ButtonDropdownProps.ItemOrGroup>;
    /**
     * Determines whether the button dropdown is disabled. Users cannot interact with the control if it's disabled.
     */
    disabled?: boolean;
    /**
     * Renders the button as being in a loading state. It takes precedence over the `disabled` if both are set to `true`.
     * It prevents clicks.
     */
    loading?: boolean;
    /** Determines the general styling of the button dropdown.
     * * `primary` for primary buttons
     * * `normal` for secondary buttons
     * * `icon` for icon buttons
     */
    variant?: ButtonDropdownProps.Variant;
    /**
     * Controls expandability of the item groups.
     */
    expandableGroups?: boolean;
    /**
     * By default, the dropdown height is constrained to fit inside the height of its parent element.
     * Enabling this property will allow the dropdown to extend beyond its parent by using fixed positioning and
     * [React Portals](https://reactjs.org/docs/portals.html).
     * If you want the dropdown to ignore the `overflow` CSS property of its parents,
     * such as in a split view layout, enable this property.
     * However, use discretion.
     * If you don't need to, we recommend you don't enable this property because there is a known issue with
     * the '[aria-owns](https://a11ysupport.io/tech/aria/aria-owns_attribute)' attribute in Safari with VoiceOver that
     * prevents VO specific controls (CTRL+OPT+Left/Right) from entering a dropdown on Safari due to its position in the DOM.
     * If you don't need to, we also recommend you don't enable this property because fixed positioning results
     * in a slight, visible lag when scrolling complex pages.
     */
    expandToViewport?: boolean;
    /**
     * Adds `aria-label` to the button dropdown trigger.
     * It should be used in buttons that don't have text in order to make them accessible.
     */
    ariaLabel?: string;
    /**
     * Text displayed in the button dropdown trigger.
     * @displayname text
     */
    children?: React.ReactNode;
    /**
     * Called when the user clicks on an item, and the item is not disabled.  The event detail object contains the id of the clicked item.
     */
    onItemClick?: CancelableEventHandler<ButtonDropdownProps.ItemClickDetails>;
    /**
     * Called when the user clicks on an item with the left mouse button without pressing
     * modifier keys (that is, CTRL, ALT, SHIFT, META), and the item has an `href` set.
     */
    onItemFollow?: CancelableEventHandler<ButtonDropdownProps.ItemClickDetails>;
}
export declare namespace ButtonDropdownProps {
    type Variant = 'normal' | 'primary' | 'icon';
    interface Item {
        id: string;
        text: string;
        disabled?: boolean;
        disabledReason?: string;
        description?: string;
        href?: string;
        external?: boolean;
        externalIconAriaLabel?: string;
        iconAlt?: string;
        iconName?: IconProps.Name;
        iconUrl?: string;
        iconSvg?: React.ReactNode;
    }
    interface ItemGroup extends Omit<Item, 'id' | 'text'> {
        id?: string;
        text?: string;
        items: Items;
    }
    type ItemOrGroup = Item | ItemGroup;
    type Items = ReadonlyArray<ItemOrGroup>;
    interface ItemClickDetails extends BaseNavigationDetail {
        id: string;
    }
    interface Ref {
        /**
         * Focuses the underlying native button.
         */
        focus(): void;
    }
}
export interface ButtonDropdownSettings {
    hasExpandableGroups: boolean;
    isInRestrictedView?: boolean;
}
export interface HighlightProps {
    targetItem: ButtonDropdownProps.ItemOrGroup | null;
    isHighlighted: (item: ButtonDropdownProps.ItemOrGroup) => boolean;
    isExpanded: (group: ButtonDropdownProps.ItemGroup) => boolean;
    highlightItem: (item: ButtonDropdownProps.ItemOrGroup) => void;
}
export declare type GroupToggle = (item: ButtonDropdownProps.ItemGroup, event: React.SyntheticEvent) => void;
export declare type ItemActivate = (item: ButtonDropdownProps.Item, event: React.MouseEvent | React.KeyboardEvent) => void;
export interface CategoryProps extends HighlightProps {
    item: ButtonDropdownProps.ItemGroup;
    onGroupToggle: GroupToggle;
    onItemActivate: ItemActivate;
    disabled: boolean;
    expandToViewport?: boolean;
    variant?: ItemListProps['variant'];
}
export interface ItemListProps extends HighlightProps {
    items: ButtonDropdownProps.Items;
    onGroupToggle: GroupToggle;
    onItemActivate: ItemActivate;
    categoryDisabled?: boolean;
    hasExpandableGroups?: boolean;
    hasCategoryHeader?: boolean;
    expandToViewport?: boolean;
    variant?: InternalButtonDropdownProps['variant'];
}
export interface LinkItem extends ButtonDropdownProps.Item {
    href: string;
}
export interface ItemProps {
    item: ButtonDropdownProps.Item | LinkItem;
    disabled: boolean;
    highlighted: boolean;
    onItemActivate: ItemActivate;
    highlightItem: (item: ButtonDropdownProps.ItemOrGroup) => void;
    first?: boolean;
    last: boolean;
    hasCategoryHeader: boolean;
    variant?: ItemListProps['variant'];
}
export interface InternalButtonDropdownProps extends Omit<ButtonDropdownProps, 'variant'>, InternalBaseComponentProps {
    customTriggerBuilder?: (clickHandler: () => void, ref: React.Ref<any>, isDisabled: boolean, isExpanded: boolean) => React.ReactNode;
    variant?: ButtonDropdownProps['variant'] | 'navigation';
    /**
     * Optional text that is displayed as the title at the top of the dropdown.
     */
    title?: string;
    /**
     * Optional text that is displayed underneath the title at the top of the dropdown.
     */
    description?: string;
    /**
     * Determines that the dropdown should preferably be aligned to the center of the trigger
     * instead of dropping left or right.
     */
    preferCenter?: boolean;
}
//# sourceMappingURL=interfaces.d.ts.map