GrDialogService

const granularityDialogServicePlugin: {
    install(app: App): void;
}

function teardownDialogService(): void;

function useDialogService(defaults?: DialogServiceDefaults): DialogService;

const dialogService: DialogService;

interface DialogServiceState {
    /** Очередь заявок. Видимую часть выбирает хост, остальные ждут. */
    queue: DialogRequest[];
    mounted: boolean;
    container: HTMLElement | null;
    appContext: AppContext | null;
    lastCapturedContext: CapturedDialogContext | null;
    contextlessWarned: boolean;
    /**
     * Заявки, чей `onConfirm` сейчас в полёте, от внешней к самой глубокой.
     * По ним определяется вложенность нового вызова.
     */
    inFlight: DialogRequest[];
}

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

type DialogCloseAction = 'confirm' | 'cancel' | 'close';

interface DialogErrorOptions {
    /**
     * Цепочка парсеров для классификации сырого ответа.
     * - не задано — `coreResponseErrorParsers`;
     * - массив — полная замена цепочки;
     * - `(presets) => ResponseErrorParser[]` — композиция из пресетов.
     */
    errorParsers?: ResponseErrorParser[] | ((presets: ResponseErrorParserPresets) => ResponseErrorParser[]);
    /** Частичный override текстов-фолбэков баннера ошибок (i18n). */
    errorTexts?: Partial<ResponseErrorTexts>;
    /** Имя поля основного сообщения в теле ответа (для `plainMessageParser`). */
    errorMessageKey?: string;
    /** Человекочитаемые подписи полей для `fieldErrors`. */
    fieldLabels?: Record<string, string>;
}
/**
 * Контекст, передаваемый в колбэк `onConfirm`. Позволяет управлять
 * жизненным циклом диалога во время асинхронной операции: показывать ошибки,
 * управлять лоадером, закрывать диалог.
 */
export interface DialogConfirmContext<V = unknown> {
    /** Введённое значение (для `prompt` — строка;

interface DialogConfirmContext<V = unknown> {
    /** Введённое значение (для `prompt` — строка; для `confirm`/`alert` — `undefined`). */
    readonly value: V;
    /** `AbortSignal`, прерывающийся при закрытии/отмене диалога. */
    readonly signal: AbortSignal;
    /** Показать общую ошибку текстом. `null` — скрыть. */
    setError: (message: string | null) => void;

type DialogOnConfirm<V = unknown> = (ctx: DialogConfirmContext<V>) => void | boolean | Promise<void | boolean>;
/** Базовые опции, проксируемые в `GrDialog`/`GrModal`. */
export interface DialogBaseOptions extends DialogErrorOptions {

interface DialogBaseOptions extends DialogErrorOptions {
    title?: string;
    /** Текст-сообщение в теле диалога. */
    message?: string;
    description?: string;
    size?: GrDialogSize;
    closeOnBackdrop?: boolean;
    closeOnEsc?: boolean;
    showHeader?: boolean;
    showCloseButton?: boolean;
    headerConfig?: GrDialogSectionConfig;
    footerConfig?: GrDialogSectionConfig;
    bodyConfig?: GrDialogSectionConfig;
    closeLabel?: string;
    buttonSize?: GrButtonSize;
    confirmText?: string;
    confirmVariant?: GrButtonVariant;
    confirmTone?: GrButtonTone;
    /** Внешний `AbortSignal`: при abort диалог закрывается с `action: 'close'`. */
    signal?: AbortSignal;
    /**
     * Место в очереди среди **ожидающих**: больше — раньше, по умолчанию `0`, при
     * равенстве порядок FIFO. Уже показанное окно не прерывается — выдёргивать
     * фокус-ловушку из-под пользователя хуже, чем задержка на одно окно.
     */
    priority?: number;
    /** Наследование контекста приложения (i18n / тема / `granular-provider`). */
    appContext?: AppContext | null;
}

interface DialogConfirmOptions extends DialogBaseOptions {
    cancelText?: string;
    onConfirm?: DialogOnConfirm<undefined>;
}

interface DialogAlertOptions extends DialogBaseOptions {
    onConfirm?: DialogOnConfirm<undefined>;
}

interface DialogPromptOptions extends DialogBaseOptions {
    cancelText?: string;
    /** Начальное значение поля ввода. */
    value?: string;
    label?: string;
    placeholder?: string;
    required?: boolean;
    requiredErrorText?: string;
    /** Тип однострочного поля (`email`, `password`, …). */
    inputType?: GrPromptDialogProps['inputType'];
    /** Программная клавиатура на мобильных. */
    inputmode?: InputHTMLAttributes['inputmode'];
    /** Ограничение длины; со `showCount` рисуется счётчик. */
    maxlength?: number;
    showCount?: boolean;
    /**
     * Что у человека спрашивают — для браузера и менеджера паролей. Из
     * `inputType` не выводится: у `password` три разных правильных значения.
     */
    autocomplete?: GrPromptDialogProps['autocomplete'];
    /** Имя поля: часть менеджеров паролей без него не сохраняет значение. */
    name?: GrPromptDialogProps['name'];
    /** Автозаглавная у программной клавиатуры. */
    autocapitalize?: GrPromptDialogProps['autocapitalize'];
    /** Проверка орфографии. */
    spellcheck?: GrPromptDialogProps['spellcheck'];
    /** Многострочный ввод вместо однострочного. */
    multiline?: boolean;
    rows?: number;
    autosize?: boolean;
    /** Правила проверки значения — те же, что у `GrForm`. */
    rules?: GrFormRule | GrFormRule[];
    onConfirm?: DialogOnConfirm<string>;
}

interface DialogResult<V = unknown> {
    action: DialogCloseAction;
    value?: V;
}

type DialogKind = 'confirm' | 'alert' | 'prompt';

type DialogPromise<T> = Promise<T> & {
    /** Закрыть диалог программно (как `action: 'close'`). */
    close: () => void;

interface DialogServiceDefaults extends DialogErrorOptions {
    size?: GrDialogSize;
    confirmText?: string;
    cancelText?: string;
    confirmVariant?: GrButtonVariant;
    confirmTone?: GrButtonTone;
    buttonSize?: GrButtonSize;
    closeOnBackdrop?: boolean;
    closeOnEsc?: boolean;
}

interface DialogService {
    confirm: (message: string, options?: DialogConfirmOptions) => DialogPromise<boolean>;

interface GrDialogServiceHostProps {
    /**
     * Состояние инстанса сервиса. Приходит пропом при программном монтировании:
     * хост живёт вне дерева и своим `inject` до app-scoped состояния не дотянулся
     * бы. `inject` остаётся для случая, когда хост поставили в шаблон руками.
     */
    state?: DialogServiceState | null;
}