@feugene/granularity 0.5.1 → 0.7.0

package/dist/types/src/components/GrResponseErrorBanner/GrUploadErrorBanner.vue.d.ts

@@ -0,0 +1,73 @@
+import type { ResponseErrorInfo, ResponseErrorKind, ResponseErrorTexts, ResponseErrorTone } from './responseError.types';
+type __VLS_Props = {
+    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;
+};
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    files: () => never[];
+    texts: () => {};
+    tone: undefined;
+    toneByKind: () => {};
+    canRetry: boolean;
+    canDismiss: boolean;
+    autoHideKinds: () => never[];
+    testIdPrefix: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    retry: (payload: {
+        error: ResponseErrorInfo;
+        files: File[];
+    }) => void;
+    dismiss: () => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    files: () => never[];
+    texts: () => {};
+    tone: undefined;
+    toneByKind: () => {};
+    canRetry: boolean;
+    canDismiss: boolean;
+    autoHideKinds: () => never[];
+    testIdPrefix: string;
+}>>> & Readonly<{
+    onRetry?: ((payload: {
+        error: ResponseErrorInfo;
+        files: File[];
+    }) => any) | undefined;
+    onDismiss?: (() => any) | undefined;
+}>, {
+    tone: ResponseErrorTone;
+    files: File[];
+    texts: Partial<ResponseErrorTexts>;
+    toneByKind: Partial<Record<ResponseErrorKind, ResponseErrorTone>>;
+    canRetry: boolean;
+    canDismiss: boolean;
+    autoHideKinds: ResponseErrorKind[];
+    testIdPrefix: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/src/components/GrResponseErrorBanner/config.d.ts

@@ -0,0 +1 @@
+export declare const grResponseErrorBannerConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrResponseErrorBanner">;

package/dist/types/src/components/GrResponseErrorBanner/index.d.ts

@@ -0,0 +1,10 @@
+export { default } from './GrResponseErrorBanner.vue';
+export { default as GrResponseErrorBanner } from './GrResponseErrorBanner.vue';
+export { default as GrUploadErrorBanner } from './GrUploadErrorBanner.vue';
+export { default as GrFormErrorBanner } from './GrFormErrorBanner.vue';
+export { DEFAULT_RESPONSE_ERROR_TEXTS, useResponseError, } from './useResponseError';
+export type { UseResponseErrorOptions, UseResponseErrorReturn, } from './useResponseError';
+export { DEFAULT_AUTO_HIDE_KINDS, DEFAULT_TONE_BY_KIND, } from './responseError.defaults';
+export { abortErrorParser, createResponseErrorClassifier, defaultResponseErrorParsers, extendDefaultParsers, fileValidationParser, httpStatusParser, jsonApiErrorParser, laravelValidationParser, networkErrorParser, normalizeError, plainMessageParser, problemDetailsParser, resolveResponseErrorTitle, } from './parsers';
+export type { CreateResponseErrorClassifierOptions } from './parsers';
+export type { NormalizedRawError, ResponseErrorContext, ResponseErrorFieldError, ResponseErrorInfo, ResponseErrorKind, ResponseErrorParser, ResponseErrorParserResult, ResponseErrorTexts, ResponseErrorTone, } from './responseError.types';

package/dist/types/src/components/GrResponseErrorBanner/parsers/abortErrorParser.d.ts

@@ -0,0 +1,15 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Распознаёт отмену запроса клиентом.
+ *
+ * Триггеры:
+ * - `ctx.isAbort === true` (выставляется `normalizeError` для `AbortError`,
+ *   axios `isCancel`/`ERR_CANCELED`, xhr `status === 0 && readyState === 4`).
+ *
+ * Возвращает `kind: 'aborted'` и `stop: true` — другие парсеры пропускаются,
+ * чтобы случайный `status === 0` не интерпретировался как сетевая ошибка.
+ *
+ * По умолчанию `aborted` показывается info-плашкой; чтобы скрыть совсем —
+ * добавьте `'aborted'` в `autoHideKinds`.
+ */
+export declare const abortErrorParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/createResponseErrorClassifier.d.ts

@@ -0,0 +1,28 @@
+import type { ResponseErrorInfo, ResponseErrorKind, ResponseErrorParser, ResponseErrorTexts } from '../responseError.types';
+/**
+ * Дефолтная цепочка парсеров. Порядок важен:
+ * `abort → network → fileValidation → laravel → problemDetails → jsonApi → httpStatus → plainMessage`.
+ *
+ * - Ранние специализированные парсеры могут поставить `stop` (abort/file).
+ * - HTTP-парсер даёт fallback-kind/message, чтобы остальное могло уточнить.
+ * - `plainMessage` всегда последний — добывает хоть какое-то сообщение.
+ */
+export declare const defaultResponseErrorParsers: ResponseErrorParser[];
+/** Добавляет пользовательские парсеры в начало дефолтной цепочки. */
+export declare function extendDefaultParsers(extra: ResponseErrorParser[]): ResponseErrorParser[];
+export type CreateResponseErrorClassifierOptions = {
+    parsers?: ResponseErrorParser[];
+    texts?: Partial<ResponseErrorTexts>;
+    /** Имя поля основного сообщения в body (для `plainMessageParser`). */
+    messageKey?: string;
+};
+/**
+ * Фабрика классификатора. Возвращает функцию `(raw, meta?) => Promise<ResponseErrorInfo>`,
+ * которая:
+ * 1. нормализует вход через `normalizeError`,
+ * 2. строит `ResponseErrorContext`,
+ * 3. прогоняет цепочку парсеров (с поддержкой `stop`),
+ * 4. собирает финальный `ResponseErrorInfo` с фолбэками из `texts`.
+ */
+export declare function createResponseErrorClassifier(options?: CreateResponseErrorClassifierOptions): (raw: unknown, meta?: Record<string, unknown>) => Promise<ResponseErrorInfo>;
+export declare function resolveResponseErrorTitle(kind: ResponseErrorKind, texts: ResponseErrorTexts): string;

package/dist/types/src/components/GrResponseErrorBanner/parsers/fileValidationParser.d.ts

@@ -0,0 +1,12 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Распознаёт `FileValidationError` от `GrFileUpload` (или совместимый по форме
+ * объект). Не зависит от жёсткого импорта класса — определяет по `name`.
+ *
+ * Активируется, если `ctx.raw.name === 'FileValidationError'` и есть массив
+ * `issues`/`errors` с полями `{ file?, code?, message }`.
+ *
+ * Возвращает `kind: 'validation'` и `stop: true` — это локальная клиентская
+ * валидация, незачем дальше идти по HTTP-парсерам.
+ */
+export declare const fileValidationParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/httpStatusParser.d.ts

@@ -0,0 +1,15 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Базовая классификация по HTTP-статусу.
+ *
+ * Правила:
+ * - `400` / `422` ⇒ `kind: 'validation'`,
+ * - остальные `4xx` ⇒ `kind: 'client'`,
+ * - `>= 500` ⇒ `kind: 'server'`.
+ *
+ * Не использует `stop` — даёт более специализированным парсерам
+ * (Laravel/JSON:API/RFC 7807) уточнить сообщение и `fieldErrors`.
+ *
+ * `message` берёт из `ctx.texts` как осмысленный фолбэк.
+ */
+export declare const httpStatusParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/index.d.ts

@@ -0,0 +1,11 @@
+export { abortErrorParser } from './abortErrorParser';
+export { fileValidationParser } from './fileValidationParser';
+export { httpStatusParser } from './httpStatusParser';
+export { jsonApiErrorParser } from './jsonApiErrorParser';
+export { laravelValidationParser } from './laravelValidationParser';
+export { networkErrorParser } from './networkErrorParser';
+export { plainMessageParser } from './plainMessageParser';
+export { problemDetailsParser } from './problemDetailsParser';
+export { normalizeError } from './normalizeError';
+export { createResponseErrorClassifier, defaultResponseErrorParsers, extendDefaultParsers, resolveResponseErrorTitle, } from './createResponseErrorClassifier';
+export type { CreateResponseErrorClassifierOptions } from './createResponseErrorClassifier';

package/dist/types/src/components/GrResponseErrorBanner/parsers/jsonApiErrorParser.d.ts

@@ -0,0 +1,17 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Парсер JSON:API-стиля:
+ *
+ * ```json
+ * { "errors": [
+ *     { "status": "422", "title": "Invalid Attribute",
+ *       "detail": "Email is required.",
+ *       "source": { "pointer": "/data/attributes/email" } }
+ *   ] }
+ * ```
+ *
+ * Активируется, когда `ctx.body.errors` — массив объектов с `title`/`detail`.
+ * Поле извлекается из последнего сегмента `source.pointer`. Все `detail`
+ * собираются в `details`, первый `title` — в `message`.
+ */
+export declare const jsonApiErrorParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/laravelValidationParser.d.ts

@@ -0,0 +1,15 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Парсит Laravel-формат ответа об ошибке валидации:
+ *
+ * ```json
+ * { "message": "The given data was invalid.",
+ *   "errors": { "file": ["The file is required."], "amount": ["..."] } }
+ * ```
+ *
+ * Активируется при наличии `ctx.body.errors` как plain-объекта (значения —
+ * массив строк или строка). Если есть `fieldErrors`, повышает `kind` до
+ * `validation` независимо от статуса (полезно, когда сервер прислал 200/4xx
+ * без 422). `message` берётся из `body.message` / `body.error`.
+ */
+export declare const laravelValidationParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/networkErrorParser.d.ts

@@ -0,0 +1,14 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Распознаёт транспортные ошибки **без ответа сервера**: отсутствие интернета,
+ * DNS-фейл, CORS-preflight, fetch `TypeError('Failed to fetch')`,
+ * axios `ERR_NETWORK`/`ECONNABORTED`.
+ *
+ * Триггеры:
+ * - `ctx.isNetwork === true` (выставлено `normalizeError`),
+ * - либо нет ни `status`, ни `body`, ни признака отмены, но есть исходная
+ *   ошибка с `code === 'ERR_NETWORK'` / `message ~ /network|fetch/i/`.
+ *
+ * Возвращает `kind: 'network'` и `stop: true`.
+ */
+export declare const networkErrorParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/normalizeError.d.ts

@@ -0,0 +1,19 @@
+import type { NormalizedRawError } from '../responseError.types';
+/**
+ * Универсально приводит «сырой» вход к {@link NormalizedRawError}.
+ *
+ * Поддерживаемые источники:
+ * - **axios** — `AxiosError` с `response.status`/`response.data`/`response.headers`,
+ *   либо `request` без `response` + `code === 'ERR_NETWORK'`, либо `code === 'ERR_CANCELED'`.
+ * - **fetch `Response`** — объект `Response` с `ok=false`. Тело читается через
+ *   `clone().json()` (с фолбэком на `.text()`); поэтому функция асинхронная.
+ * - **fetch `TypeError`** — `TypeError('Failed to fetch')` ⇒ `isNetwork=true`.
+ * - **`{ response: Response, body: unknown }`** — если потребитель уже прочитал тело сам.
+ * - **`XMLHttpRequest`** / `{ status, responseText, response }` — пара полей.
+ * - **`AbortError` / `DOMException`** ⇒ `isAbort=true`.
+ * - **`Error`/строка/произвольный объект** — кладётся в `body`/`raw` как есть.
+ *
+ * Цель — отделить «откуда пришла ошибка» от «как её классифицировать»: парсеры
+ * работают только с нормализованным `ResponseErrorContext`, не зная о транспорте.
+ */
+export declare function normalizeError(raw: unknown): Promise<NormalizedRawError>;

package/dist/types/src/components/GrResponseErrorBanner/parsers/plainMessageParser.d.ts

@@ -0,0 +1,15 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Финальный фолбэк-парсер. Достаёт хоть какое-нибудь человекочитаемое
+ * сообщение, чтобы баннер не был пустым.
+ *
+ * Источники (по приоритету):
+ * 1. `ctx.body` — если строка ⇒ message,
+ * 2. `ctx.body[messageKey]` (default `'message'`),
+ * 3. `ctx.body.error` (строка),
+ * 4. `ctx.raw.message` (для голых `Error`).
+ *
+ * Не выставляет `kind` — оставляет на усмотрение классификатора.
+ * Использует ключ `messageKey` из `ctx.meta._messageKey`, если задан.
+ */
+export declare const plainMessageParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/parsers/problemDetailsParser.d.ts

@@ -0,0 +1,17 @@
+import type { ResponseErrorParser } from '../responseError.types';
+/**
+ * Парсер RFC 7807 «Problem Details for HTTP APIs»:
+ *
+ * ```json
+ * { "type": "https://example.com/probs/out-of-credit",
+ *   "title": "You do not have enough credit.",
+ *   "status": 403,
+ *   "detail": "Your current balance is 30.",
+ *   "errors": { "balance": ["..."] } }
+ * ```
+ *
+ * Активируется, если есть `body.type` + `body.title`, либо
+ * Content-Type заголовка `application/problem+json`. Берёт `title` как
+ * `message`, `detail` — в `details[0]`, status — в `status`.
+ */
+export declare const problemDetailsParser: ResponseErrorParser;

package/dist/types/src/components/GrResponseErrorBanner/responseError.defaults.d.ts

@@ -0,0 +1,18 @@
+import type { ResponseErrorKind, ResponseErrorTexts, ResponseErrorTone } from './responseError.types';
+/**
+ * Default English texts. Any field can be overridden via the `texts` prop
+ * on `GrResponseErrorBanner` or the `texts` option of `useResponseError`.
+ */
+export declare const DEFAULT_RESPONSE_ERROR_TEXTS: ResponseErrorTexts;
+/**
+ * Маппинг `kind` → `tone` по умолчанию. Применяется внутри баннера, если
+ * пользователь не передал `tone` или `toneByKind`. Цель — визуально отделить
+ * «исправь ввод» (warning) от «упало по сети/серверу» (danger).
+ */
+export declare const DEFAULT_TONE_BY_KIND: Record<ResponseErrorKind, ResponseErrorTone>;
+/**
+ * `kind`'ы, которые по умолчанию не показываются (баннер скрыт).
+ * Семантика: отмена пользователем — не «ошибка», UI обычно тихо проглатывает.
+ * Пользователь может переопределить через `autoHideKinds: []`, чтобы показать info-плашку.
+ */
+export declare const DEFAULT_AUTO_HIDE_KINDS: ResponseErrorKind[];

package/dist/types/src/components/GrResponseErrorBanner/responseError.types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Универсальные типы для отображения ошибок ответа сервера/сети.
+ *
+ * Компонент `GrResponseErrorBanner` не зависит от транспорта (axios/fetch/xhr)
+ * и не делает запросов — он получает уже готовый «сырой» результат и
+ * прогоняет его через цепочку парсеров (`ResponseErrorParser[]`), превращая
+ * в `ResponseErrorInfo`.
+ */
+/**
+ * Категория ошибки. Жёстко разделены по семантике (см. `DEFAULT_TONE_BY_KIND`).
+ *
+ * - `network`     — транспортная проблема: нет интернета, DNS, CORS-preflight,
+ *                   `fetch` `TypeError`, axios `ERR_NETWORK`. **Ответа от сервера нет.**
+ * - `aborted`     — запрос отменён клиентом (`AbortController`, axios `CanceledError`).
+ * - `validation`  — ошибка валидации формы/файлов; есть структурированные поля или
+ *                   статус `400`/`422`. UX: «исправь поле и повтори».
+ * - `client`      — прочие 4xx (auth/forbidden/not-found/conflict/rate-limit) —
+ *                   проблема запроса, retry обычно не помогает.
+ * - `server`      — 5xx, проблема на сервере; retry разумен.
+ * - `unknown`     — ничего не сматчилось, fallback.
+ */
+export type ResponseErrorKind = 'network' | 'aborted' | 'validation' | 'client' | 'server' | 'unknown';
+/** Визуальный тон баннера. Совпадает с `tone` у `GrAlert`. */
+export type ResponseErrorTone = 'info' | 'success' | 'warning' | 'danger' | 'slate' | 'azure' | 'primary' | 'neutral';
+/** Ошибка по конкретному полю (Laravel-style / JSON:API pointer / RFC 7807 errors). */
+export type ResponseErrorFieldError = {
+    /** Имя поля. Для Laravel — ключ из `errors`. Для JSON:API — последний сегмент `source.pointer`. */
+    field: string;
+    /** Сообщения, относящиеся к этому полю. */
+    messages: string[];
+};
+/**
+ * Готовая к показу структура. Это то, что баннер принимает в `error`-проп.
+ */
+export type ResponseErrorInfo = {
+    kind: ResponseErrorKind;
+    /** HTTP-статус, если известен. */
+    status?: number;
+    /** Основной заголовок-сообщение для пользователя. */
+    message: string;
+    /** Плоский список дополнительных сообщений под `message`. */
+    details?: string[];
+    /** Структурированные ошибки по полям (если сервер вернул JSON-объект `errors`). */
+    fieldErrors?: ResponseErrorFieldError[];
+    /** Оригинальный объект ошибки/ответа (для логов/retry). */
+    raw: unknown;
+    /** Произвольный контекст, переданный потребителем (например, `{ files }`). */
+    meta?: Record<string, unknown>;
+};
+/**
+ * Нормализованный «сырой» результат запроса. Заполняется `normalizeError`
+ * единообразно для axios / fetch / xhr / голого Error / строки.
+ */
+export type NormalizedRawError = {
+    /** Оригинал, как пришёл от потребителя. */
+    raw: unknown;
+    /** HTTP-статус (если был ответ). */
+    status?: number;
+    /** Уже распарсенное тело ответа (JSON-объект, строка). */
+    body?: unknown;
+    /** Заголовки ответа (lower-case keys). */
+    headers?: Record<string, string>;
+    /** Признак отмены (`AbortError` / axios `isCancel`). */
+    isAbort?: boolean;
+    /** Признак транспортной ошибки без ответа. */
+    isNetwork?: boolean;
+};
+/**
+ * Контекст, который классификатор передаёт каждому парсеру.
+ *
+ * `raw` — исходный объект (для duck-typing).
+ * `status/body/headers/isAbort/isNetwork` — нормализованные поля.
+ * `meta` — произвольный пользовательский контекст (например, `{ files, formId }`).
+ * `texts` — мёрджнутые тексты, парсер может использовать дефолты как fallback.
+ */
+export type ResponseErrorContext = NormalizedRawError & {
+    meta: Record<string, unknown>;
+    texts: ResponseErrorTexts;
+};
+/**
+ * Результат работы парсера. Любое поле опционально — классификатор сливает
+ * результаты по очереди (последний непустой выигрывает).
+ *
+ * `stop: true` — прервать цепочку, никакие следующие парсеры не вызовутся.
+ */
+export type ResponseErrorParserResult = {
+    kind?: ResponseErrorKind;
+    status?: number;
+    message?: string;
+    details?: string[];
+    fieldErrors?: ResponseErrorFieldError[];
+    stop?: boolean;
+};
+/** Сигнатура парсера. */
+export type ResponseErrorParser = (ctx: ResponseErrorContext) => ResponseErrorParserResult | null | undefined;
+/**
+ * Тексты-фолбэки для каждого `kind` + лейблы кнопок.
+ * Все строки переопределяются через проп `texts` (частичный мердж).
+ */
+export 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;
+    retryLabel: string;
+    dismissLabel: string;
+};

package/dist/types/src/components/GrResponseErrorBanner/useResponseError.d.ts

@@ -0,0 +1,62 @@
+import type { ComputedRef, Ref } from 'vue';
+import { DEFAULT_RESPONSE_ERROR_TEXTS } from './responseError.defaults';
+import type { ResponseErrorInfo, ResponseErrorKind, ResponseErrorParser, ResponseErrorTexts } from './responseError.types';
+/**
+ * Опции для `useResponseError`. Все поля опциональны и поддерживают
+ * **реактивные геттеры** (`() => value`) — чтобы пробрасывать пропсы
+ * родителя без потери реактивности.
+ */
+export type UseResponseErrorOptions = {
+    /** Цепочка парсеров. По умолчанию — `defaultResponseErrorParsers`. */
+    parsers?: () => ResponseErrorParser[] | undefined;
+    /** Частичный override текстов баннера. */
+    texts?: () => Partial<ResponseErrorTexts> | undefined;
+    /**
+     * `kind`'ы, которые **не** выставляются в state (баннер останется скрытым).
+     * По умолчанию пусто — `aborted` показывается info-плашкой. Передайте
+     * `['aborted']`, если хотите тихо проглатывать отмены.
+     */
+    autoHideKinds?: () => ResponseErrorKind[] | undefined;
+    /** Имя поля основного сообщения в body (для `plainMessageParser`). */
+    messageKey?: () => string | undefined;
+    /** Контекст, который попадёт в `ctx.meta` каждого парсера (`{ files, formId, ... }`). */
+    meta?: () => Record<string, unknown> | undefined;
+    /** Побочка после успешной классификации (логирование, sentry). */
+    onClassify?: (info: ResponseErrorInfo) => void;
+};
+/** Публичный возвращаемый API. */
+export 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>;
+    /** Установить готовый info, не пропуская через парсеры. */
+    setError: (info: ResponseErrorInfo) => void;
+    /** Чистая классификация без записи в state — для предпросмотра. */
+    classify: (raw: unknown, meta?: Record<string, unknown>) => Promise<ResponseErrorInfo>;
+    /** Сбросить state (скрыть баннер). */
+    dismiss: () => void;
+    /** Алиас `dismiss`. */
+    reset: () => void;
+    /**
+     * Хелпер: вызывает `handler(currentError)`. Если handler завершился без
+     * исключения — сбрасывает state. Если кинул — оставляет state, поднимает.
+     * Удобно бинать к кнопке «Повторить».
+     */
+    retry: (handler: (info: ResponseErrorInfo) => void | Promise<void>) => Promise<void>;
+};
+/**
+ * Stateful-композабл вокруг `createResponseErrorClassifier`. Хранит
+ * `currentError`, инкапсулирует setRaw/retry/dismiss. Подходит для типичного
+ * сценария «поймал ошибку запроса → показал баннер → ретрай/скрыть».
+ */
+export declare function useResponseError(options?: UseResponseErrorOptions): UseResponseErrorReturn;
+export { DEFAULT_RESPONSE_ERROR_TEXTS };

package/dist/types/src/components/GrTextarea/GrTextarea.vue.d.ts

@@ -55,8 +55,8 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     rows: number;
     invalid: boolean;
     placeholder: string;
-    autocomplete: string;
     state: GrTextareaState;
+    autocomplete: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/components/GrToaster/GrToaster.vue.d.ts

@@ -18,8 +18,8 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     regionLabel: string;
 }>>> & Readonly<{}>, {
     regionLabel: string;
-    placement: GrToasterPlacement;
     dismissLabel: string;
+    placement: GrToasterPlacement;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/granular-provider/shared.d.ts

@@ -59,6 +59,7 @@ export declare const granularityComponentConfigs: {
     GrPromptDialog: GranularComponentDescriptor<"GrPromptDialog">;
     GrRadio: GranularComponentDescriptor<"GrRadio">;
     GrRadioGroup: GranularComponentDescriptor<"GrRadioGroup">;
+    GrResponseErrorBanner: GranularComponentDescriptor<"GrResponseErrorBanner">;
     GrSegmented: GranularComponentDescriptor<"GrSegmented">;
     GrSelect: GranularComponentDescriptor<"GrSelect">;
     GrSidebar: GranularComponentDescriptor<"GrSidebar">;

package/dist/types/src/i18n/messages/en.d.ts

@@ -41,6 +41,22 @@ export declare const en: {
                 navbar: {
                     openMenu: string;
                 };
+                responseError: {
+                    networkTitle: string;
+                    networkMessage: string;
+                    abortedTitle: string;
+                    abortedMessage: string;
+                    validationTitle: string;
+                    validationMessage: string;
+                    clientTitle: string;
+                    clientMessage: string;
+                    serverTitle: string;
+                    serverMessage: string;
+                    unknownTitle: string;
+                    unknownMessage: string;
+                    retryLabel: string;
+                    dismissLabel: string;
+                };
                 colors: {
                     neutral: string;
                     success: string;
@@ -84,6 +100,22 @@ export declare const en: {
             navbar: {
                 openMenu: string;
             };
+            responseError: {
+                networkTitle: string;
+                networkMessage: string;
+                abortedTitle: string;
+                abortedMessage: string;
+                validationTitle: string;
+                validationMessage: string;
+                clientTitle: string;
+                clientMessage: string;
+                serverTitle: string;
+                serverMessage: string;
+                unknownTitle: string;
+                unknownMessage: string;
+                retryLabel: string;
+                dismissLabel: string;
+            };
             colors: {
                 neutral: string;
                 success: string;

package/dist/types/src/i18n/messages/es.d.ts

@@ -34,6 +34,22 @@ export declare const es: {
                 navbar: {
                     openMenu: string;
                 };
+                responseError: {
+                    networkTitle: string;
+                    networkMessage: string;
+                    abortedTitle: string;
+                    abortedMessage: string;
+                    validationTitle: string;
+                    validationMessage: string;
+                    clientTitle: string;
+                    clientMessage: string;
+                    serverTitle: string;
+                    serverMessage: string;
+                    unknownTitle: string;
+                    unknownMessage: string;
+                    retryLabel: string;
+                    dismissLabel: string;
+                };
                 colors: {
                     neutral: string;
                     success: string;
@@ -77,6 +93,22 @@ export declare const es: {
             navbar: {
                 openMenu: string;
             };
+            responseError: {
+                networkTitle: string;
+                networkMessage: string;
+                abortedTitle: string;
+                abortedMessage: string;
+                validationTitle: string;
+                validationMessage: string;
+                clientTitle: string;
+                clientMessage: string;
+                serverTitle: string;
+                serverMessage: string;
+                unknownTitle: string;
+                unknownMessage: string;
+                retryLabel: string;
+                dismissLabel: string;
+            };
             colors: {
                 neutral: string;
                 success: string;