GrContextMenu

type GrContextMenuTrigger = 'contextmenu' | 'manual';

type GrContextMenuSource = 'pointer' | 'keyboard' | 'api';

interface GrContextMenuOpenContext {
    source: GrContextMenuSource;
    /** По чему кликнули или что было в фокусе — отсюда потребитель берёт строку. */
    target: HTMLElement | null;
    anchor: GrFloatingAnchorRect;
    event: MouseEvent | KeyboardEvent | null;
}

interface GrContextMenuProps {
    /** Декларативное меню. Слот `#content` сильнее. */
    items?: GrDropdownMenuEntry[];
    /** Открыто ли меню. Без пропа компонент ведёт состояние сам. */
    open?: boolean;
    /**
     * Чем открывается меню: `contextmenu` — правым кликом по области, `manual` — только из кода.
     * `Shift+F10` и клавиша `ContextMenu` работают в обоих режимах. По умолчанию `contextmenu`.
     */
    trigger?: GrContextMenuTrigger;
    /** Меню не открывается ничем — ни мышью, ни клавиатурой, ни из кода. */
    disabled?: boolean;
    /** Сторона раскрытия от точки вызова. По умолчанию `bottom-start` — вниз и вправо от курсора. */
    placement?: UseFloatingPlacement;
    /** Зазор от якоря. Ноль по умолчанию: меню липнет к курсору. */
    offsetPx?: number;
    /** Меню из коротких слов не должно быть шириной в слово. */
    minWidth?: number | string;
    /** Доступное имя панели `role="menu"`. По умолчанию — переведённое «Context menu». */
    ariaLabel?: string;
    /** `id` видимого заголовка, который называет меню, — альтернатива `ariaLabel`. */
    labelledBy?: string;
    /** Точечное переопределение точки монтирования; по умолчанию — общий портал оверлеев. */
    teleportTo?: string | HTMLElement;
    /** Дополнительные классы панели. */
    contentClass?: string;
    /** Дополнительные классы списка пунктов внутри панели. */
    listClass?: string;
    /** Разделители между пунктами. */
    dividers?: boolean;
    /**
     * Закрывать при прокрутке страницы. Якорь — точка вьюпорта, и панель осталась
     * бы висеть на экране, пока контент под ней уезжает. Так же ведут себя
     * нативные меню.
     */
    closeOnScroll?: boolean;
    /** Пропускать `Shift`+правый клик к браузеру. */
    allowNativeMenu?: boolean;
}

interface GrContextMenuEmits {
    /** Меню открылось или закрылось (`v-model:open`). */
    (e: 'update:open', value: boolean): void;
    /**
     * Меню собирается открыться у этой цели. Приходит **до** открытия, чтобы
     * потребитель успел пересобрать `items` под неё: пункты для папки и для файла
     * разные, а узнать цель иначе неоткуда. Пустая модель после этого просто не
     * откроется — отдельный способ отменить открытие не нужен.
     */
    (e: 'beforeOpen', context: GrContextMenuOpenContext): void;
    /** Выбран пункт из `items`; пункт с подменю его не шлёт. После выбора меню закрывается. */
    (e: 'select', item: GrDropdownMenuAction): void;
}

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

type GrContextMenuInstance = ComponentExposed<typeof GrContextMenuComponent>;