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

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

@@ -0,0 +1,61 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Радиокнопка: `role="radio"` с `aria-checked` и `aria-disabled`, выбор нажатием, пробелом и Enter.
+ *
+ * Выбор приходит двумя путями. Форма пишет модель через `ControlValueAccessor`, и радиокнопка
+ * выбрана, когда её значение — сама модель, а не равное ей. Без формы выбранность ставится входом
+ * `checked`, а выбор сообщается выходом `checkedChange`: так строку отмечает таблица. Заданный вход
+ * решает раньше модели формы.
+ *
+ * Нажатие на выбранную выбор не снимает — радиокнопку покидают только выбором другой. Каждое
+ * нажатие сообщается наружу `clickAction` и дальше обёртки не идёт: строка таблицы под кружком не
+ * открывается. Выбор клавишей наружу нажатием не сообщается.
+ *
+ * Отключение складывается из входа `disabled` и слова формы: форма зовёт `setDisabledState`
+ * раньше первого обновления вида, и один общий signal затёр бы её слово.
+ *
+ * Каждая радиокнопка — свой `ControlValueAccessor`, и значение, отданное одной, форма соседям на
+ * том же контроле не пишет: поэтому модель берётся и у самого контрола.
+ */
+declare class RtRadioButtonComponent implements ControlValueAccessor {
+    #private;
+    protected readonly isChecked: Signal<boolean>;
+    protected readonly isDisabled: Signal<boolean>;
+    /** Значение радиокнопки: выбрана та, чьё значение — модель формы. */
+    readonly value: InputSignal<unknown>;
+    /** Выбранность без формы; не заданный вход оставляет решение форме. */
+    readonly checked: InputSignalWithTransform<boolean | null, BooleanInput | null | undefined>;
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Вид «карточка»: рамка, содержимое слева, кружок справа. */
+    readonly card: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly label: InputSignal<string>;
+    readonly description: InputSignal<string>;
+    /** Имя для вспомогательных средств, когда видимой подписи нет — кружок в строке таблицы. */
+    readonly ariaLabel: InputSignal<string | null>;
+    /** Каждое нажатие указателем, сменило оно выбор или нет. */
+    readonly clickAction: OutputEmitterRef<MouseEvent>;
+    /** Радиокнопка стала выбранной. */
+    readonly checkedChange: OutputEmitterRef<boolean>;
+    constructor();
+    writeValue(value: unknown): void;
+    /**
+     * Директива формы зовёт это при каждой привязке к контролу — и первой, и после смены контрола,
+     * — уже поставив новый контрол себе. Здесь радиокнопка и узнаёт, кого слушать. Спросить
+     * директиву в конструкторе нельзя: она берёт радиокнопку своим accessor, и это круговая
+     * зависимость.
+     */
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(disabled: boolean): void;
+    protected onClick(event: MouseEvent): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtRadioButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtRadioButtonComponent, "rt-radio-button", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "card": { "alias": "card"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "clickAction": "clickAction"; "checkedChange": "checkedChange"; }, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtRadioButtonComponent };

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

@@ -0,0 +1,37 @@
+import * as i0 from '@angular/core';
+import { InputSignal, Signal } from '@angular/core';
+import { TRtRadius } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Вход скругления, один на весь кит. Компонент с поверхностью берёт его
+ * хост-директивой, и у всех он называется одинаково — `radius`.
+ *
+ * Шаг ложится на хост атрибутом `data-rt-radius`, а не наследуемым свойством:
+ * свойство протекло бы в каждый вложенный компонент, и скруглённая карточка
+ * скруглила бы все кнопки в себе. Атрибут читают только правила своего хоста.
+ *
+ * Пустой вход атрибута не пишет: компонент остаётся со своим скруглением по
+ * умолчанию из собственных стилей.
+ *
+ * @example
+ * ```ts
+ * @Component({
+ *     selector: 'rt-card',
+ *     hostDirectives: [{ directive: RtRadiusDirective, inputs: ['radius'] }],
+ * })
+ * ```
+ * ```html
+ * <rt-card radius="none">…</rt-card>
+ * ```
+ */
+declare class RtRadiusDirective {
+    #private;
+    /** Шаг шкалы. Пусто — скругление компонента по умолчанию. */
+    readonly radius: InputSignal<TRtRadius | null | undefined>;
+    /** Шаг на хосте: названный входом, иначе умолчание хоста, если оно задано. */
+    readonly step: Signal<TRtRadius | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtRadiusDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtRadiusDirective, "[rtRadius]", never, { "radius": { "alias": "radius"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { RtRadiusDirective };

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

@@ -278,27 +278,18 @@ declare class RtChatMessageActionsDirective {
 }
 
 /**
- * Общий презентационный чат: тред сообщений + композер. Никакого data-access/api — история
- * приходит готовым массивом `IRtChat.Message[]`, отправка/обновление/скачивание уходят наружу
- * через outputs, а стор и blob-загрузка остаются в feature-компоненте каждого домена.
- *
- * Композер держит свой `FormGroup` — наружу торчит только `send`. Полноэкранный
- * режим (expand) — overlay внутри самого компонента (`--expanded`), потребителю
- * лишь опционально сообщается через `expandedChange`.
- *
- * Шапка (тулбар «Чат» + refresh/expand) рендерится только когда включена хотя бы
- * одна из иконок (`showRefresh`/`showExpand`): в диалогах своя header-обёртка,
- * туда тулбар не нужен.
+ * Общий презентационный чат: тред сообщений + композер. История приходит готовым массивом
+ * `IRtChat.Message[]`, отправка, обновление, скачивание и набор текста уходят наружу выходами;
+ * стор и blob-загрузка остаются у потребителя. Композер держит свой `FormGroup`. Полноэкранный
+ * режим — overlay внутри компонента (`--expanded`). Шапка рисуется, только когда включена хотя бы
+ * одна из иконок `showRefresh`/`showExpand`: в диалогах своя header-обёртка.
  */
 declare class RtChatComponent {
     #private;
     /**
-     * Дата сообщения форматируется по активной локали приложения, а не по
-     * `LOCALE_ID`: тот вычисляется на подъёме приложения и там, где язык
-     * переключают на ходу, оставил бы часы в прежнем формате до перезагрузки.
-     *
-     * Данные локали для `DatePipe` регистрирует приложение: без них пайп падает
-     * `Missing locale data`, и кит за это не отвечает.
+     * Дата форматируется по активной локали приложения, а не по `LOCALE_ID`: тот вычисляется на
+     * подъёме и при смене языка на ходу оставил бы прежний формат. Данные локали для `DatePipe`
+     * регистрирует приложение: без них пайп падает `Missing locale data`.
      */
     protected readonly t: Signal<TRtKitLabelMap>;
     protected readonly locale: Signal<string>;
@@ -409,11 +400,14 @@ declare class RtChatComponent {
     readonly send: OutputEmitterRef<IRtChat.SendPayload>;
     /** Клик refresh — consumer перетягивает тред. */
     readonly refresh: OutputEmitterRef<void>;
-    /** Клик по вложению — consumer качает blob своим api. Шаблон зовёт выход прямо: релей-метод,
-     * который только повторял `emit`, ничего не добавлял, а файл при этом рос. */
+    /** Клик по вложению — consumer качает blob своим api; шаблон зовёт выход прямо, без релея. */
     readonly downloadFile: OutputEmitterRef<IRtChat.Message>;
     /** Клик по карточке вложения из `attachments[]` — консюмер качает по `publicId`. */
     readonly downloadAttachment: OutputEmitterRef<IRtChat.Attachment>;
+    /** Набор текста в поле ответа: `true` — отрезок начался, `false` — кончился. */
+    readonly typing: OutputEmitterRef<boolean>;
+    /** Строка о том, что печатает вторая сторона, поверх низа ленты; пустая прячет плашку. */
+    readonly typingText: InputSignal<string>;
     /** Смена fullscreen-состояния. */
     readonly expandedChange: OutputEmitterRef<boolean>;
     readonly deleteMessage: OutputEmitterRef<IRtChat.Message>;
@@ -431,6 +425,8 @@ declare class RtChatComponent {
     protected onComposerKeydown(event: KeyboardEvent): void;
     /** Релей submit'а от `rt-message-composer` (rich-режим) наружу как `send`. */
     protected onComposerSubmit(payload: IRtMessageComposer.SubmitPayload): void;
+    /** Ввод в поле ответа любого из двух режимов; выбор файла набором не считается. */
+    protected onReplyInput(event: Event): void;
     /**
      * Файлы выброшены в обёртку чата: в rich-режиме отдаём массив композеру через
      * input, в классическом — добавляем к уже выбранным в собственном `replyForm`.
@@ -443,7 +439,7 @@ declare class RtChatComponent {
     protected onThreadScroll(): void;
     protected toggleExpand(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RtChatComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RtChatComponent, "rt-chat", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "canReply": { "alias": "canReply"; "required": false; "isSignal": true; }; "replyBlockReason": { "alias": "replyBlockReason"; "required": false; "isSignal": true; }; "sending": { "alias": "sending"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "emptyHint": { "alias": "emptyHint"; "required": false; "isSignal": true; }; "hasThread": { "alias": "hasThread"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "richComposer": { "alias": "richComposer"; "required": false; "isSignal": true; }; "formatting": { "alias": "formatting"; "required": false; "isSignal": true; }; "formattingToolbar": { "alias": "formattingToolbar"; "required": false; "isSignal": true; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; "showRefresh": { "alias": "showRefresh"; "required": false; "isSignal": true; }; "showExpand": { "alias": "showExpand"; "required": false; "isSignal": true; }; "messageHasActions": { "alias": "messageHasActions"; "required": false; "isSignal": true; }; }, { "send": "send"; "refresh": "refresh"; "downloadFile": "downloadFile"; "downloadAttachment": "downloadAttachment"; "expandedChange": "expandedChange"; "deleteMessage": "deleteMessage"; "retryMessage": "retryMessage"; }, ["messageActions"], ["[rtChatHeaderActions]", "[rtChatFooter]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtChatComponent, "rt-chat", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "canReply": { "alias": "canReply"; "required": false; "isSignal": true; }; "replyBlockReason": { "alias": "replyBlockReason"; "required": false; "isSignal": true; }; "sending": { "alias": "sending"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "emptyHint": { "alias": "emptyHint"; "required": false; "isSignal": true; }; "hasThread": { "alias": "hasThread"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "richComposer": { "alias": "richComposer"; "required": false; "isSignal": true; }; "formatting": { "alias": "formatting"; "required": false; "isSignal": true; }; "formattingToolbar": { "alias": "formattingToolbar"; "required": false; "isSignal": true; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; "showRefresh": { "alias": "showRefresh"; "required": false; "isSignal": true; }; "showExpand": { "alias": "showExpand"; "required": false; "isSignal": true; }; "typingText": { "alias": "typingText"; "required": false; "isSignal": true; }; "messageHasActions": { "alias": "messageHasActions"; "required": false; "isSignal": true; }; }, { "send": "send"; "refresh": "refresh"; "downloadFile": "downloadFile"; "downloadAttachment": "downloadAttachment"; "typing": "typing"; "expandedChange": "expandedChange"; "deleteMessage": "deleteMessage"; "retryMessage": "retryMessage"; }, ["messageActions"], ["[rtChatHeaderActions]", "[rtChatFooter]"], true, never>;
 }
 
 /**

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

@@ -0,0 +1,39 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { InputSignalWithTransform } from '@angular/core';
+
+/**
+ * Волна нажатия. Ставится на элемент, который нажимают, и рисует расходящийся
+ * от точки касания круг.
+ *
+ * Волна живёт в своём обрезающем слое внутри элемента, а не прямо в нём:
+ * `overflow: hidden` на самой кнопке срезал бы всё, что торчит за её край, —
+ * у кнопки-значка так стоит метка, вынесенная на два пикселя наружу.
+ *
+ * @example
+ * ```html
+ * <button rtRipple>Сохранить</button>
+ * <button rtRipple [rippleDisabled]="loading()">Сохранить</button>
+ * ```
+ */
+declare class RtRippleDirective {
+    #private;
+    /**
+     * Отключает волну, не трогая остальное поведение элемента.
+     * Отключённая и загружающаяся кнопка волны не даёт.
+     */
+    readonly rippleDisabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Гасит незакончившиеся волны: иначе таймер трогает снятый из дерева узел. */
+    constructor();
+    /**
+     * Ставит один слой волны от точки нажатия и снимает его, когда тот отгорит.
+     *
+     * Радиус считается по дальнему углу элемента: волна из угла должна накрыть
+     * противоположный, иначе на широкой кнопке она обрывается на полпути.
+     */
+    launch(event: PointerEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtRippleDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtRippleDirective, "[rtRipple]", never, { "rippleDisabled": { "alias": "rippleDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { RtRippleDirective };

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

@@ -0,0 +1,91 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { TemplateRef, Signal, ElementRef, WritableSignal, InputSignalWithTransform } from '@angular/core';
+import { TNullable } from '@rt-tools/utils';
+import { TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Маркеры частей области прокрутки — своим файлом, как у соседних семей.
+ *
+ * Каждый маркер держит свой шаблон и не знает об области ничего: область читает маркеры среди
+ * своего содержимого и берёт у них шаблон. Часть, которую потребитель не объявил, для области
+ * просто отсутствует — рисовать нечего.
+ */
+/**
+ * Шапка области: стоит сверху и не прокручивается.
+ *
+ * @example
+ * ```html
+ * <rt-scroll-area>
+ *     <ng-container *rtScrollAreaHeader>
+ *         <h3>Заголовок</h3>
+ *     </ng-container>
+ * </rt-scroll-area>
+ * ```
+ */
+declare class RtScrollAreaHeaderDirective {
+    readonly templateRef: TemplateRef<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtScrollAreaHeaderDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtScrollAreaHeaderDirective, "[rtScrollAreaHeader]", never, {}, {}, never, never, true, never>;
+}
+/** Тело области: единственная часть, которая прокручивается. */
+declare class RtScrollAreaContentDirective {
+    readonly templateRef: TemplateRef<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtScrollAreaContentDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtScrollAreaContentDirective, "[rtScrollAreaContent]", never, {}, {}, never, never, true, never>;
+}
+/** Подвал области: стоит снизу и не прокручивается. */
+declare class RtScrollAreaFooterDirective {
+    readonly templateRef: TemplateRef<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtScrollAreaFooterDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtScrollAreaFooterDirective, "[rtScrollAreaFooter]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Область прокрутки: шапка и подвал стоят, тело прокручивается.
+ *
+ * Части объявляет потребитель — по директиве на каждую. Необъявленная часть не рисуется вовсе:
+ * пустая шапка это полоса отступа над списком, а высоту она забирает у тела, ради которого
+ * область и открыли.
+ *
+ * Договорённость — `docs/specs/ui-kit-v2/scroll-area/`.
+ */
+declare class RtScrollAreaComponent {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly bodyRef: Signal<TNullable<ElementRef<HTMLElement>>>;
+    protected readonly footerRef: Signal<TNullable<ElementRef<HTMLElement>>>;
+    /**
+     * Ниже окна области ещё есть содержимое. Считается по трём числам самого узла, а не по числу
+     * пунктов: область не знает, что ей подали, и высота строки у каждого потребителя своя.
+     */
+    protected readonly hasMoreBelow: WritableSignal<boolean>;
+    /**
+     * На сколько полоса растушёвки поднята над низом области. Она обязана кончиться там, где
+     * начинается содержимое подвала: разделитель потребитель рисует первой его строкой, и полоса,
+     * оборвавшаяся выше, оставляет до него чистый фон. Считается замером — верхний отступ подвала
+     * потребитель пишет как хочет, и вычесть его в стилях не из чего. Без подвала полоса стоит у
+     * самого низа.
+     */
+    protected readonly hintBottom: WritableSignal<number>;
+    readonly headerTpl: Signal<TNullable<RtScrollAreaHeaderDirective>>;
+    readonly contentTpl: Signal<TNullable<RtScrollAreaContentDirective>>;
+    readonly footerTpl: Signal<TNullable<RtScrollAreaFooterDirective>>;
+    /**
+     * Признак того, что снизу осталось непоказанное. Выключен по умолчанию: область рисуют
+     * десятки экранов, и признак, поставленный безусловно, сдвинул бы вид каждому из них.
+     */
+    readonly isScrollHintShown: InputSignalWithTransform<boolean, BooleanInput>;
+    constructor();
+    /**
+     * Нажатие на значок уводит тело к самому низу. Нажатие останавливается здесь и в содержимое
+     * под значком не уходит: под ним живой пункт, и человек, целившийся в подсказку, уехал бы на
+     * чужой экран.
+     */
+    onScrollHintClick(event: Event): void;
+    onBodyScroll(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtScrollAreaComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtScrollAreaComponent, "rt-scroll-area", never, { "isScrollHintShown": { "alias": "isScrollHintShown"; "required": false; "isSignal": true; }; }, {}, ["headerTpl", "contentTpl", "footerTpl"], never, true, never>;
+}
+
+export { RtScrollAreaComponent, RtScrollAreaContentDirective, RtScrollAreaFooterDirective, RtScrollAreaHeaderDirective };

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

@@ -0,0 +1,23 @@
+import * as i0 from '@angular/core';
+import { InputSignal, OutputEmitterRef } from '@angular/core';
+import { IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+declare namespace IRtSectionNav {
+    interface Item {
+        id: string;
+        icon: IRtIcon.Name;
+        label: string;
+        active: boolean;
+    }
+}
+
+declare class RtSectionNavComponent {
+    readonly items: InputSignal<readonly IRtSectionNav.Item[]>;
+    readonly itemSelect: OutputEmitterRef<string>;
+    protected onSelect(item: IRtSectionNav.Item): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSectionNavComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSectionNavComponent, "rt-section-nav", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { IRtSectionNav, RtSectionNavComponent };

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

@@ -0,0 +1,215 @@
+import * as i0 from '@angular/core';
+import { TemplateRef, Signal, ElementRef, WritableSignal, InputSignal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { TRtKitLabelMap, IRtInput, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+import { RtPopoverDirective, IRtPopover } from '@rt-tools/ui-kit-v2/popover';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Модель `<rt-select>`: один корневой неймспейс с префиксом `I`.
+ * Generic-параметр `TValue` повторяет тип значения, который сидит в опциях.
+ */
+declare namespace IRtSelect {
+    /** Одна опция dropdown'а. */
+    interface Option<TValue> {
+        label: string;
+        value: TValue;
+        disabled?: boolean;
+        /** Дети опции того же вида. Хотя бы одна опция с детьми делает список деревом. */
+        children?: ReadonlyArray<Option<TValue>>;
+    }
+    /** Видимая строка дерева: опция, её уровень и то, ветка ли она и раскрыта ли. */
+    interface Row<TValue> {
+        readonly option: Option<TValue>;
+        readonly level: number;
+        readonly branch: boolean;
+        readonly open: boolean;
+        readonly parent: TValue | null;
+    }
+    /** Сколько включённых листьев ветки выбрано: все, часть или ни одного. */
+    type TBranchState = 'all' | 'some' | 'none';
+    /** Что делать по боковой стрелке: какую ветку переключить и куда увести подсветку. */
+    interface SideKeyAnswer<TValue> {
+        readonly toggle: TValue | null;
+        readonly index: number;
+    }
+    /**
+     * Что кит отдаёт своей разметке указателя. Три значения и не больше: большее привязало бы
+     * разметку потребителя к устройству семьи, и семью стало бы не поправить, не сломав её.
+     */
+    interface TriggerState<TValue> {
+        /** Открыт ли список: по нему потребитель крутит шеврон. */
+        readonly isOpen: boolean;
+        /** Что выбрано. У выбора нескольких это все выбранные значения. */
+        readonly value: TValue | null;
+        /** Подпись выбранного — та же, что кит рисует в своём указателе. */
+        readonly label: string;
+        /** Отключён ли выбор. */
+        readonly isDisabled: boolean;
+    }
+    /** Обстановка шаблона указателя: состояние приходит как `$implicit`. */
+    interface TriggerContext<TValue> {
+        readonly $implicit: TriggerState<TValue>;
+    }
+}
+
+/**
+ * Маркер своей разметки указателя — того, что человек нажимает, чтобы открыть список.
+ *
+ * Поведение указателя остаётся киту: открытие панели, её ширина, приметы доступности,
+ * отключённость, клавиши и закрытие висят на кнопке. Потребитель даёт только то, что рисуется
+ * внутри неё, и получает три значения обстановки: открыт ли список, что выбрано, отключён ли выбор.
+ *
+ * Один маркер на обе семьи выбора: они отличаются только разметкой внутри кнопки, и два маркера
+ * разошлись бы на первой же правке.
+ *
+ * @example
+ * ```html
+ * <rt-select [options]="options">
+ *     <ng-template rtSelectTrigger let-state>
+ *         <rt-tag [value]="state.label" [icon]="state.isOpen ? 'chevron-up' : 'chevron-down'" />
+ *     </ng-template>
+ * </rt-select>
+ * ```
+ */
+declare class RtSelectTriggerDirective<TValue = unknown> {
+    readonly templateRef: TemplateRef<IRtSelect.TriggerContext<TValue>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSelectTriggerDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtSelectTriggerDirective<any>, "[rtSelectTrigger]", never, {}, {}, never, never, true, never>;
+}
+
+type TBooleanInput = boolean | string;
+/**
+ * Single-select dropdown с опциональным filter input.
+ *
+ * Panel рендерится через CDK Overlay (директива `[rtPopover]` на trigger'е) —
+ * не обрезается `overflow: hidden` предками (таблицы, aside, карточки) и
+ * авто-flip'ается у края viewport. CVA через общий `RtFormControlBase`. Крестик
+ * (`clearable`) слева от шеврона — виден при наличии значения, очищает выбор.
+ *
+ * Keyboard-nav (activedescendant): фокус на trigger'е, ArrowUp/Down двигают
+ * виртуальный highlight (`aria-activedescendant`), Enter выбирает, Escape
+ * закрывает. Home/End/typeahead — deferred.
+ */
+declare class RtSelectComponent<TValue> extends RtFormControlBase<TValue | null> {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly panelId: string;
+    protected readonly filterPlaceholderText: Signal<string>;
+    protected readonly popover: Signal<RtPopoverDirective>;
+    protected readonly triggerEl: Signal<ElementRef<HTMLButtonElement> | undefined>;
+    protected readonly filterTerm: WritableSignal<string>;
+    protected readonly activeIndex: WritableSignal<number>;
+    /** Раскрытые ветки дерева. Живут, пока открыта панель: при открытии раскрыты ветки над выбранным. */
+    protected readonly openBranches: WritableSignal<ReadonlySet<TValue>>;
+    protected readonly isOpen: Signal<boolean>;
+    /** Идентификатор подсвеченной опции — тот же, что уходит в `aria-activedescendant`. */
+    protected readonly activeOptionId: Signal<string | null>;
+    /**
+     * Своя разметка указателя, если потребитель её объявил. Не объявил — кит рисует свою, и ни один
+     * нынешний потребитель не двигается.
+     */
+    protected readonly triggerTpl: Signal<RtSelectTriggerDirective<TValue> | undefined>;
+    protected readonly hasValue: Signal<boolean>;
+    protected readonly selectedLabel: Signal<string>;
+    /** Дерево ли список: тогда у строк есть место под стрелку и отступ по уровню. */
+    protected readonly isTree: Signal<boolean>;
+    /** Видимые строки: плоский список — как прежде, дерево — по раскрытым веткам и поисковому слову. */
+    protected readonly rows: Signal<ReadonlyArray<IRtSelect.Row<TValue>>>;
+    /** Три значения, которые кит отдаёт своей разметке указателя, и не больше. */
+    protected readonly triggerState: Signal<IRtSelect.TriggerState<TValue>>;
+    /** Вид рамки: `outline` — рамка со всех сторон, `fill` — залитое поле с чертой снизу. */
+    readonly appearance: InputSignal<IRtInput.Appearance>;
+    readonly displayText: Signal<string>;
+    readonly options: InputSignal<ReadonlyArray<IRtSelect.Option<TValue>>>;
+    readonly placeholder: InputSignal<string>;
+    readonly iconLeft: InputSignal<IRtIcon.Name | null>;
+    readonly filter: InputSignalWithTransform<boolean, TBooleanInput>;
+    /** Пусто — берётся переведённая подпись по умолчанию */
+    readonly filterPlaceholder: InputSignal<string>;
+    /**
+     * Чем мерится панель. По умолчанию она не уже кнопки и дальше растёт по содержимому:
+     * со своим указателем кнопка бывает узкой, и панель по её ширине давила бы содержимое.
+     * `trigger` возвращает прежнее — ровно по кнопке, `auto` пускает панель по содержимому
+     * целиком. Предел высоты назначается входом `panelMaxHeight`.
+     */
+    readonly panelWidth: InputSignal<IRtPopover.Width>;
+    /**
+     * Предел высоты панели — длина как в стилях, например `20rem`. Пусто — предел кита
+     * `--rt-input-panel-max-height`, и длинный список прокручивается внутри панели: без предела
+     * он уходил за нижний край экрана, и пункты за краем были недостижимы. `none` снимает предел —
+     * для короткого списка, который должен открываться целиком, без прокрутки. Значение ставится
+     * на саму панель: она рисуется в наложении, вне поддерева блока.
+     */
+    readonly panelMaxHeight: InputSignal<string | null>;
+    readonly selectionChange: OutputEmitterRef<TValue | null>;
+    constructor();
+    setDisabledState(disabled: boolean): void;
+    protected getEmptyValue(): TValue | null;
+    protected focusAfterClear(): void;
+    protected clear(event?: Event): void;
+    protected onOpened(): void;
+    protected toggleBranch(event: Event, value: TValue): void;
+    protected onClosed(): void;
+    protected select(opt: IRtSelect.Option<TValue>): void;
+    protected setFilter(term: string): void;
+    protected onTriggerKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSelectComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSelectComponent<any>, "rt-select", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "iconLeft": { "alias": "iconLeft"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "panelWidth": { "alias": "panelWidth"; "required": false; "isSignal": true; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["triggerTpl"], never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+/**
+ * Держит подсвеченную клавишами опцию в видимой части панели.
+ *
+ * Панель списка ограничена по высоте, и длинный список прокручивается внутри неё. Клавиши двигают
+ * подсветку, но фокус остаётся на поле: браузер сам панель не прокручивает, и подсветка уходила
+ * за нижний край — человек выбирал Enter'ом то, чего не видел. После каждой отрисовки, в которой
+ * сменилась подсвеченная опция, она прокручивается ровно настолько, чтобы встать в панель.
+ *
+ * Панель рисуется в наложении, вне поддерева семьи, поэтому опция ищется в документе по своему
+ * идентификатору — тому же, что стоит в `aria-activedescendant`. На сервере отрисовки нет, и
+ * эффект не выполняется; среда без `scrollIntoView` пропускается.
+ *
+ * Зовётся в контексте внедрения — полем или конструктором семьи.
+ *
+ * @param activeOptionId идентификатор подсвеченной опции; `null` — подсветки нет или панель закрыта
+ */
+declare function rtScrollActiveOptionIntoView(activeOptionId: () => string | null): void;
+
+/**
+ * Дерево опций выбора из списка — общее для `rt-select` и `rt-multiselect`.
+ *
+ * Обе семьи раскладывают, ищут и считают дерево одинаково, поэтому это чистые функции в одном
+ * месте: две копии разошлись бы на первой правке. Состояние — какие ветки раскрыты — живёт в семье,
+ * здесь только расчёт по нему.
+ */
+type TOption<TValue> = IRtSelect.Option<TValue>;
+type TRow<TValue> = IRtSelect.Row<TValue>;
+/** Список — дерево, если хоть у одной опции есть дети. Плоский список рисуется как прежде. */
+declare function rtTreeIsTree<TValue>(options: ReadonlyArray<TOption<TValue>>): boolean;
+/** Опция по значению на любой глубине. */
+declare function rtTreeFind<TValue>(options: ReadonlyArray<TOption<TValue>>, value: TValue): TOption<TValue> | undefined;
+/**
+ * Включённые листья под опцией; у самого листа — он сам. Отключённая ветка не отдаёт никого: её
+ * листья выбрать нельзя, как и её саму.
+ */
+declare function rtTreeLeaves<TValue>(option: TOption<TValue>): ReadonlyArray<TValue>;
+/** Сколько включённых листьев ветки выбрано. Флажок ветки выводится из этого, а не хранится. */
+declare function rtTreeBranchState<TValue>(option: TOption<TValue>, chosen: ReadonlyArray<TValue>): IRtSelect.TBranchState;
+/** Ветки, под которыми лежит выбранное значение: они раскрыты, когда список открывается. */
+declare function rtTreeOpenFor<TValue>(options: ReadonlyArray<TOption<TValue>>, chosen: ReadonlyArray<TValue>): ReadonlySet<TValue>;
+/**
+ * Видимые строки по уровням. Без поискового слова раскрыты ветки из `open`. Со словом строка
+ * остаётся, если совпала она сама или кто-то под ней, и путь к совпадению показан раскрытым.
+ * Ветка, совпавшая сама, держит детей такими, какими они были.
+ */
+declare function rtTreeRows<TValue>(options: ReadonlyArray<TOption<TValue>>, open: ReadonlySet<TValue>, rawTerm?: string): ReadonlyArray<TRow<TValue>>;
+/**
+ * Ответ на боковую стрелку. Вправо: свёрнутая ветка раскрывается, раскрытая уводит подсветку на
+ * первого ребёнка. Влево: раскрытая ветка сворачивается, иначе подсветка уходит на родителя.
+ */
+declare function rtTreeSideKey<TValue>(rows: ReadonlyArray<TRow<TValue>>, index: number, key: string): IRtSelect.SideKeyAnswer<TValue>;
+/** Набор раскрытых веток с переключённой одной. */
+declare function rtTreeToggle<TValue>(open: ReadonlySet<TValue>, value: TValue): ReadonlySet<TValue>;
+
+export { IRtSelect, RtSelectComponent, RtSelectTriggerDirective, rtScrollActiveOptionIntoView, rtTreeBranchState, rtTreeFind, rtTreeIsTree, rtTreeLeaves, rtTreeOpenFor, rtTreeRows, rtTreeSideKey, rtTreeToggle };