GrChartBullet

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

interface GrChartBulletConfigurableProps {
    size: GrChartSize;
    height: number;
    orientation: 'horizontal' | 'vertical';
    tooltip: boolean;
    dataTable: 'hidden' | 'visible' | 'off';
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * Политика приложения: держать ли весь ряд в дереве доступности, усечь ли его
     * до читаемого или убрать таблицу вовсе — решение уровня продукта, а не
     * отдельного графика.
     */
    dataTableMaxRows: number | 'auto';
}

type GrChartSize = GrComponentSize;

const grChartBulletSafelist: string[];

interface GrChartBulletProps {
    /** Измеряемая величина. `null` — величины нет; это не ноль. */
    value: number | null;
    /** Целевое значение — засечка поперёк дорожки. */
    target?: number;
    /**
     * Границы качественных диапазонов: `[0.9, 1.0]` при `max: 1.2` даёт три
     * полосы — до 0.9, 0.9…1.0 и свыше 1.0. Порядок не важен.
     */
    ranges?: readonly number[];
    /** Верх шкалы. Не задан — максимум из величины, цели и границ с запасом. */
    max?: number;
    /** Низ шкалы; по умолчанию 0. Полоса bullet без нуля искажает длину — величину читают по ней. */
    min?: number;
    /** Цвета полос от «хорошо» к «плохо». Длина на единицу больше `ranges`. */
    rangeColors?: readonly string[];
    /** Тон самой полосы значения. */
    color?: string;
    /** Направление дорожки: `horizontal` (по умолчанию) или `vertical`. */
    orientation?: 'horizontal' | 'vertical';
    /** Имя метрики: заголовок строки в таблице и в тултипе. */
    label?: string;
    /**
     * Высота холста в пикселях; по умолчанию 48. Данные, загрузка и пустое состояние занимают её
     * одинаково.
     */
    height?: number;
    /** Объявленная ширина: от неё идёт первый рендер, дальше ширина замеряется. */
    width?: number;
    /**
     * Формат значений в тултипе, скрытой таблице и объявлениях: знаки после запятой и разделители.
     */
    valueFormat?: GrChartNumberFormat;
    /**
     * Панель со значениями под курсором; по умолчанию `true`. `false` прячет только
     * панель: курсор, активные марки, `update:activeIndex` и `pointHover` работают,
     * пока график интерактивен.
     */
    tooltip?: boolean;
    /**
     * Загрузка: на месте области построения — скелет той же высоты, место под оси уже
     * зарезервировано.
     */
    loading?: boolean;
    /** Пустое состояние явно. Не задано — график пуст, когда рисовать нечего. */
    empty?: boolean;
    /** Текст заглушки пустого графика. Не задан — «Нет данных» из переводов пакета. */
    emptyText?: string;
    /**
     * Таблица данных: `hidden` (по умолчанию) — только для скринридера, `visible` — под графиком,
     * `off` — без неё.
     */
    dataTable?: 'hidden' | 'visible' | 'off';
    /** `false` — график становится картинкой: без фокуса, тултипа и клавиатуры. */
    interactive?: boolean;
    /** Кегль подписей по контрольной шкале ядра; по умолчанию — размер из `GrConfigProvider`. */
    size?: GrChartSize;
    /** BCP-47 локаль чисел и дат. Не задана — язык переводов приложения, иначе `en`. */
    locale?: string;
    /** Доступное имя графика. Не задано — сводка из `label`, величины и цели. */
    ariaLabel?: string;
    /**
     * Описание для скринридера — вывод, ради которого график показан; дополняет сводку, а не заменяет
     * её.
     */
    ariaDescription?: string;
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * `'auto'` (по умолчанию) — столько строк, сколько можно прочитать; выше
     * потолка таблица идёт равномерной выборкой и говорит об этом пометкой, а
     * поточечная полнота остаётся за клавиатурой. Число задаёт свой потолок,
     * `Infinity` снимает его совсем, `dataTable: 'off'` убирает таблицу целиком —
     * что из этого нужно, решает приложение.
     */
    dataTableMaxRows?: number | 'auto';
}

interface GrChartBulletEmits {
    /** Щелчок или Enter по графику; в событии — сама величина. */
    (e: 'valueClick', value: number | null): void;
}