GrRating

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

interface GrRatingConfigurableProps {
    size: GrRatingSize;
}

interface GrRatingProps {
    /** Текущая оценка. Дробная (`3.5`) поддерживается при `allowHalf`. */
    modelValue: number;
    /** Количество символов шкалы. */
    max?: number;
    /** Размер символов и подписи. Не задан — из `GrConfigProvider`, иначе `md`. */
    size?: GrRatingSize;
    /** Тон заливки; точечно перекрывается переменной `--gr-rating-color`. */
    tone?: GrRatingTone;
    /** Половинчатые оценки: клик по левой половине символа даёт `.5`. */
    allowHalf?: boolean;
    /** Только показ: без ввода и фокуса. */
    readonly?: boolean;
    /** Шкала недоступна: остаётся слайдером с `aria-disabled`, но выходит из таб-порядка и не меняется. */
    disabled?: boolean;
    /** Визуальное и ARIA-состояние ошибки. */
    invalid?: boolean;
    /** Обязательное поле (`aria-required`). */
    required?: boolean;
    /** Повторный клик по текущей оценке сбрасывает её в `0`. */
    clearable?: boolean;
    /**
     * Символ вместо встроенной звезды: Vue-компонент либо класс иконки
     * (`'i-lucide-heart'` — правило для класса заводит приложение: фабрике движка
     * или провайдером, см. `docs/installation.md#иконки`).
     */
    icon?: string | Component;
    /** Показывать числовую подпись справа от шкалы. */
    showText?: boolean;
    /** Формат подписи. По умолчанию — само значение. Сильнее `texts`. */
    formatText?: (value: number) => string;

interface GrRatingEmits {
    /** Оценка изменилась (`v-model`); снятая `clearable` оценка приходит как `0`. */
    (e: 'update:modelValue', value: number): void;
    /** Оценка зафиксирована (клик / клавиша). */
    (e: 'change', value: number): void;
    /** Значение под курсором; `null` — курсор ушёл со шкалы. */
    (e: 'hoverChange', value: number | null): void;
    /** Оценка снята повторным кликом; только при `clearable`. */
    (e: 'clear'): void;
    /** Фокус пришёл на шкалу. */
    (e: 'focus', event: FocusEvent): void;
    /** Фокус ушёл со шкалы; предпросмотр под курсором при этом сбрасывается. */
    (e: 'blur', event: FocusEvent): void;
}

type GrRatingSize = GrComponentSize;

type GrRatingTone = GrTone;

const grRatingSafelist: string[];

type GrRatingInstance = ComponentExposed<typeof GrRatingComponent>;