GrChartBar

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

interface GrChartBarConfigurableProps {
    size: GrChartSize;
    /**
     * Раскладка столбцов. Настраивается глобально, потому что решение сквозное:
     * приложение с длинными названиями категорий выбирает горизонталь один раз.
     */
    orientation: ChartOrientation;
    height: number;
    /** Скругление дальнего конца полосы в пикселях: радиус идёт в геометрию пути, а не в CSS. */
    barRadius: number;
    groupPadding: number;
    /** Гасить полосы неактивных категорий при наведении. */
    dimInactive: boolean;
    showGrid: 'both' | 'x' | 'y' | 'none';
    showLegend: boolean | 'auto';
    legendPosition: 'top' | 'bottom';
    tooltip: boolean;
    dataTable: 'hidden' | 'visible' | 'off';
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * Политика приложения: держать ли весь ряд в дереве доступности, усечь ли его
     * до читаемого или убрать таблицу вовсе — решение уровня продукта, а не
     * отдельного графика.
     */
    dataTableMaxRows: number | 'auto';
}

type GrChartSize = GrComponentSize;

const grChartBarSafelist: string[];

interface GrChartBarProps {
    /** Серии либо голый ряд чисел — тогда категорией становится порядковый номер. */
    series: readonly GrChartSeries[] | readonly number[];
    /** Тип оси X. Не задан — выводится из данных; для столбцов это обычно категории. */
    xScale?: GrChartScaleKind;
    /**
     * Раскладка столбцов.
     *
     * `'horizontal'` — категории идут сверху вниз, значения вправо. Берут её ради
     * подписей: длинное название категории в вертикальной раскладке либо наезжает
     * на соседнее, либо встаёт наискось.
     *
     * Оси и после поворота называются **по данным**: `yDomain`, `yTickFormat` и
     * `showGrid: 'y'` относятся к оси значений, где бы она ни лежала. Алиасов нет
     * намеренно — два пропа с одним смыслом хуже одного неточного имени.
     */
    orientation?: ChartOrientation;
    /** `true` — стопка, `'100%'` — стопка с нормировкой столбца к единице. */
    stacked?: boolean | '100%';
    /** Доля ширины слота, уходящая в зазор между сериями внутри категории. */
    groupPadding?: number;
    /** Скругление дальнего от базовой линии конца полосы, пиксели. */
    barRadius?: number;
    /**
     * Гасить полосы неактивных категорий при наведении.
     *
     * `false` — активная категория ничем не выделяется, о ней говорит только
     * тултип. Это осмысленно там, где график стоит рядом с легендой или таблицей
     * и лишнее движение цвета мешает читать соседей.
     */
    dimInactive?: boolean;
    /**
     * Высота холста в пикселях; по умолчанию 256. Данные, загрузка и пустое состояние занимают её
     * одинаково.
     */
    height?: number;
    /** Объявленная ширина: от неё идёт первый рендер, дальше ширина замеряется. */
    width?: number;
    /** Границы оси значений `[min, max]`; `null` на месте границы — она берётся по данным. */
    yDomain?: readonly [number | null, number | null];
    /**
     * Опорные линии и полосы: порог, план, коридор допустимого.
     *
     * Не серия и нигде ею не считается: в легенду не попадает, индекс палитры не
     * тратит, в стек не входит и в скрытую таблицу уезжает примечанием, а не
     * строкой данных.
     */
    references?: readonly GrChartReference[];
    /**
     * Включить опоры в домен оси.
     *
     * По умолчанию нет, и это осознанно: порог `1.0` при данных около `0.03`
     * растянул бы ось так, что сами данные схлопнулись бы в линию.
     */
    includeReferencesInDomain?: boolean;
    /**
     * Показывать вторую ось значений справа.
     *
     * Без неё серии с `axis: 'right'` попадают на левую. Включение осознанное:
     * две оси позволяют подогнать любые два ряда под видимую корреляцию, и это
     * должно быть решением автора графика, а не побочным эффектом поля в данных.
     */
    dualAxis?: boolean;
    /**
     * Границы правой оси значений при `dualAxis`; `null` на месте границы — она берётся по данным.
     */
    yDomainRight?: readonly [number | null, number | null];
    /** Подпись деления правой оси. Не задана — число по локали. */
    yTickFormatRight?: (value: number) => string;

interface GrChartBarEmits {
    /**
     * Легенда просит скрыть или показать серию — новый список id; применяет его потребитель
     * (`v-model:hiddenSeries`).
     */
    (e: 'update:hiddenSeries', value: string[]): void;
    /** Курсор сдвинулся: индекс позиции или `null` — для `v-model:activeIndex`. */
    (e: 'update:activeIndex', value: number | null): void;
    /** Щелчок или Enter по активной позиции — со значениями всех видимых серий в ней. */
    (e: 'pointClick', value: GrChartActivePoint): void;
    /** Курсор пришёл на позицию или ушёл с графика (`null`). */
    (e: 'pointHover', value: GrChartActivePoint | null): void;
    /** Нажат пункт легенды: какая серия и в какое состояние просится. */
    (e: 'legendToggle', value: {
        seriesId: string;
        hidden: boolean;
    }): void;
}