GrResponseErrorBanner

type UseResponseErrorOptions = {
    /** Цепочка парсеров. По умолчанию — `defaultResponseErrorParsers`. */
    parsers?: () => ResponseErrorParser[] | undefined;

type UseResponseErrorReturn = {
    /** Текущее состояние ошибки. `null` — баннер скрыт. */
    currentError: Ref<ResponseErrorInfo | null>;
    /** `currentError.value !== null`. */
    isVisible: ComputedRef<boolean>;
    /** Последний «сырой» вход (для retry/логов). */
    lastRaw: Ref<unknown>;
    /**
     * Главное API: классифицирует raw, сохраняет в state, возвращает info
     * (или `null`, если `kind` в `autoHideKinds`). Возвращает Promise,
     * т.к. нормализатор поддерживает `Response.json()` (async).
     */
    setRaw: (raw: unknown, meta?: Record<string, unknown>) => Promise<ResponseErrorInfo | null>;

function useResponseError(options?: UseResponseErrorOptions): UseResponseErrorReturn;

const coreResponseErrorParsers: ResponseErrorParser[];

type ResponseErrorParserPresets = {
    core: ResponseErrorParser[];
    all: ResponseErrorParser[];
    laravel: ResponseErrorParser;
    problemDetails: ResponseErrorParser;
    jsonApi: ResponseErrorParser;
    fileValidation: ResponseErrorParser;
};

function extendDefaultParsers(extra: ResponseErrorParser[]): ResponseErrorParser[];

type CreateResponseErrorClassifierOptions = {
    parsers?: ResponseErrorParser[];
    texts?: Partial<ResponseErrorTexts>;
    /** Имя поля основного сообщения в body (для `plainMessageParser`). */
    messageKey?: string;
};

function createResponseErrorClassifier(options?: CreateResponseErrorClassifierOptions): (raw: unknown, meta?: Record<string, unknown>) => Promise<ResponseErrorInfo>;
export declare function resolveResponseErrorTitle(kind: ResponseErrorKind, texts: ResponseErrorTexts): string;

function normalizeError(raw: unknown): Promise<NormalizedRawError>;

type ResponseErrorKind = 'network' | 'aborted' | 'validation' | 'client' | 'server' | 'unknown';

type ResponseErrorTone = GrTone;

type ResponseErrorFieldError = {
    /** Имя поля. Для Laravel — ключ из `errors`. Для JSON:API — последний сегмент `source.pointer`. */
    field: string;
    /** Сообщения, относящиеся к этому полю. */
    messages: string[];
};

type ResponseErrorInfo = {
    kind: ResponseErrorKind;
    /** HTTP-статус, если известен. */
    status?: number;
    /** Основной заголовок-сообщение для пользователя. */
    message: string;
    /** Плоский список дополнительных сообщений под `message`. */
    details?: string[];
    /** Структурированные ошибки по полям (если сервер вернул JSON-объект `errors`). */
    fieldErrors?: ResponseErrorFieldError[];
    /** Оригинальный объект ошибки/ответа (для логов/retry). */
    raw: unknown;
    /** Произвольный контекст, переданный потребителем (например, `{ files }`). */
    meta?: Record<string, unknown>;
    /**
     * `message` не пришёл ни от одного парсера, и классификатор подставил свой
     * текст по `kind`. Флаг нужен баннеру: только такое сообщение он вправе
     * заменить переводом. Опознание фолбэка сравнением строк давало ложное
     * срабатывание на сервере, вернувшем дословно тот же текст.
     */
    isFallbackMessage?: boolean;
};

type NormalizedRawError = {
    /** Оригинал, как пришёл от потребителя. */
    raw: unknown;
    /** HTTP-статус (если был ответ). */
    status?: number;
    /** Уже распарсенное тело ответа (JSON-объект, строка). */
    body?: unknown;
    /** Заголовки ответа (lower-case keys). */
    headers?: Record<string, string>;
    /** Признак отмены (`AbortError` / axios `isCancel`). */
    isAbort?: boolean;
    /** Признак транспортной ошибки без ответа. */
    isNetwork?: boolean;
};

type ResponseErrorContext = NormalizedRawError & {
    meta: Record<string, unknown>;
    texts: ResponseErrorTexts;
};

type ResponseErrorParserResult = {
    kind?: ResponseErrorKind;
    status?: number;
    message?: string;
    details?: string[];
    fieldErrors?: ResponseErrorFieldError[];
    stop?: boolean;
};

type ResponseErrorParser = (ctx: ResponseErrorContext) => ResponseErrorParserResult | null | undefined;
/**
 * Тексты-фолбэки для каждого `kind` + лейблы кнопок.
 * Все строки переопределяются через проп `texts` (частичный мердж).
 */
export type ResponseErrorTexts = {

type ResponseErrorTexts = {
    networkTitle: string;
    networkMessage: string;
    abortedTitle: string;
    abortedMessage: string;
    validationTitle: string;
    validationMessage: string;
    clientTitle: string;
    clientMessage: string;
    serverTitle: string;
    serverMessage: string;
    unknownTitle: string;
    unknownMessage: string;
    /** Подпись бейджа HTTP-статуса. `{status}` подставляется компонентом. */
    statusLabel: string;
    retryLabel: string;
    dismissLabel: string;
};

interface GrFormErrorBannerProps {
    error: ResponseErrorInfo | null;
    fieldLabels?: Record<string, string>;
    texts?: Partial<ResponseErrorTexts>;
    tone?: ResponseErrorTone;
    toneByKind?: Partial<Record<ResponseErrorKind, ResponseErrorTone>>;
    canRetry?: boolean;
    canDismiss?: boolean;
    autoHideKinds?: ResponseErrorKind[];
    testIdPrefix?: string;
}

interface GrFormErrorBannerEmits {
    (e: 'retry', error: ResponseErrorInfo): void;
    (e: 'dismiss'): void;
}

interface GrResponseErrorBannerProps {
    /** Готовая структура ошибки. Если `null` — баннер не рендерится. */
    error: ResponseErrorInfo | null;
    /** Частичный override текстов. Мерджится с `DEFAULT_RESPONSE_ERROR_TEXTS`. */
    texts?: Partial<ResponseErrorTexts>;
    /** Жёсткий оверрайд тона. Бьёт `toneByKind`. */
    tone?: ResponseErrorTone;
    /** Маппинг `kind` → `tone`. Мерджится с `DEFAULT_TONE_BY_KIND`. */
    toneByKind?: Partial<Record<ResponseErrorKind, ResponseErrorTone>>;
    /** Показывать ли блок `details`/`fieldErrors` под основным сообщением. */
    showDetails?: boolean;
    /** Префиксить ли `field:` перед сообщениями по полям. */
    showFieldLabels?: boolean;
    /** Человекочитаемые подписи полей (`{ file: 'Файл' }`). */
    fieldLabels?: Record<string, string>;
    /** Удалять дубликаты сообщений между `message` и `details`. */
    dedupeDetails?: boolean;
    /** Показывать ли кнопку «Повторить». */
    canRetry?: boolean;
    /** Показывать ли кнопку «Скрыть». */
    canDismiss?: boolean;
    /** Какие `kind` не рендерить вообще (баннер скрывается). */
    autoHideKinds?: ResponseErrorKind[];
    /** Показывать ли HTTP-status бейдж. */
    showStatus?: boolean;
    /** Префикс `data-testid`. */
    testIdPrefix?: string;
}

interface GrResponseErrorBannerEmits {
    /** Нажата «Повторить» (`canRetry`); приходит текущая ошибка — повторить запрос, что её дал. */
    (e: 'retry', error: ResponseErrorInfo): void;
    /** Нажат крестик (`canDismiss`). Сам баннер не прячется: обнулить `error` — забота экрана. */
    (e: 'dismiss'): void;
}

interface GrUploadErrorBannerProps {
    error: ResponseErrorInfo | null;
    /** Файлы, которые пытались загрузить — пробрасываются в `retry` payload. */
    files?: File[];
    texts?: Partial<ResponseErrorTexts>;
    tone?: ResponseErrorTone;
    toneByKind?: Partial<Record<ResponseErrorKind, ResponseErrorTone>>;
    canRetry?: boolean;
    canDismiss?: boolean;
    autoHideKinds?: ResponseErrorKind[];
    testIdPrefix?: string;
}

interface GrUploadErrorBannerEmits {
    (e: 'retry', payload: {
        error: ResponseErrorInfo;
        files: File[];
    }): void;
    (e: 'dismiss'): void;
}