GrFormField

interface GrFormFieldContext {
    /** Сгенерированный (или переданный `forId`) id контрола. */
    id: ComputedRef<string | undefined>;
    /**
     * Id элемента подписи. Нужен контролам, чей виджет — не labelable-элемент
     * (`span[role="checkbox"]`, `div[role="radiogroup"]`): к ним `<label for>`
     * не применяется, и имя приходит через `aria-labelledby`.
     */
    labelId: ComputedRef<string | undefined>;
    /** `aria-describedby`: id подсказки и/или сообщения об ошибке. */
    describedById: ComputedRef<string | undefined>;
    /** Невалидно ли поле (есть `error`). */
    invalid: ComputedRef<boolean>;
    /** Обязательное ли поле. */
    required: ComputedRef<boolean>;
    /**
     * Поле только для чтения. Отличается от `disabled`: значение видно, уходит в
     * форму и доступно скринридеру — просто не редактируется. Ставится на всё
     * поле целиком, чтобы «форма только на чтение» не требовала обходить контролы
     * по одному.
     */
    readonly: ComputedRef<boolean>;
    /**
     * Поле недоступно: не фокусируется и не отправляется. Приходит от самого
     * поля или от формы целиком (`GrForm disabled`) — «выключить форму на время
     * отправки» не должно требовать обхода контролов по одному.
     */
    disabled: ComputedRef<boolean>;
}

function useGrFormFieldContext(): GrFormFieldContext | null;

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

interface GrFormFieldConfigurableProps {
    size: GrFormFieldSize;
    labelPosition: GrFormFieldLabelPosition;
    /** Держать место под строку сообщения — см. проп `reserveMessage`. */
    reserveMessage: boolean;
}

type GrFormFieldSize = GrComponentSize;

type GrFormFieldLabelPosition = typeof GR_FORM_FIELD_LABEL_POSITIONS[number];

const grFormFieldSafelist: string[];

interface GrFormFieldProps {
    /** Подпись поля: `<label for>` контрола и его доступное имя. Слот `#label` сильнее. */
    label?: string;
    /**
     * Имя поля в модели `GrForm` (в т.ч. dot-path `address.city`). Когда поле внутри
     * `GrForm` и задан `name`, ошибка и признак обязательности берутся из формы по
     * этому имени, а потеря фокуса триггерит валидацию поля.
     */
    name?: string;
    /** Явный id контрола. Если не задан — генерируется автоматически. */
    forId?: string;
    /**
     * Явная ошибка (или несколько). Перекрывает ошибку из `GrForm` — ручной
     * режим без формы тоже здесь. Массив нужен там, где источник ошибок один,
     * а претензий несколько: ответ сервера, валидация файла.
     */
    error?: string | string[];
    /** Подсказка под лейблом/над контролом (можно также через слот `#hint`). */
    hint?: string;
    /**
     * Помечает поле обязательным: маркер `*` в подписи и `aria-required` у контрола.
     *
     * Маркер помечен `aria-hidden`, поэтому объявляет обязательность именно
     * контрол — а чем именно, решает его роль. Разбор случая `role="group"`,
     * который `aria-required` не допускает, — на странице компонента.
     */
    required?: boolean;
    /** Всё поле только для чтения: контролы внутри перестают редактироваться. */
    readonly?: boolean;
    /** Поле недоступно. Складывается с `disabled` формы по «или». */
    disabled?: boolean;
    /**
     * Показывать текст ошибки. `false` — поле остаётся невалидным для контрола
     * и AT (`aria-invalid`), но сообщение не занимает места: так делают в
     * плотных таблицах-формах, где ошибка объясняется сводкой сверху.
     */
    showMessage?: boolean;
    /** Размер подписи, подсказки и ошибки. Не задан — из `GrConfigProvider`, иначе `md`. */
    size?: GrFormFieldSize;
    /** Подпись сверху (по умолчанию) или сбоку — для плотных форм. */
    labelPosition?: GrFormFieldLabelPosition;
    /** Ширина колонки подписи при `labelPosition="start"`. Число — пиксели. */
    labelWidth?: string | number;
    /** Классы на `<label>` поверх встроенных — точечная правка подписи без своего слота. */
    labelClass?: LabelClass;
    /**
     * Держать место под строку сообщения, пока ошибки нет: появление текста не
     * сдвигает форму, диалог и панель фиксированной высоты. Не задан — берётся у
     * `GrForm` (`reserveMessage`), затем из `GrConfigProvider`. Несколько ошибок
     * (`error: string[]`) по-прежнему растут ниже одной строки.
     */
    reserveMessage?: boolean;
}