GrInput

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

interface GrInputConfigurableProps {
    size: GrComponentSize;
    clearable: boolean;
    /** Форма рамки — см. `components/shared/controlShape.ts`. */
    shape: GrControlShape;
}

interface GrInputProps {
    /**
       * Значение поля. Необязательное: без `v-model` поле рисуется пустым.
       * Дефолт — пустая строка, а не `undefined`: длина значения читается
       * напрямую (`showClear`), и `undefined` уронил бы рендер.
       */
    modelValue?: string;
    /** Нативный `type`: меняет клавиатуру и браузерную проверку формата. По умолчанию `text`. */
    type?: 'text' | 'email' | 'password' | 'number' | 'search' | 'tel' | 'url';
    /** Подсказка в пустом поле. Подпись не заменяет: имя даёт `GrFormField` или `ariaLabel`. */
    placeholder?: string;
    /** Нативный `autocomplete`: чем браузеру заполнять поле — `email`, `one-time-code` и т. п. */
    autocomplete?: string;
    /** Нативный `inputmode`: какую экранную клавиатуру показать, не меняя `type`. */
    inputmode?: InputHTMLAttributes['inputmode'];
    /** Выключить поле: очистка и показ пароля пропадают. Складывается с `GrFormField`. */
    disabled?: boolean;
    /** Только для чтения: значение видно и выделяемо, но не редактируется. */
    readonly?: boolean;
    /** Ошибка валидации: danger-рамка и `aria-invalid`. Складывается с ошибкой `GrFormField`. */
    invalid?: boolean;
    /** Обязательное поле (`aria-required`). Складывается с `required` у `GrFormField`. */
    required?: boolean;
    /** Доступное имя вне `GrFormField`. */
    ariaLabel?: string;
    /**
     * Подсветка рамки по решению разработчика. `success` и `warning` добавляют иконку
     * и скрытую подпись; `invalid` сильнее. По умолчанию `default`.
     */
    state?: 'default' | 'success' | 'warning' | 'danger';
    /** Нативный `name` — имя поля при отправке формы. */
    name?: string;
    /** `id` поля. Не задан — берётся из `GrFormField`, чтобы подпись нашла поле. */
    id?: string;
    /** Высота и кегль по шкале контролов. По умолчанию `md`; берётся из `GrConfigProvider`. */
    size?: GrInputSize;
    /**
     * Форма рамки. `box` — скругление шкалы контролов, как было всегда; `pill` —
     * дорожка-пилюля, как у `GrSegmented`. Форма тянет за собой горизонтальный
     * отступ: в пилюле он не меньше половины высоты, иначе текст заезжает в дугу.
     */
    shape?: GrControlShape;
    /** Показывать кнопку очистки, когда есть значение (и не disabled/readonly). */
    clearable?: boolean;
    /** i18n aria-label кнопки очистки. */
    clearLabel?: string;
    /** Ограничение длины + основа для счётчика символов. */
    maxlength?: number;
    /** Показывать счётчик символов (`len` или `len/maxlength`). */
    showCount?: boolean;
    /**
     * Аддоны `prefix`/`suffix` несут смысл, а не украшают.
     *
     * По умолчанию они скрыты от скринридера: чаще всего там иконка поиска или
     * глиф, повторяющий подпись поля, и второе прочтение мешает. Но `https://`
     * или `₽` бывают единственным местом, где сказано, что вводить, — тогда
     * аддон уезжает в `aria-describedby` поля.
     *
     * Декоративную иконку внутри слота помечайте `aria-hidden` сами: проп снимает
     * скрытие со всей обёртки, а не разбирает её содержимое.
     */
    describeAddons?: boolean;
    /**
       * Фоновая работа по полю (проверка занятости логина, автосохранение):
       * спиннер в trailing-области + `aria-busy`. Ввод не блокируется —
       * для этого есть `disabled`/`readonly`.
       */
    loading?: boolean;
    /** Кнопка показать/скрыть пароль (только при `type="password"`). */
    passwordToggle?: boolean;
    /** i18n aria-label кнопки показать/скрыть пароль. */
    passwordShowLabel?: string;
    /** i18n aria-label кнопки, которая прячет показанный пароль. Не задан — из локали. */
    passwordHideLabel?: string;
    /** Выравнивание текста в поле. По умолчанию `left`. */
    textAlign?: GrInputTextAlign;
    /** Минимальная ширина префикса. По умолчанию — по ступени размера, у `inline`-аддона — `0`. */
    prefixMinWidth?: string;
    /** Максимальная ширина префикса: содержимое шире обрезается. */
    prefixMaxWidth?: string;
    /** Минимальная ширина суффикса. По умолчанию — по ступени размера, у `inline`-аддона — `0`. */
    suffixMinWidth?: string;
    /** Максимальная ширина суффикса: содержимое шире обрезается. */
    suffixMaxWidth?: string;
    /**
       * Фиксированная ширина у prefix/suffix: аддон получает жёсткую ширину
       * (из `*MaxWidth` → `*MinWidth` → дефолт), а контент обрезается по краю
       * (prefix — справа, suffix — слева). По умолчанию аддоны «растягиваются»
       * под контент (в пределах min/max), а излишек клипается оболочкой.
       */
    prefixFixed?: boolean;
    /** Жёсткая ширина суффикса — как у `prefixFixed`, только лишнее обрезается слева. */
    suffixFixed?: boolean;
    /**
       * Как выглядят аддоны `#prefix`/`#suffix`.
       *
       * `segment` (по умолчанию) — отдельный отсек, отрезанный рамкой и выровненный
       * по ступени размера: так поле с «₽» и поле с «USD» стоят в колонку.
       * `inline` — украшение внутри рамки: ни разделителя, ни своей ширины.
       *
       * Разница не косметическая. Поисковая строка с лупой в сегменте читается
       * составным элементом — полем с приклеенной кнопкой, — а не одним полем;
       * именно поэтому иконку внутри рамки нельзя было выразить аддоном, и
       * потребители отказывались от неё вовсе.
       */
    addon?: 'segment' | 'inline';
}

interface GrInputEmits {
    /** Новое значение на каждый ввод (`v-model`). Кнопка очистки шлёт пустую строку. */
    (e: 'update:modelValue', value: string): void;
    /** Значение зафиксировано нативным `change` — по `blur` или `Enter`. */
    (e: 'change', value: string): void;
    /** Поле получило фокус — нативный `focus` с `<input>`. */
    (e: 'focus', event: FocusEvent): void;
    /** Поле потеряло фокус — нативный `blur` с `<input>`. */
    (e: 'blur', event: FocusEvent): void;
    /**
     * Значение стёрто кнопкой очистки. Отдельное событие потому, что по
     * `update:modelValue` программную очистку от ручного стирания не отличить.
     */
    (e: 'clear'): void;
}

type GrInputSize = GrComponentSize;

type GrInputTextAlign = 'left' | 'center' | 'right';

const grInputSafelist: string[];

type GrInputInstance = ComponentExposed<typeof GrInputComponent>;