GrDropdownMenu

const grDropdownMenuConfig: import("@feugene/granum/contract").GranumComponentDescriptor<"GrDropdownMenu">;

const grDropdownMenuSafelist: string[];

interface GrDropdownMenuAction {
    /** Ключ пункта — он же приходит в `select`. */
    key: string;
    label: string;
    icon?: Component;
    shortcut?: string;
    disabled?: boolean;
    variant?: GrDropdownMenuItemVariant;
    role?: GrDropdownMenuItemRole;
    /** Состояние переключателя для `menuitemcheckbox`/`menuitemradio`. */
    checked?: boolean;
    /** Пункт-ссылка: рендерится как `<a>` с этим `href`. */
    href?: string;
    target?: string;
    rel?: string;
    /** Шорткат для `target="_blank"` + `rel="noopener noreferrer"`. */
    external?: boolean;
    /**
     * Чем рендерить пункт: тег или компонент роутера.
     *
     * Без него пункт-ссылка из `items` остаётся обычным `<a>`, то есть в
     * SPA переход идёт перезагрузкой страницы — а обойти это в модели нечем:
     * `itemProps` внутренняя, слота на пункт нет. Проп есть у самого
     * `GrDropdownMenuItem` и у соседей по кольцу (`GrLink`, `GrBreadcrumbs`,
     * `GrSidebarItem`), из этого ряда выпадала только модель меню.
     */
    as?: string | Component;
    /** Выравнивание содержимого пункта. */
    align?: GrDropdownMenuItemAlign;
    /**
     * Пункты второго уровня. Пункт с ними ничего не выполняет — он раскрывает
     * подменю, поэтому `select` по нему не приходит.
     *
     * Тип записи, а не действия: внутри подменю осмысленны и разделители, и
     * заголовки групп, и следующий уровень.
     */
    children?: GrDropdownMenuEntry[];
}

interface GrDropdownMenuSeparator {
    type: 'divider';
    inset?: boolean;
}

interface GrDropdownMenuSection {
    type: 'group';
    title?: string;
    /** Выравнивание заголовка группы. */
    titleAlign?: GrDropdownMenuHeaderAlign;
    /** Разделители между пунктами группы. */
    dividers?: boolean;
    /** Заголовок капсом. */
    uppercase?: boolean;
    items: GrDropdownMenuAction[];
}

type GrDropdownMenuEntry = GrDropdownMenuAction | GrDropdownMenuSeparator | GrDropdownMenuSection;

interface GrDropdownMenuProps {
    /** Размещение панели относительно триггера; переворот при нехватке места остаётся. */
    placement?: UseFloatingPlacement;
    /** Зазор между триггером и панелью, px. */
    offset?: number;
    /** Ширина панели: число — пиксели, строка — CSS-длина, `auto` — по контенту. */
    width?: GrDropdownWidth;
    /** Чем открывается панель. В любом режиме работают клик и клавиатура. */
    trigger?: GrDropdownTrigger;
    /** Задержка открытия по наведению, мс. */
    openDelay?: number;
    /** Задержка закрытия после ухода курсора, мс. */
    closeDelay?: number;
    /** Меню не открывается ничем; триггер остаётся фокусируемым. */
    disabled?: boolean;
    /** Куда телепортировать панель (`body` по умолчанию). */
    /** Точечное переопределение точки монтирования; по умолчанию — общий портал. */
    teleportTo?: string | HTMLElement;
    /** Закрывать по клику внутри content. */
    closeOnContentClick?: boolean;
    /** Дополнительные классы content-контейнера. */
    contentClass?: string;
    /**
     * Декларативное меню: пункты, группы и разделители массивом. Слот по
     * умолчанию сильнее — он для меню, которое из модели не собирается.
     */
    items?: GrDropdownMenuEntry[];
    /** Разделители между пунктами. */
    dividers?: boolean;
    /** Верхний бордер контейнера списка. */
    borderTop?: boolean;
    /** Нижний бордер контейнера списка. */
    borderBottom?: boolean;
    /** Дополнительные классы для wrapper'а списка. */
    listClass?: string;
    /**
     * Контролируемое состояние панели (`v-model:open`) — прокидывается в
     * `GrDropdown`. Без пропа меню ведёт себя само (uncontrolled).
     */
    open?: boolean;
}

interface GrDropdownMenuEmits {
    /** Выбран пункт декларативного меню. */
    (e: 'select', item: GrDropdownMenuAction): void;
    /** Панель открылась/закрылась (`v-model:open`). */
    (e: 'update:open', value: boolean): void;
}

type GrDropdownMenuItemAlign = 'left' | 'center' | 'right';

type GrDropdownMenuItemVariant = 'default' | 'danger';

type GrDropdownMenuHeaderAlign = GrDropdownMenuItemAlign;

type GrDropdownMenuColumnAlign = GrDropdownMenuItemAlign;

interface GrDropdownMenuColumnProps {
    align?: GrDropdownMenuColumnAlign;
}

interface GrDropdownMenuColumnsProps {
    cols?: GrDropdownMenuColumnsCount;
}

interface GrDropdownMenuDividerProps {
    inset?: boolean;
}

interface GrDropdownMenuGroupProps {
    title?: string;
    titleAlign?: GrDropdownMenuHeaderAlign;
    dividers?: boolean;
    uppercase?: boolean;
}

interface GrDropdownMenuHeaderProps {
    title?: string;
    align?: GrDropdownMenuHeaderAlign;
    uppercase?: boolean;
}

type GrDropdownMenuItemRole = 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';

interface GrDropdownMenuItemProps {
    as?: string | Component;
    disabled?: boolean;
    /** Пункт-ссылка. У выключенного пункта не рендерится: ссылка осталась бы рабочей. */
    href?: string;
    target?: string;
    rel?: string;
    /** Шорткат для `target="_blank"` + `rel="noopener noreferrer"`. */
    external?: boolean;
    align?: GrDropdownMenuItemAlign;
    variant?: GrDropdownMenuItemVariant;
    role?: GrDropdownMenuItemRole;
    /** Состояние переключателя. Осмысленно с `role="menuitemcheckbox|radio"`. */
    checked?: boolean;
    /** Иконка слева. Слот `#icon` сильнее. */
    icon?: Component;
    /** Подпись сочетания клавиш справа. Слот `#shortcut` сильнее. */
    shortcut?: string;
    /**
     * Подменю этого пункта раскрыто. Ставит `GrDropdownMenuSub`: подсветка живёт
     * на пункте, а состояние — у подменю.
     */
    expanded?: boolean;
}

interface GrDropdownMenuListProps {
    dividers?: boolean;
    borderTop?: boolean;
    borderBottom?: boolean;
}

interface GrDropdownMenuSubProps {
    /** Подпись пункта. Слот `#label` сильнее. */
    label?: string;
    /** Иконка слева. Слот `#icon` сильнее. */
    icon?: Component;
    /** Пункт не раскрывается ничем; из таб-порядка не выпадает. */
    disabled?: boolean;
    variant?: GrDropdownMenuItemVariant;
    align?: GrDropdownMenuItemAlign;
    /** Размещение панели подменю; переворот при нехватке места остаётся. */
    placement?: UseFloatingPlacement;
    /** Зазор между пунктом и панелью, px. */
    offset?: number;
    /** Меню из коротких слов не должно быть шириной в слово. */
    minWidth?: number | string;
    /** Задержка раскрытия по наведению, мс. */
    openDelay?: number;
    /** Задержка закрытия после ухода курсора, мс. */
    closeDelay?: number;
    /** Разделители между пунктами подменю. */
    dividers?: boolean;
    contentClass?: string;
    listClass?: string;
}

type GrDropdownMenuSubInstance = ComponentExposed<typeof GrDropdownMenuSubComponent>;