GrNumberInput

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

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

const grNumberInputSafelist: string[];

interface GrNumberInputProps {
    /**
     * Значение поля. `null` — пусто.
     *
     * Незавершённый ввод («-», «1,») числом не является и в модель не попадает:
     * пока он набирается, поле держит его во внутреннем черновике, а модель
     * честно говорит «числа пока нет».
     */
    modelValue: number | null;
    /** Подсказка в пустом поле. Подпись не заменяет: имя даёт `GrFormField` или `ariaLabel`. */
    placeholder?: string;
    /** Нативный `autocomplete`: чем браузеру заполнять поле. */
    autocomplete?: string;
    /** Нативный `inputmode`: какую экранную клавиатуру показать. По умолчанию `decimal`. */
    inputmode?: InputHTMLAttributes['inputmode'];
    /** Выключить поле: ввод, кнопки ± и очистка недоступны. Складывается с `GrFormField`. */
    disabled?: boolean;
    /** Быстрый флаг невалидности; эквивалент `state='danger'` + `aria-invalid`. */
    invalid?: boolean;
    /** Только для чтения: значение видно и уходит в форму, но не редактируется. */
    readonly?: boolean;
    /** Обязательное поле (`aria-required`). Складывается с `required` у `GrFormField`. */
    required?: boolean;
    /** Доступное имя вне `GrFormField`. */
    ariaLabel?: string;
    /**
     * Подсветка рамки по решению разработчика. `success` и `warning` добавляют иконку
     * и скрытую подпись; `invalid` сильнее. По умолчанию `default`.
     */
    state?: GrNumberInputState;
    /** Нативный `name` — имя поля при отправке формы. */
    name?: string;
    /** `id` поля. Не задан — берётся из `GrFormField`, чтобы подпись нашла поле. */
    id?: string;
    /** Высота и кегль по шкале контролов. По умолчанию `md`; берётся из `GrConfigProvider`. */
    size?: GrNumberInputSize;
    /**
     * Форма рамки. `box` — скругление шкалы контролов; `pill` — пилюля.
     * Отступ поля и вылет степперов идут за формой: `overflow-hidden` обрезает их
     * по внешней дуге, но встать вплотную к ней они не должны.
     */
    shape?: GrControlShape;
    /** Выравнивание числа в поле. По умолчанию `left`. */
    textAlign?: GrNumberInputTextAlign;
    /**
     * Знак дробной части на экране. При вводе принимаются и `.`, и `,`, а в модели
     * всегда число. По умолчанию `.`.
     */
    decimalSeparator?: string;
    /** Шаг кнопок ± и стрелок `↑`/`↓`; `PageUp`/`PageDown` шагают крупнее. По умолчанию `1`. */
    step?: number;
    /** Нижняя граница: применяется при коммите ввода, а не на каждом нажатии. `Home` ставит её. */
    min?: number;
    /** Верхняя граница: применяется при коммите ввода, а не на каждом нажатии. `End` ставит её. */
    max?: number;
    /** Сколько знаков после разделителя оставлять при коммите. Не задано — без округления. */
    precision?: number;
    /** Кнопка очистки значения. */
    clearable?: boolean;
    /** A11y-подпись кнопки очистки. */
    clearLabel?: string;
    /**
     * BCP-47 локаль для отображения значения (группировка разрядов и разделители
     * через `Intl.NumberFormat`). Работает вместе с `useGrouping`.
     */
    locale?: string;
    /**
     * Группировать разряды при отображении (когда поле не в фокусе). При фокусе
     * показывается «сырое» значение для редактирования. По умолчанию выключено.
     */
    useGrouping?: boolean;
    /** Показывать кнопки +/-. */
    controls?: boolean;
    /**
     * Раскладка кнопок ±: `vertical` — столбиком справа, `horizontal` — по бокам поля.
     * По умолчанию `vertical`.
     */
    controlsDirection?: GrNumberInputControlsDirection;
    /** Минимальная ширина префикса. По умолчанию — по ступени размера. */
    prefixMinWidth?: string;
    /** Максимальная ширина префикса: содержимое шире обрезается. */
    prefixMaxWidth?: string;
    /** Минимальная ширина суффикса. По умолчанию — по ступени размера. */
    suffixMinWidth?: string;
    /** Максимальная ширина суффикса: содержимое шире обрезается. */
    suffixMaxWidth?: string;
    /**
     * Фиксированная ширина у prefix/suffix: жёсткая ширина (из `*MaxWidth` →
     * `*MinWidth` → дефолт) + обрезка контента по краю (prefix — справа,
     * suffix — слева). По умолчанию аддоны растягиваются под контент.
     */
    prefixFixed?: boolean;
    /** Жёсткая ширина суффикса — как у `prefixFixed`, только лишнее обрезается слева. */
    suffixFixed?: boolean;
    /** i18n-friendly aria-label для кнопки "увеличить". */
    increaseLabel?: string;
    /** i18n-friendly aria-label для кнопки "уменьшить". */
    decreaseLabel?: string;
}

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

type GrNumberInputState = GrControlState;

type GrNumberInputSize = GrComponentSize;

type GrNumberInputControlsDirection = 'vertical' | 'horizontal';

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

type NumberInputSize = GrNumberInputSize;

type NumberInputControlsDirection = GrNumberInputControlsDirection;

type GrNumberInputInstance = ComponentExposed<typeof GrNumberInputComponent>;