GrChartFunnel

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

interface GrChartFunnelConfigurableProps {
    size: GrChartSize;
    height: number;
    orientation: 'vertical' | 'horizontal';
    shape: 'trapezoid' | 'bar';
    /** Что писать у ступени: долю от первой, от предыдущей или абсолют. */
    labels: 'value' | 'share-first' | 'share-prev' | 'none';
    /** Зазор между ступенями в пикселях: он идёт в геометрию, а не в CSS. */
    gap: number;
    tooltip: boolean;
    dataTable: 'hidden' | 'visible' | 'off';
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * Политика приложения: держать ли весь ряд в дереве доступности, усечь ли его
     * до читаемого или убрать таблицу вовсе — решение уровня продукта, а не
     * отдельного графика.
     */
    dataTableMaxRows: number | 'auto';
}

type GrChartSize = GrComponentSize;

const grChartFunnelSafelist: string[];

interface GrChartFunnelActiveStage {
    index: number;
    label: string;
    value: number;
    /** Доля от первой ступени и от предыдущей — разные знаменатели, обе нужны. */
    shareFirst: number | null;
    sharePrev: number | null;
}

interface GrChartFunnelProps {
    /**
     * Ступени по порядку: `{ label, value, color? }`. Ширина ступени пропорциональна значению, а не
     * порядку.
     */
    stages: readonly GrChartFunnelStage[];
    /**
     * Число у ступени: значение (по умолчанию), доля от первой или от предыдущей
     * ступени. Не помещается внутри — стоит рядом. `'none'` убирает числа, имена
     * ступеней остаются.
     */
    labels?: 'value' | 'share-first' | 'share-prev' | 'none';
    /**
     * Направление: `vertical` (по умолчанию) — ступени сверху вниз, имена слева; `horizontal` — слева
     * направо, имена под ступенями.
     */
    orientation?: 'vertical' | 'horizontal';
    /** Сужающаяся лента или прямоугольники одной ширины. */
    shape?: 'trapezoid' | 'bar';
    /** Зазор между ступенями в пикселях. */
    gap?: number;
    /**
     * Высота холста в пикселях; по умолчанию 256. Данные, загрузка и пустое состояние занимают её
     * одинаково.
     */
    height?: number;
    /** Объявленная ширина: от неё идёт первый рендер, дальше ширина замеряется. */
    width?: number;
    /**
     * Формат значений в тултипе, скрытой таблице и объявлениях: знаки после запятой и разделители.
     */
    valueFormat?: GrChartNumberFormat;
    /**
     * Панель со значениями под курсором; по умолчанию `true`. `false` прячет только
     * панель: курсор, активные марки, `update:activeIndex` и `pointHover` работают,
     * пока график интерактивен.
     */
    tooltip?: boolean;
    /** Курсор — `v-model:activeIndex`. */
    activeIndex?: number | null;
    /**
     * Загрузка: на месте области построения — скелет той же высоты, место под оси уже
     * зарезервировано.
     */
    loading?: boolean;
    /** Пустое состояние явно. Не задано — график пуст, когда рисовать нечего. */
    empty?: boolean;
    /** Текст заглушки пустого графика. Не задан — «Нет данных» из переводов пакета. */
    emptyText?: string;
    /**
     * Таблица данных: `hidden` (по умолчанию) — только для скринридера, `visible` — под графиком,
     * `off` — без неё.
     */
    dataTable?: 'hidden' | 'visible' | 'off';
    /** `false` — график становится картинкой: без фокуса, тултипа и клавиатуры. */
    interactive?: boolean;
    /**
     * Кегль имён ступеней и подписей снаружи по контрольной шкале ядра; по умолчанию — размер из
     * `GrConfigProvider`.
     */
    size?: GrChartSize;
    /** BCP-47 локаль чисел и дат. Не задана — язык переводов приложения, иначе `en`. */
    locale?: string;
    /**
     * Доступное имя графика. Не задано — сводка, которую собирает компонент: тип графика и объём
     * данных.
     */
    ariaLabel?: string;
    /**
     * Описание для скринридера — вывод, ради которого график показан; дополняет сводку, а не заменяет
     * её.
     */
    ariaDescription?: string;
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * `'auto'` (по умолчанию) — столько строк, сколько можно прочитать; выше
     * потолка таблица идёт равномерной выборкой и говорит об этом пометкой, а
     * поточечная полнота остаётся за клавиатурой. Число задаёт свой потолок,
     * `Infinity` снимает его совсем, `dataTable: 'off'` убирает таблицу целиком —
     * что из этого нужно, решает приложение.
     */
    dataTableMaxRows?: number | 'auto';
}

interface GrChartFunnelEmits {
    /** Курсор сдвинулся: индекс ступени или `null` — для `v-model:activeIndex`. */
    (e: 'update:activeIndex', value: number | null): void;
    /** Щелчок или Enter по ступени — с её значением и обеими долями. */
    (e: 'stageClick', value: GrChartFunnelActiveStage): void;
    /** Курсор пришёл на ступень или ушёл с графика (`null`). */
    (e: 'stageHover', value: GrChartFunnelActiveStage | null): void;
}