GrChartPie

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

interface GrChartPieConfigurableProps {
    size: GrChartSize;
    height: number;
    variant: 'pie' | 'donut';
    donutRatio: number;
    labels: 'none' | 'share' | 'value';
    showLegend: boolean;
    legendPosition: 'top' | 'bottom';
    tooltip: boolean;
    dataTable: 'hidden' | 'visible' | 'off';
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * Политика приложения: держать ли весь ряд в дереве доступности, усечь ли его
     * до читаемого или убрать таблицу вовсе — решение уровня продукта, а не
     * отдельного графика.
     */
    dataTableMaxRows: number | 'auto';
}

type GrChartSize = GrComponentSize;

const GR_CHART_PIE_TEXTURES: readonly ["solid", "hatch", "hatch-reverse", "grid"];

type GrChartPieTexture = typeof GR_CHART_PIE_TEXTURES[number];

function pieTextureFor(index: number): GrChartPieTexture;

function pieTexturePaths(texture: GrChartPieTexture, tile?: number): string[];

const grChartPieSafelist: string[];

interface GrChartPieSlice {
    label: string;
    /** `null`, ноль и отрицательное значение доли не дают: круг рисует только положительное. */
    value: number | null;
    /** Свой цвет вместо палитры. Заданный цвет отменяет текстуру: выбор потребителя сильнее. */
    color?: string;
    meta?: unknown;
}

interface GrChartPieActiveSlice {
    index: number;
    label: string;
    value: number | null;
    /** Доля от суммы, 0…1. `null` — доля не нарисована. */
    share: number | null;
    color: string;
}

interface GrChartPieProps {
    /** Доли либо голый ряд чисел — тогда подписью становится порядковый номер. */
    data: readonly GrChartPieSlice[] | readonly (number | null)[];
    /** Форма: `pie` (по умолчанию) — круг, `donut` — кольцо с итогом в середине (слот `#center`). */
    variant?: 'pie' | 'donut';
    /** Радиус дырки бублика долей внешнего радиуса. */
    donutRatio?: number;
    /**
     * Высота холста в пикселях; по умолчанию 256. Данные, загрузка и пустое состояние занимают её
     * одинаково.
     */
    height?: number;
    /** Объявленная ширина: от неё идёт первый рендер, дальше ширина замеряется. */
    width?: number;
    /** Угол первой доли в градусах от двенадцати часов, по часовой. */
    startAngle?: number;
    /** Подписи снаружи кольца. `share` — проценты, `value` — значения. */
    labels?: 'none' | 'share' | 'value';
    /** Наименьшая доля, которую подписывают: на трёх процентах подпись перекроет соседнюю. */
    labelMinShare?: number;
    /** Легенда долей со значениями и процентами; по умолчанию `true`. */
    showLegend?: boolean;
    /** Где стоит легенда: `bottom` (по умолчанию) или `top`. */
    legendPosition?: 'top' | 'bottom';
    /**
     * Панель со значениями под курсором; по умолчанию `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;
    /**
     * Формат значений в тултипе, скрытой таблице и объявлениях: знаки после запятой и разделители.
     */
    valueFormat?: GrChartNumberFormat;
    /** BCP-47 локаль чисел и дат. Не задана — язык переводов приложения, иначе `en`. */
    locale?: string;
    /** Подпись под итогом в середине бублика. */
    totalLabel?: string;
    /**
     * Доступное имя графика. Не задано — сводка, которую собирает компонент: тип графика и объём
     * данных.
     */
    ariaLabel?: string;
    /**
     * Описание для скринридера — вывод, ради которого график показан; дополняет сводку, а не заменяет
     * её.
     */
    ariaDescription?: string;
    /**
     * Потолок строк скрытой таблицы данных.
     *
     * `'auto'` (по умолчанию) — столько строк, сколько можно прочитать; выше
     * потолка таблица идёт равномерной выборкой и говорит об этом пометкой, а
     * поточечная полнота остаётся за клавиатурой. Число задаёт свой потолок,
     * `Infinity` снимает его совсем, `dataTable: 'off'` убирает таблицу целиком —
     * что из этого нужно, решает приложение.
     */
    dataTableMaxRows?: number | 'auto';
}

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