GrCheckbox

interface GrCheckboxProps {
    /**
     * Остановка `Tab` у самого переключателя.
     *
     * Нужна составным виджетам, которые забирают таб-порядок себе: в сетке
     * `GrDataTable` (`cell-navigation`) `Tab` принадлежит таблице целиком, и
     * чекбокс в ячейке своей остановки держать не должен — до него добираются
     * стрелкой до ячейки и `Enter`. Выключенный переключатель остаётся вне
     * обхода в любом случае.
     */
    tabindex?: number;
    /** Не задан внутри `GrCheckboxGroup` — состояние берётся из группы. */
    modelValue?: boolean;
    /** Недоступен: не переключается и не фокусируется. Складывается по «или» с полем и группой. */
    disabled?: boolean;
    /** Имя скрытого `<input>` в `FormData`. Внутри `GrCheckboxGroup` по умолчанию — имя группы. */
    name?: string;
    /** Значение для формы и ключ в массиве выбранных у `GrCheckboxGroup`. По умолчанию `on`. */
    value?: string;
    /** Обязательное поле: объявляется как `aria-required`, нативной проверки нет. */
    required?: boolean;
    /** Только для чтения: состояние видно, но не переключается. */
    readonly?: boolean;
    /** Визуальное и ARIA-состояние ошибки. */
    invalid?: boolean;
    /** Id формы для скрытого `<input>`, когда чекбокс стоит вне её разметки. */
    form?: string;
    /** Пробрасывается на скрытый нативный `<input>`, чтобы работал `<label for="...">`. */
    id?: string;
    /** Промежуточное («смешанное») состояние: `aria-checked="mixed"`, индикатор — тире. */
    indeterminate?: boolean;
    /** Имя контрола, когда подписи в слоте нет (или она чисто визуальная). */
    ariaLabel?: string;
    /** Сторона подписи относительно контрола. */
    labelPosition?: GrCheckboxLabelPosition;
    /** Размер контрола. Не задан — берётся из группы, затем из `GrConfigProvider`, иначе `md`. */
    size?: GrCheckboxSize;
}

interface GrCheckboxEmits {
    /**
     * Новое состояние для `v-model`. Внутри группы без своего `modelValue` не шлётся —
     * значение уходит в группу.
     */
    (e: 'update:modelValue', value: boolean): void;
    /** Пользователь переключил чекбокс; шлётся и внутри `GrCheckboxGroup`. */
    (e: 'change', value: boolean): void;
    /** Фокус пришёл на контрол — в том числе кликом по внешнему `<label for>`. */
    (e: 'focus', event: FocusEvent): void;
    /** Фокус ушёл с контрола. */
    (e: 'blur', event: FocusEvent): void;
}

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

interface GrCheckboxConfigurableProps {
    size: GrCheckboxSize;
}

type GrCheckboxSize = GrButtonSize;

type GrCheckboxLabelPosition = typeof GR_CHECKBOX_LABEL_POSITIONS[number];

type GrCheckboxGroupContext = {
    /** Выбранные значения группы. Чекбокс сравнивает с ними свой `value`. */
    modelValue: ComputedRef<string[]>;
    name: ComputedRef<string | undefined>;
    disabled: ComputedRef<boolean>;
    readonly: ComputedRef<boolean>;
    invalid: ComputedRef<boolean>;
    /**
     * Обязательность группы объявляют её чекбоксы: `role="group"` не поддерживает
     * `aria-required` (axe: `aria-allowed-attr`), а `role="checkbox"` — да.
     */
    required: ComputedRef<boolean>;
    size: ComputedRef<GrCheckboxSize>;
    /** Добавляет или убирает значение из выбранных. */
    toggle: (value: string, checked: boolean) => void;

const grCheckboxSafelist: string[];

type GrCheckboxInstance = ComponentExposed<typeof GrCheckboxComponent>;