GrCommandPalette

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

type GrCommandItem = {
    id: string;
    label: string;
    /** Пояснение под меткой. */
    description?: string;
    /**
     * Иконка команды: Vue-компонент либо класс иконки (`'i-lucide-file-plus'` —
     * правило для класса заводит приложение: фабрике движка или провайдером,
     * см. `docs/installation.md#иконки`).
     */
    icon?: string | Component;
    /** Подсказка сочетания клавиш — массив клавиш, каждая рисуется отдельным `GrKbd`. */
    shortcut?: string[];
    /** Заголовок группы, под которой команда показывается в списке. */
    group?: string;
    /** Дополнительные слова для поиска (синонимы, транслитерация). */
    keywords?: string[];
    disabled?: boolean;
};

type GrCommandGroup = {
    /** `undefined` — команды без группы (рендерятся без заголовка). */
    name: string | undefined;
    items: GrCommandItem[];
};

type GrCommandFilter = (item: GrCommandItem, query: string) => boolean;
/**
 * Матчер по умолчанию: подстрока (без учёта регистра) в метке, описании,
 * названии группы или ключевых словах.
 *
 * Набор полей у команды шире, чем у опции списка, а сам подстрочный матч — тот
 * же самый на весь пакет (`shared/optionFilter.ts`).
 */
export declare function matchCommandItem(item: GrCommandItem, query: string): boolean;
export declare function filterCommandItems(items: GrCommandItem[], query: string, filter?: GrCommandFilter): GrCommandItem[];
/**
 * Раскладывает плоский список по группам, сохраняя порядок первого появления
 * группы. Команды без `group` собираются в единственную безымянную группу,
 * которая остаётся на своём месте в общем порядке.
 */
export declare function groupCommandItems(items: GrCommandItem[]): GrCommandGroup[];
/** Кусок текста для подсветки: `match` — попал в запрос. */
export type GrCommandMatchSegment = {

interface GrCommandPaletteProps {
    /** Открыта ли палитра. */
    modelValue: boolean;
    /** Плоский список команд; группировка — по полю `group` самой команды. */
    items?: GrCommandItem[];
    /**
     * Недавние команды: пока запрос пуст, они поднимаются отдельной группой
     * наверх в этом порядке и не дублируются ниже.
     */
    recentIds?: string[];
    /** Подсказка в поле поиска. По умолчанию — строка локали. */
    placeholder?: string;
    /** Ширина окна по шкале панелей `GrModal`. По умолчанию `lg`; берётся из `GrConfigProvider`. */
    size?: GrCommandPaletteSize;
    /** Глобальное сочетание открытия. `null` — не вешать слушатель. */
    hotkey?: string | null;
    /**
     * Идентификатор записи в реестре (`granularityHotkeysPlugin`) вместо
     * сочетания строкой: подсказка и привязка берутся из одного источника и не
     * могут разойтись. Сильнее `hotkey`.
     */
    hotkeyId?: string;
    /** Локальная фильтрация по запросу. `false` — фильтрует владелец по событию `search`. */
    filterable?: boolean;
    /** Кастомный матчер локальной фильтрации. */
    filter?: GrCommandFilter;
    /** Внешне управляемое состояние загрузки (для remote-поиска). */
    loading?: boolean;
    /** Закрывать палитру после выбора команды. */
    closeOnSelect?: boolean;
    /** Максимальная высота списка, px. */
    maxHeight?: number;
    /**
     * Виртуализация списка: в DOM живёт только окно вокруг вьюпорта. Высоту окна
     * задаёт `maxHeight`.
     *
     * Включается осознанно: на сотне команд выигрыша нет, а в разметке остаётся
     * только окно — вместе с ним меняется и то, что находит `querySelector`
     * потребителя. Профильный сценарий — палитра приложения на тысячи команд.
     */
    virtual?: boolean;
    /** Показывать подсказку сочетания в поле ввода. */
    showHotkeyHint?: boolean;
    /** Текст пустой выдачи. Слот `#empty` сильнее; по умолчанию — строка локали. */
    emptyText?: string;
    /** Доступное имя палитры и поля поиска. По умолчанию — строка локали. */
    ariaLabel?: string;
}

interface GrCommandPaletteEmits {
    /** Палитра открылась или закрылась (`v-model`): сочетанием, по `Esc` или после выбора команды. */
    (e: 'update:modelValue', value: boolean): void;
    /** Команда выбрана (клик или Enter). */
    (e: 'select', item: GrCommandItem): void;
    /** Поисковый запрос изменился — точка входа для remote-поиска. */
    (e: 'search', query: string): void;
}

type GrCommandPaletteSize = GrOverlaySize;

const grCommandPaletteSafelist: string[];

type GrCommandPaletteInstance = ComponentExposed<typeof GrCommandPaletteComponent>;