GrChartRadar

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

interface GrChartRadarConfigurableProps {
    size: GrChartSize;
    height: number;
    axisScale: 'shared' | 'per-axis';
    /** Число колец сетки. У радара это то же, что число делений оси значений. */
    rings: number;
    fill: boolean;
    shape: 'polygon' | 'circle';
    showPoints: 'auto' | 'always' | 'never';
    showLegend: boolean | 'auto';
    legendPosition: 'top' | 'bottom';
    tooltip: boolean;
    dataTable: 'hidden' | 'visible' | 'off';
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * Политика приложения: держать ли весь ряд в дереве доступности, усечь ли его
     * до читаемого или убрать таблицу вовсе — решение уровня продукта, а не
     * отдельного графика.
     */
    dataTableMaxRows: number | 'auto';
}

type GrChartSize = GrComponentSize;

const grChartRadarSafelist: string[];

interface GrChartRadarProps {
    /** Серии по общему набору осей. Ось X всегда категориальная — своего `xScale` у радара нет. */
    series: readonly GrChartSeries[] | readonly (number | null)[];
    /**
     * Как масштабировать спицы.
     *
     * `shared` — одна шкала на все оси: площадь фигуры сравнима, форма честна.
     * `per-axis` — каждая ось нормирована своим максимумом; это единственный
     * способ показать разнородные метрики на одной паутине, но площади при этом
     * сравнивать нельзя.
     */
    axisScale?: 'shared' | 'per-axis';
    /** Верхние границы осей при `per-axis`, ключ — имя оси. Без них максимум берётся из данных. */
    axisMax?: Record<string, number>;
    /**
     * Желаемое число колец сетки — то же, что число делений оси значений.
     *
     * Фактическое следует лестнице «красивых» чисел и может отличаться: кольцо
     * обязано стоять на круглом значении, иначе подпись под ним читается как
     * случайная. При нормировке на ось круглых значений нет, и колец ровно
     * столько, сколько запрошено.
     */
    rings?: number;
    /** Форма колец сетки. */
    shape?: 'polygon' | 'circle';
    /** Угол первой оси в градусах от двенадцати часов, по часовой. */
    startAngle?: number;
    /**
     * Заливать многоугольник серии; по умолчанию `true`. Без заливки остаётся контур — удобнее, когда
     * серий много.
     */
    fill?: boolean;
    /** Маркеры вершин: `auto` (по умолчанию), `always` или `never`. */
    showPoints?: 'auto' | 'always' | 'never';
    /**
     * Высота холста в пикселях; по умолчанию 280. Данные, загрузка и пустое состояние занимают её
     * одинаково.
     */
    height?: number;
    /** Объявленная ширина: от неё идёт первый рендер, дальше ширина замеряется. */
    width?: number;
    /** Границы оси значений при `shared`. Ноль в домене остаётся всегда. */
    yDomain?: readonly [number | null, number | null];
    /**
     * Легенда серий: `auto` (по умолчанию) — когда серий больше одной; `true` и `false` — всегда и
     * никогда.
     */
    showLegend?: boolean | 'auto';
    /** Где стоит легенда: `bottom` (по умолчанию) или `top`. */
    legendPosition?: 'top' | 'bottom';
    /**
     * Панель со значениями под курсором; по умолчанию `true`. `false` прячет только
     * панель: курсор, активные марки, `update:activeIndex` и `pointHover` работают,
     * пока график интерактивен.
     */
    tooltip?: boolean;
    /** Скрытые серии по id — `v-model:hiddenSeries`. Оси при этом не исчезают. */
    hiddenSeries?: readonly string[];
    /** Курсор — `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;
    /**
     * Формат значений в тултипе, скрытой таблице и объявлениях: знаки после запятой и разделители.
     */
    valueFormat?: GrChartNumberFormat;
    /** BCP-47 локаль чисел и дат. Не задана — язык переводов приложения, иначе `en`. */
    locale?: string;
    /**
     * Доступное имя графика. Не задано — сводка, которую собирает компонент: тип графика и объём
     * данных.
     */
    ariaLabel?: string;
    /**
     * Описание для скринридера — вывод, ради которого график показан; дополняет сводку, а не заменяет
     * её.
     */
    ariaDescription?: string;
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * `'auto'` (по умолчанию) — столько строк, сколько можно прочитать; выше
     * потолка таблица идёт равномерной выборкой и говорит об этом пометкой, а
     * поточечная полнота остаётся за клавиатурой. Число задаёт свой потолок,
     * `Infinity` снимает его совсем, `dataTable: 'off'` убирает таблицу целиком —
     * что из этого нужно, решает приложение.
     */
    dataTableMaxRows?: number | 'auto';
}

interface GrChartRadarEmits {
    /**
     * Легенда просит скрыть или показать серию — новый список 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;
}