@rt-tools/ui-kit-v2 0.16.0 → 0.18.0

package/types/rt-tools-ui-kit-v2-date-picker.d.ts

@@ -0,0 +1,181 @@
+import { NumberInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, ElementRef, WritableSignal, InputSignal, InputSignalWithTransform } from '@angular/core';
+import { TRtKitLabelMap, IRtIcon, IRtInput } from '@rt-tools/ui-kit-v2/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+import { RtPopoverDirective } from '@rt-tools/ui-kit-v2/popover';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+import { IRtCalendar } from '@rt-tools/ui-kit-v2/calendar';
+
+/** Контракт rt-date-picker. */
+declare namespace IRtDatePicker {
+    /** Тип значения: дата, время или дата со временем. */
+    type Type = 'date' | 'datetime-local' | 'time';
+    /** Часть даты в тексте поля. */
+    type DatePart = 'day' | 'month' | 'year';
+    /** Как дата пишется в тексте поля по локали: порядок частей и знак между ними. */
+    interface TextLayout {
+        order: readonly DatePart[];
+        separator: string;
+    }
+    /** Буквы подсказки формы текста: `дд`, `мм`, `гггг`, `чч`, `мм` под русскими метками. */
+    interface ShapeLetters {
+        day: string;
+        month: string;
+        year: string;
+        hour: string;
+        minute: string;
+    }
+    /** Ячейка колонки часов или минут. */
+    interface TimeCell {
+        value: number;
+        label: string;
+        disabled: boolean;
+    }
+    /** Колонки времени панели. */
+    interface TimeColumns {
+        hours: readonly TimeCell[];
+        minutes: readonly TimeCell[];
+    }
+    /** Ячейка выбора месяца: `key` — `YYYY-MM`. */
+    interface MonthCell {
+        key: string;
+        label: string;
+        disabled: boolean;
+    }
+    /** Момент, разобранный на день `YYYY-MM-DD` и время `HH:mm`. */
+    interface Moment {
+        day: string;
+        time: string;
+    }
+    /** Что месяц панели знает о выборе и границах. */
+    interface MonthContext {
+        locale: string;
+        today: string;
+        chosen: string | null;
+        min: string | null;
+        max: string | null;
+    }
+    /** Что колонки времени знают о выбранном дне и границах. */
+    interface TimeContext {
+        step: number;
+        hour: number | null;
+        day: string | null;
+        min: string | null;
+        max: string | null;
+    }
+}
+
+/**
+ * Поле даты, времени или даты со временем со своей панелью кита, визуально и по токенам
+ * идентичное rt-input (host — box `--rt-input-*`, input — прозрачный `__field`). Кнопка в конце
+ * поля открывает `rt-date-panel`: на широком экране в поповере, на узком — в нижней шторке.
+ * CVA через общий `RtFormControlBase`: clearable, авто-подсветка invalid, read-only
+ * представление (значение форматируется через Intl).
+ *
+ * `value` — строка формы нативного input'а (`YYYY-MM-DD`, `YYYY-MM-DDTHH:mm`, `HH:mm`). Текст в
+ * поле — дата в порядке языка интерфейса (`01.08.2026` под `ru`), время `HH:mm`; набирается так же,
+ * вставленная форма значения тоже читается. Нечитаемый или лежащий за границами текст оставляет
+ * значение прежним и помечает поле ошибкой.
+ */
+declare class RtDatePickerComponent extends RtFormControlBase<string> {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    /** Узкий экран: панель открывается в нижней шторке, а не в поповере. */
+    protected readonly narrow: Signal<boolean>;
+    protected readonly fieldEl: Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly popover: Signal<RtPopoverDirective | undefined>;
+    /** Набранный текст не читается как значение в границах: поле помечено ошибкой. */
+    protected readonly textInvalid: WritableSignal<boolean>;
+    protected readonly sheetOpen: WritableSignal<boolean>;
+    /** Подсказка формы текста буквами кита: `дд.мм.гггг` под русскими метками. */
+    protected readonly shape: Signal<string>;
+    /**
+     * Текст в поле — значение в порядке языка интерфейса. Не строку форма кладёт мимо контракта
+     * (например `Date`), и поле показывает её пустой, как показывало браузерное.
+     */
+    protected readonly text: Signal<string>;
+    protected readonly openIcon: Signal<IRtIcon.Name>;
+    protected readonly hasValue: Signal<boolean>;
+    /**
+     * Ширина поля в знаках — по длине формы значения. Без неё текстовое поле берёт от браузера
+     * двадцать знаков и в строке отборов потребителя занимает место вдвое шире значения.
+     */
+    protected readonly fieldSize: Signal<number>;
+    /** Подсказка обрезается многоточием в узком поле, поэтому шаблон целиком виден при наведении. */
+    protected readonly shapeTitle: Signal<string | null>;
+    /** Вид рамки: `outline` — рамка со всех сторон, `fill` — залитое поле с чертой снизу. */
+    readonly appearance: InputSignal<IRtInput.Appearance>;
+    readonly displayText: Signal<string>;
+    readonly type: InputSignal<IRtDatePicker.Type>;
+    readonly min: InputSignal<string | null>;
+    readonly max: InputSignal<string | null>;
+    /** Шаг колонки минут в панели. */
+    readonly minuteStep: InputSignalWithTransform<number, NumberInput>;
+    /** Значение из формы снимает ошибку набора: в поле теперь стоит оно. */
+    writeValue(value: string | null): void;
+    protected getEmptyValue(): string;
+    protected focusAfterClear(): void;
+    protected clearValue(): void;
+    /** Набор текста: значение меняется, только когда текст читается как значение в границах. */
+    protected onTyped(event: Event): void;
+    /** Кнопка в конце поля: на узком экране открывает шторку, на широком поповер открывает сам. */
+    protected openPanel(): void;
+    protected closePanel(): void;
+    protected onPicked(value: string): void;
+    protected onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDatePickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDatePickerComponent, "rt-date-picker", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+/** Время `HH:mm` из часа и минуты. */
+declare function rtDateTime(hour: number, minute: number): string;
+/** Первый день недели локали: 1 — понедельник … 7 — воскресенье. */
+declare function rtDateFirstDay(locale: string): number;
+/** Читает текст формы значения; `null` — текст не значение этого типа. */
+declare function rtDateRead(text: string, type: IRtDatePicker.Type): string | null;
+/** Собирает значение типа из дня и времени; без нужной части — пустая строка. */
+declare function rtDateWrite(type: IRtDatePicker.Type, day: string | null, time: string | null): string;
+/** Разбирает значение на день и время; недостающая часть — `null`. */
+declare function rtDateSplit(value: string, type: IRtDatePicker.Type): {
+    day: string | null;
+    time: string | null;
+};
+/** Лежит ли значение в границах; граница обрезается до длины значения, `null` — открыта. */
+declare function rtDateInBounds(value: string, min: string | null, max: string | null): boolean;
+/** Текущий момент: день и время, округлённое вниз до шага минут. */
+declare function rtDateNow(now: Date, step: number): IRtDatePicker.Moment;
+/** Сдвигает месяц `YYYY-MM` на `delta` месяцев. */
+declare function rtDateAddMonths(month: string, delta: number): string;
+/** Можно ли листать от месяца на `delta`: соседний месяц не лежит за границей. */
+declare function rtDateCanPage(month: string, delta: number, min: string | null, max: string | null): boolean;
+/** Месяц `YYYY-MM` для календаря: подпись по локали, пустые ячейки до первого дня, дни. */
+declare function rtDateMonth(month: string, ctx: IRtDatePicker.MonthContext): IRtCalendar.Month;
+/** Короткие имена дней недели по локали, начиная с её первого дня. */
+declare function rtDateWeekdays(locale: string): string[];
+/** Двенадцать месяцев года для выбора месяца; месяц за границей выключен. */
+declare function rtDateMonths(year: number, locale: string, min: string | null, max: string | null): IRtDatePicker.MonthCell[];
+/** Колонки часов и минут: минуты идут с шагом, время за границей выключено. */
+declare function rtDateTimeColumns(ctx: IRtDatePicker.TimeContext): IRtDatePicker.TimeColumns;
+/**
+ * Куда клавиша переводит фокус с дня; `null` — клавиша не сеточная. День за границей не
+ * достаётся: фокус встаёт на ближний день в границах.
+ */
+declare function rtDateGridKey(key: string, day: string, firstDay: number, min: string | null, max: string | null): string | null;
+
+/** Порядок дня, месяца и года и знак между ними — по локали. */
+declare function rtDateLayout(locale: string): IRtDatePicker.TextLayout;
+/**
+ * Текст поля для значения ISO; пустое значение — пустой текст. Строка, которая не читается как
+ * значение этого типа, показывается как есть: она пришла из формы мимо поля и не должна пропасть.
+ */
+declare function rtDateText(value: string, type: IRtDatePicker.Type, layout: IRtDatePicker.TextLayout): string;
+/** Подсказка формы текста в буквах кита: `дд.мм.гггг`, `чч:мм`, `дд.мм.гггг чч:мм`. */
+declare function rtDateShape(type: IRtDatePicker.Type, layout: IRtDatePicker.TextLayout, letters: IRtDatePicker.ShapeLetters): string;
+/**
+ * Читает набранный текст в значение ISO; `null` — текст не значение этого типа. Читается и
+ * порядок локали, и сама форма значения: вставленная `2026-08-01` тоже становится значением.
+ */
+declare function rtDateParse(text: string, type: IRtDatePicker.Type, layout: IRtDatePicker.TextLayout): string | null;
+
+export { IRtDatePicker, RtDatePickerComponent, rtDateAddMonths, rtDateCanPage, rtDateFirstDay, rtDateGridKey, rtDateInBounds, rtDateLayout, rtDateMonth, rtDateMonths, rtDateNow, rtDateParse, rtDateRead, rtDateShape, rtDateSplit, rtDateText, rtDateTime, rtDateTimeColumns, rtDateWeekdays, rtDateWrite };

package/types/rt-tools-ui-kit-v2-date-range.d.ts

@@ -0,0 +1,98 @@
+import * as i0 from '@angular/core';
+import { Signal, ElementRef, WritableSignal, InputSignal } from '@angular/core';
+import { TRtKitLabelMap, IRtInput } from '@rt-tools/ui-kit-v2/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+import { RtPopoverDirective } from '@rt-tools/ui-kit-v2/popover';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/** Быстрый вариант диапазона в панели поля. */
+declare enum ERtDateRangePreset {
+    Today = "today",
+    Yesterday = "yesterday",
+    Last7 = "last-7",
+    Last30 = "last-30",
+    ThisMonth = "this-month",
+    LastMonth = "last-month"
+}
+/** Контракт rt-date-range. */
+declare namespace IRtDateRange {
+    /** Значение поля: первый и последний день периода `YYYY-MM-DD`, оба включены, `start <= end`. */
+    interface Value {
+        start: string;
+        end: string;
+    }
+    /** Быстрый вариант в панели: его диапазон и выключен ли он границами. */
+    interface PresetCell {
+        preset: ERtDateRangePreset;
+        range: Value;
+        disabled: boolean;
+    }
+    /** Что месяц панели знает о черновике, наведении и границах. */
+    interface MonthContext {
+        locale: string;
+        today: string;
+        start: string | null;
+        end: string | null;
+        /** День под указателем, пока выбрано только начало: до него рисуется будущий диапазон. */
+        hover: string | null;
+        min: string | null;
+        max: string | null;
+    }
+    /** Форма числа дней по правилам множественного числа локали. */
+    type Plural = 'one' | 'few' | 'many' | 'other';
+}
+
+/**
+ * Поле диапазона дат со своей панелью кита, визуально и по токенам идентичное rt-input (host — box
+ * `--rt-input-*`, input — прозрачный `__field`). Кнопка в конце поля открывает
+ * `rt-date-range-panel`: на широком экране в поповере, на узком — в нижней шторке. CVA через общий
+ * `RtFormControlBase`: clearable, авто-подсветка invalid, read-only представление.
+ *
+ * `value` — пара дней `{ start, end }` в форме `YYYY-MM-DD` или `null`. Текст в поле — две даты в
+ * порядке языка интерфейса через тире (`12.10.2026 — 15.10.2026` под `ru`); набирается так же.
+ * Нечитаемый или лежащий за границами текст оставляет значение прежним и помечает поле ошибкой.
+ */
+declare class RtDateRangeComponent extends RtFormControlBase<IRtDateRange.Value | null> {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    /** Узкий экран: панель открывается в нижней шторке, а не в поповере. */
+    protected readonly narrow: Signal<boolean>;
+    protected readonly fieldEl: Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly popover: Signal<RtPopoverDirective | undefined>;
+    /** Набранный текст не читается как диапазон в границах: поле помечено ошибкой. */
+    protected readonly textInvalid: WritableSignal<boolean>;
+    protected readonly sheetOpen: WritableSignal<boolean>;
+    /** Подсказка формы текста буквами кита: `дд.мм.гггг — дд.мм.гггг` под русскими метками. */
+    protected readonly shape: Signal<string>;
+    /** Значение, прочитанное из формы: не пара дней по порядку поле показывает пустой. */
+    protected readonly range: Signal<IRtDateRange.Value | null>;
+    protected readonly text: Signal<string>;
+    protected readonly hasValue: Signal<boolean>;
+    /** Ширина поля в знаках — по длине формы значения, как у поля даты. */
+    protected readonly fieldSize: Signal<number>;
+    /** Подсказка обрезается многоточием в узком поле, поэтому шаблон целиком виден при наведении. */
+    protected readonly shapeTitle: Signal<string | null>;
+    /** Вид рамки: `outline` — рамка со всех сторон, `fill` — залитое поле с чертой снизу. */
+    readonly appearance: InputSignal<IRtInput.Appearance>;
+    readonly displayText: Signal<string>;
+    /** Первый допустимый день `YYYY-MM-DD`. */
+    readonly min: InputSignal<string | null>;
+    /** Последний допустимый день `YYYY-MM-DD`. */
+    readonly max: InputSignal<string | null>;
+    /** Значение из формы снимает ошибку набора: в поле теперь стоит оно. */
+    writeValue(value: IRtDateRange.Value | null): void;
+    protected getEmptyValue(): IRtDateRange.Value | null;
+    protected focusAfterClear(): void;
+    protected clearValue(): void;
+    /** Набор текста: значение меняется, только когда текст читается как диапазон в границах. */
+    protected onTyped(event: Event): void;
+    /** Кнопка в конце поля: на узком экране открывает шторку, на широком поповер открывает сам. */
+    protected openPanel(): void;
+    protected closePanel(): void;
+    protected onPicked(value: IRtDateRange.Value): void;
+    protected onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDateRangeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDateRangeComponent, "rt-date-range", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { ERtDateRangePreset, IRtDateRange, RtDateRangeComponent };

package/types/rt-tools-ui-kit-v2-delta-view.d.ts

@@ -0,0 +1,20 @@
+import * as i0 from '@angular/core';
+import { InputSignal } from '@angular/core';
+import { IQuillDelta } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Безопасный рендер Quill delta: обход ops со сборкой DOM через нативный API
+ * (`createElement`/`createTextNode` — текст экранируется автоматически). Никакого
+ * `innerHTML`: содержимое `insert` — произвольный пользовательский текст. Блочные
+ * атрибуты (list/header/blockquote/code-block) Quill вешает на op перевода строки —
+ * накопленный inline-буфер закрывается этим блоком.
+ */
+declare class RtDeltaViewComponent {
+    #private;
+    readonly delta: InputSignal<IQuillDelta | null>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDeltaViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDeltaViewComponent, "rt-delta-view", never, { "delta": { "alias": "delta"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { RtDeltaViewComponent };

package/types/rt-tools-ui-kit-v2-detail-list.d.ts

@@ -0,0 +1,33 @@
+import * as i0 from '@angular/core';
+import { InputSignal, InputSignalWithTransform } from '@angular/core';
+import { BooleanInput } from '@angular/cdk/coercion';
+
+/**
+ * Контейнер для стопки `rt-detail-row` — задаёт единый вертикальный gap между
+ * строками «лейбл + значение». Используется в read-only details-панелях асайдов
+ * (детали заявки, профиля) вместо самопальных `div`-обёрток.
+ *
+ * Контент — только `rt-detail-row` через проекцию.
+ */
+declare class RtDetailListComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDetailListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDetailListComponent, "rt-detail-list", never, {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Одна read-only строка «лейбл + значение» в stacked-раскладке: приглушённый
+ * лейбл сверху, значение снизу. Единый паттерн info-строки для всех асайдов
+ * (раньше — пять разных реализаций).
+ *
+ * Значение проецируется через `<ng-content>` — допустим текст, дата через pipe
+ * или `rt-tag`. При `[loading]="true"` значение замещается скелетоном (потребитель
+ * не оборачивает `rt-skeleton-wrapper` вручную).
+ */
+declare class RtDetailRowComponent {
+    readonly label: InputSignal<string>;
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDetailRowComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDetailRowComponent, "rt-detail-row", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { RtDetailListComponent, RtDetailRowComponent };

package/types/rt-tools-ui-kit-v2-dialog.d.ts

@@ -0,0 +1,287 @@
+import * as i0 from '@angular/core';
+import { InputSignal, WritableSignal, InjectionToken, Signal, InputSignalWithTransform } from '@angular/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+import { OverlayRef, ComponentType } from '@angular/cdk/overlay';
+import { Observable } from 'rxjs';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+
+type TRtDialogSize = 'sm' | 'md' | 'lg';
+/**
+ * Презентационный styled-frame для модалки поверх CDK Overlay.
+ *
+ * Видимость / backdrop / scroll-block / ESC / фокус — НЕ внутренняя
+ * ответственность компонента. Это обеспечивает `RtDialogService.open()`: оверлей CDK, а
+ * ловушку и первый фокус — по флагам `trapFocus`, `restoreFocus` и `autoFocus` (по
+ * умолчанию выключены). Рамка несёт `tabindex="-1"`, чтобы `autoFocus: 'dialog'` мог её взять. rt-dialog здесь — стилизованная "рамка"
+ * (padding-free контейнер) с size-вариантами + ng-content слотом.
+ *
+ * Композиция:
+ * \`\`\`html
+ * <rt-dialog size="md">
+ *   <rt-dialog-header title="Создание записи" />
+ *   <div style="padding: var(--rt-space-lg);">body...</div>
+ *   <rt-dialog-footer>
+ *     <button rtButton (click)="cancel()">Отмена</button>
+ *     <button rtButton (click)="save()">Сохранить</button>
+ *   </rt-dialog-footer>
+ * </rt-dialog>
+ * \`\`\`
+ *
+ * Открытие — через `RtDialogService.open(MyModalComponent, { data })` →
+ * получаешь `RtDialogRef<T>` с `.close(result)` + `.afterClosed()`.
+ *
+ * `ViewEncapsulation.None` — стили префиксованы `.rt-dialog`, чтобы
+ * rt-dialog-header / rt-dialog-footer subscriptions работали с одним
+ * BEM-классом без cross-encapsulation хака.
+ */
+declare class RtDialogComponent {
+    /**
+     * Размер модалки:
+     * - `sm` — 460px (`--rt-dialog-width-sm`)
+     * - `md` — 660px (`--rt-dialog-width-md`, дефолт)
+     * - `lg` — 860px (`--rt-dialog-width-lg`)
+     */
+    readonly size: InputSignal<TRtDialogSize>;
+    /** Override ширины через CSS-property `--rt-dialog-width`. Имеет приоритет над `size`. */
+    readonly width: InputSignal<string | null>;
+    /** ARIA-label для dialog-обёртки (если нет видимого заголовка). */
+    readonly ariaLabel: InputSignal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDialogComponent, "rt-dialog", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+/**
+ * Хэндл к программно открытой модалке (через `RtDialogService.open()`).
+ *
+ * Контент-компонент инжектит `RtDialogRef` и закрывает модалку через `.close(result?)`.
+ * Родитель, открывший модалку, ждёт результата через `.afterClosed()`.
+ *
+ * Слой, снятый без `close()` — переходом по адресу или уничтожением хозяина, — тоже завершает
+ * `afterClosed()`: подписчик получает `undefined`. Иначе он ждал бы ответа, которого не будет.
+ *
+ * Generic `<T>` — тип результата `close(result)`. Дефолт `unknown` — если результат
+ * не нужен, оставляй generic пустым.
+ *
+ * @example
+ * \`\`\`ts
+ * // в контент-компоненте
+ * private readonly dialogRef = inject(RtDialogRef);
+ * close(): void { this.dialogRef.close({ confirmed: true }); }
+ *
+ * // в родителе
+ * dialogService.open(MyDialogComponent).afterClosed().subscribe((result) => {...});
+ * \`\`\`
+ */
+declare class RtDialogRef<T = unknown> {
+    #private;
+    /**
+     * Runtime-флаг, блокирующий close() через ESC / backdrop click.
+     *
+     * Default `false`. Включай (`dialogRef.disableClose.set(true)`) на
+     * время in-flight submit'а, чтобы юзер не потерял введённые в форму
+     * данные на случайном ESC. После next/error subscribe ставь обратно
+     * в `false`. Не влияет на программный `close(result)` — он всегда
+     * закрывает overlay.
+     *
+     * Статические config-флаги `closeOnEscape` / `closeOnBackdropClick`
+     * (см. `IRtDialogConfig`) определяют, подписан ли вообще handler на
+     * соответствующее событие; `disableClose` — это runtime-override,
+     * который гейтит dispatch внутри уже-подписанного handler'а.
+     */
+    readonly disableClose: WritableSignal<boolean>;
+    constructor(overlayRef: OverlayRef);
+    /** Закрывает overlay; опционально передаёт результат подписчикам `afterClosed()`. */
+    close(result?: T): void;
+    /** Эмиттит один раз — результат `close(result)` или `undefined` при снятом слое — и завершается. */
+    afterClosed(): Observable<T | undefined>;
+}
+
+/**
+ * Конфигурация открытия модалки через `RtDialogService.open()`.
+ */
+interface IRtDialogConfig<TData = unknown> {
+    /** Данные, доступные внутри модалки через `inject(RT_DIALOG_DATA)`. */
+    data?: TData;
+    /** Дополнительный CSS-класс для backdrop (поверх стандартного `rt-dialog-backdrop`). */
+    backdropClass?: string | string[];
+    /** Дополнительный CSS-класс для panel-обёртки overlay (поверх `rt-dialog-overlay`). */
+    panelClass?: string | string[];
+    /** Закрывать модалку по клику на backdrop. По дефолту `true`. */
+    closeOnBackdropClick?: boolean;
+    /** Закрывать модалку по ESC. По дефолту `true`. */
+    closeOnEscape?: boolean;
+    /** Держать Tab внутри модалки, пока она открыта. По дефолту `false` — как было. */
+    trapFocus?: boolean;
+    /** После закрытия вернуть фокус туда, где он стоял при открытии. По дефолту `false`. */
+    restoreFocus?: boolean;
+    /**
+     * Куда поставить фокус при открытии: `'dialog'` — на рамку окна, `'first-tabbable'` — на первый
+     * элемент, до которого доходит Tab. По дефолту `false` — фокус не трогается.
+     */
+    autoFocus?: TRtDialogAutoFocus;
+}
+/** Куда диалог ставит фокус при открытии; `false` — никуда. */
+type TRtDialogAutoFocus = 'dialog' | 'first-tabbable' | false;
+/**
+ * Программный API для открытия модалок поверх CDK Overlay.
+ *
+ * Устройство сервиса:
+ * - `Overlay.position().global().centerHorizontally().centerVertically()` — центрирование.
+ * - `scrollStrategies.block()` — фиксирует background-scroll.
+ * - `hasBackdrop: true` + кастомный класс — затемнение.
+ * - `ComponentPortal` + custom `Injector` подкидывает `RtDialogRef` + `RT_DIALOG_DATA` в DI
+ *   контент-компонента.
+ *
+ * Альтернатива: legacy inline `<rt-dialog [visible]>` форма продолжает работать через
+ * native `<dialog>.showModal()`. Новые экраны — на программный API.
+ *
+ * @example
+ * \`\`\`ts
+ * // открытие
+ * private readonly dialogService = inject(RtDialogService);
+ *
+ * openConfirm(): void {
+ *   const ref = this.dialogService.open<ConfirmDialogComponent, { question: string }, boolean>(
+ *     ConfirmDialogComponent,
+ *     { data: { question: "Удалить?" } }
+ *   );
+ *   ref.afterClosed().subscribe((confirmed) => {
+ *     if (confirmed) this.delete();
+ *   });
+ * }
+ *
+ * // контент-компонент
+ * @Component({
+ *   selector: "rt-confirm-dialog",
+ *   template: \`
+ *     <rt-dialog size="sm">
+ *       <rt-dialog-header [title]="data.question" />
+ *       <div>Действие необратимо.</div>
+ *       <rt-dialog-footer>
+ *         <button rtButton (click)="close(false)">Отмена</button>
+ *         <button rtButton theme="danger" (click)="close(true)">Удалить</button>
+ *       </rt-dialog-footer>
+ *     </rt-dialog>
+ *   \`,
+ * })
+ * export class ConfirmDialogComponent {
+ *   readonly data = inject(RT_DIALOG_DATA) as { question: string };
+ *   readonly #ref = inject(RtDialogRef<boolean>);
+ *   close(result: boolean): void { this.#ref.close(result); }
+ * }
+ * \`\`\`
+ */
+declare class RtDialogService {
+    #private;
+    constructor();
+    open<TComponent, TData = unknown, TResult = unknown>(component: ComponentType<TComponent>, config?: IRtDialogConfig<TData>): RtDialogRef<TResult>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDialogService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+/**
+ * Injection token для передачи данных в модалку, открытую через `RtDialogService.open()`.
+ *
+ * Пользовательский компонент-контент модалки инжектит токен и получает данные,
+ * переданные в `DialogConfig.data`. Тип значения задаётся generic'ом — `inject(RT_DIALOG_DATA)`
+ * вернёт `unknown`, прокастуй через `inject(RT_DIALOG_DATA) as MyDataType` ИЛИ
+ * объяви токен с конкретным generic'ом в feature-либе.
+ *
+ * @example
+ * \`\`\`ts
+ * @Component({...})
+ * export class WelcomeModalComponent {
+ *   readonly data = inject(RT_DIALOG_DATA) as { userName: string };
+ * }
+ *
+ * // parent
+ * dialogService.open(WelcomeModalComponent, { data: { userName: "Иван" } });
+ * \`\`\`
+ */
+declare const RT_DIALOG_DATA: InjectionToken<unknown>;
+
+/**
+ * Заголовок модалки для композиции внутри `<rt-dialog>`.
+ *
+ * Если компонент рендерится внутри overlay-портала, открытого через `RtDialogService.open()`,
+ * кнопка закрытия дёргает `inject(RtDialogRef).close()` автоматически. В legacy-режиме
+ * (внутри inline `<rt-dialog [visible]>`) `RtDialogRef` не зарегистрирован — клик
+ * по close-кнопке эмитит output `(closeAction)`, который должен повесить родитель.
+ *
+ * Перед заголовком — место для значка или другого элемента: узел с атрибутом
+ * `rtDialogHeaderLead` проецируется туда. Пустое место ничего не занимает.
+ *
+ * `ViewEncapsulation.None` — для единообразия с rt-dialog (стили префиксованы `.rt-dialog-header`).
+ *
+ * @example
+ * \`\`\`html
+ * <rt-dialog size="md">
+ *   <rt-dialog-header title="Создание записи" />
+ *   <div>...форма...</div>
+ *   <rt-dialog-footer>
+ *     <button rtButton (click)="cancel()">Отмена</button>
+ *     <button rtButton theme="primary" (click)="save()">Сохранить</button>
+ *   </rt-dialog-footer>
+ * </rt-dialog>
+ * \`\`\`
+ */
+declare class RtDialogHeaderComponent {
+    #private;
+    /** Текст заголовка — рендерится в `<h2>`. */
+    protected readonly t: Signal<TRtKitLabelMap>;
+    readonly title: InputSignal<string>;
+    /** Показывать кнопку закрытия в углу заголовка. Дефолт `true`. */
+    readonly closable: InputSignalWithTransform<boolean, BooleanInput>;
+    protected onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDialogHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDialogHeaderComponent, "rt-dialog-header", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; }, {}, never, ["[rtDialogHeaderLead]"], true, never>;
+}
+
+/** Как подвал раскладывает содержимое: к началу, по центру, к концу или по обоим краям. */
+type TRtDialogFooterAlign = 'start' | 'center' | 'end' | 'between';
+/**
+ * Footer-слот для композиции внутри `<rt-dialog>`. Принимает любой проектированный
+ * контент (action-кнопки, статусные сообщения и т.п.), оборачивает в footer с
+ * top-border и flex-раскладкой; вход `align` прижимает содержимое к концу (по умолчанию),
+ * к началу, к центру или разводит по краям (`between`).
+ *
+ * `ViewEncapsulation.None` — для единообразия с rt-dialog.
+ *
+ * @example
+ * \`\`\`html
+ * <rt-dialog-footer>
+ *   <button rtButton (click)="cancel()">Отмена</button>
+ *   <button rtButton theme="primary" (click)="save()">Сохранить</button>
+ * </rt-dialog-footer>
+ * \`\`\`
+ */
+declare class RtDialogFooterComponent {
+    readonly align: InputSignal<TRtDialogFooterAlign>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDialogFooterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDialogFooterComponent, "rt-dialog-footer", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Тело модалки для композиции внутри `<rt-dialog>` между шапкой и подвалом. Даёт отступ и
+ * прокрутку: длинное содержимое прокручивается внутри тела, а шапка и подвал стоят на месте.
+ * Отступ задаёт `--rt-dialog-content-padding`, потолок высоты — `--rt-dialog-content-max-height`.
+ *
+ * Часть необязательная: окно со своей обёрткой тела выглядит как прежде.
+ *
+ * @example
+ * \`\`\`html
+ * <rt-dialog size="md">
+ *   <rt-dialog-header title="Создание записи" />
+ *   <rt-dialog-content>...форма...</rt-dialog-content>
+ *   <rt-dialog-footer>...</rt-dialog-footer>
+ * </rt-dialog>
+ * \`\`\`
+ */
+declare class RtDialogContentComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDialogContentComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDialogContentComponent, "rt-dialog-content", never, {}, {}, never, ["*"], true, never>;
+}
+
+export { RT_DIALOG_DATA, RtDialogComponent, RtDialogContentComponent, RtDialogFooterComponent, RtDialogHeaderComponent, RtDialogRef, RtDialogService };
+export type { IRtDialogConfig, TRtDialogAutoFocus, TRtDialogFooterAlign, TRtDialogSize };

package/types/rt-tools-ui-kit-v2-dot-field.d.ts

@@ -0,0 +1,17 @@
+import * as i0 from '@angular/core';
+import { Signal, ElementRef } from '@angular/core';
+
+/**
+ * Фон из квадратных точек, которые медленно плывут облаками. Заполняет позиционированного
+ * родителя и стоит под его содержимым; в центре точки редеют. Цвет — CSS-свойство `color` хоста.
+ */
+declare class RtDotFieldComponent {
+    #private;
+    /** `viewChild` не принимает поле с решёткой. */
+    protected readonly canvas: Signal<ElementRef<HTMLCanvasElement>>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDotFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDotFieldComponent, "rt-dot-field", never, {}, {}, never, never, true, never>;
+}
+
+export { RtDotFieldComponent };