GrBreadcrumbs

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

interface GrBreadcrumbsConfigurableProps {
    size: GrBreadcrumbsSize;
    separator: string;
}

type GrBreadcrumbsSize = GrComponentSize;

type GrBreadcrumbItem = {
    label: string;
    href?: string;
    /** Цель роутерной ссылки: уезжает в `GrLink` через `attrs` вместе с `as`. */
    to?: unknown;
    /**
     * Иконка перед подписью — декоративна. Vue-компонент либо класс иконки
     * (`i-lucide-*` — правило для класса заводит приложение: фабрике движка или
     * провайдером, см. `docs/installation.md#иконки`).
     */
    icon?: string | Component;
    /**
     * Показывать только иконку: подпись прячется визуально, но остаётся в
     * разметке и в дереве доступности. Классический «домик» в начале пути.
     *
     * Подпись не выбрасывается и не подменяется на `aria-label` намеренно: путь
     * читают и поиском, и диктором, и пункт без имени для незрячего пустой.
     * Без `icon` поле игнорируется — прятать подпись, ничего не показав взамен,
     * значит стереть пункт.
     */
    iconOnly?: boolean;
    disabled?: boolean;
    /** Доступное имя пункта, когда подписи недостаточно («Настройки» → «Настройки проекта»). */
    ariaLabel?: string;
};

type GrBreadcrumbsLayoutEntry = {
    kind: 'item';
    item: GrBreadcrumbItem;
    index: number;
} | {
    kind: 'ellipsis';
    hiddenCount: number;
};

function resolveBreadcrumbsFit(options: {
    itemWidths: number[];
    separatorWidth: number;
    ellipsisWidth: number;
    available: number;
    itemsBeforeCollapse: number;
    /** Зазор списка (`gap`). Стоит между каждой парой соседей, включая разделители. */
    gapWidth?: number;
}): number;

function resolveBreadcrumbsLayout(options: {
    items: GrBreadcrumbItem[];
    maxItems?: number;
    itemsBeforeCollapse: number;
    itemsAfterCollapse: number;
    expanded: boolean;
}): GrBreadcrumbsLayoutEntry[];

interface GrBreadcrumbsProps {
    /** Путь от корня к текущей странице. Последний пункт — текущая страница. */
    items: GrBreadcrumbItem[];
    /** Компонент ссылки для всех пунктов: `RouterLink`, `NuxtLink`, `Link` Inertia. */
    as?: GrBreadcrumbsLinkComponent;
    /** Разделитель между пунктами. Декоративен: диктору не читается. */
    separator?: string;
    /** Кегль пути и его ссылок — шкала общая с `GrLink`. По умолчанию `md`; берётся из `GrConfigProvider`. */
    size?: GrBreadcrumbsSize;
    /**
     * С какого числа пунктов схлопывать середину в «…». `0`/не задано — показывать
     * путь целиком.
     */
    maxItems?: number;
    /** Сколько пунктов оставить в начале при схлопывании. */
    itemsBeforeCollapse?: number;
    /** Сколько пунктов оставить в конце при схлопывании. */
    itemsAfterCollapse?: number;
    /** Имя лендмарка. Не задано — берётся из локали. */
    ariaLabel?: string;
    /** Последний пункт остаётся ссылкой (текущая страница кликабельна). */
    linkCurrent?: boolean;
    /**
     * Какой пункт — текущая страница. Не задан — последний.
     *
     * `-1` означает, что текущей страницы в пути нет: её имя стоит в `h1`, а
     * путь показывает только родителей. Тогда `aria-current` не получает никто,
     * и последний пункт остаётся обычной ссылкой.
     */
    currentIndex?: number;
    /** i18n-метка кнопки раскрытия схлопнутого пути. */
    expandLabel?: string;
    /**
     * Схлопывать по доступной ширине, а не по числу пунктов. Путь становится
     * однострочным, середина уходит под «…» ровно настолько, насколько не влезает.
     *
     * Без пропа поведение прежнее: список переносится на вторую строку, а порог
     * задаёт `maxItems`. Вместе пропы совместимы — `maxItems` остаётся жёстким
     * потолком, ширина ужимает дальше.
     */
    autoCollapse?: boolean;
}

const grBreadcrumbsSafelist: string[];