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

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

@@ -0,0 +1,483 @@
+import * as i0 from '@angular/core';
+import { TemplateRef, Signal, ElementRef, WritableSignal, InputSignal, InputSignalWithTransform, OutputEmitterRef, InjectionToken, EnvironmentProviders } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { IRtIcon } from '@rt-tools/ui-kit-v2/core';
+
+declare namespace IRtSideMenu {
+    type ItemData = string | number | object;
+    /**
+     * Чем подменю держится открытым: наведением или закреплением — тогда оно стоит открытым, пока
+     * человек сам его не свернёт.
+     */
+    type SubMenuMode = 'hover' | 'pinned';
+    /** Номер пункта в списке избранного — тот же, что `id` пункта меню. */
+    type FavoriteId = Item['id'];
+    /**
+     * Место под скрытые кнопки строки: `always` — кнопка, ждущая наведения, держит свою ширину;
+     * `none` — в покое ширины не занимает, и подпись идёт до края.
+     */
+    type FavoriteActionsReserve = 'always' | 'none';
+    /**
+     * Число строк в заголовке блока избранного: `always` — всегда; `collapsed` — только у свёрнутого
+     * блока; `never` — никогда.
+     */
+    type FavoritesCount = 'always' | 'collapsed' | 'never';
+    /**
+     * Настройки одного меню под его номером в хранилище. Незнакомые поля кит не удаляет: их могло
+     * положить приложение или следующая версия кита.
+     */
+    interface Settings {
+        favorites?: FavoriteId[];
+        /** Пункты полосы, чей блок избранного свёрнут; блок по умолчанию развёрнут. */
+        favoritesCollapsed?: Array<Item['id']>;
+        subMenuMode?: SubMenuMode;
+        subMenuWidth?: number;
+        [field: string]: unknown;
+    }
+    interface Item {
+        id: string | number;
+        icon?: string;
+        name?: string;
+        link?: string;
+        submenu?: Item[];
+        /** Избранное в подменю этого пункта полосы. По умолчанию выключено. */
+        favorites?: boolean;
+        /**
+         * Пункт со ссылкой, который в избранное не ставится: своя страница раздела, дашборд,
+         * действие «Создать». Звезды у него нет, и номер, сохранённый раньше, в блок не попадает.
+         */
+        favoriteDisabled?: boolean;
+        iconButton?: {
+            icon: string;
+            data?: ItemData;
+        };
+    }
+    /** Кусок подписи: отмеченный — тот, которым она совпала с запросом. */
+    interface TitlePart {
+        text: string;
+        matched: boolean;
+    }
+}
+
+/** Шапка бокового меню: над полосой пунктов. */
+declare class RtSideMenuHeaderDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSideMenuHeaderDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtSideMenuHeaderDirective, "[rtSideMenuHeader]", never, {}, {}, never, never, true, never>;
+}
+/** Подвал бокового меню: под полосой пунктов. */
+declare class RtSideMenuFooterDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSideMenuFooterDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtSideMenuFooterDirective, "[rtSideMenuFooter]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Контекст своего значка: пункт, имя, которое надо нарисовать, и место. Шаблон один на меню и рисует
+ * и значок строки, и кнопку строки, поэтому рисунок выбирают по `icon`, а не по `item.icon`: у кнопки
+ * это имя её значка.
+ */
+interface IRtSideMenuIconContext {
+    $implicit: IRtSideMenu.Item;
+    /** Имя значка этого места: значка строки или кнопки строки. */
+    icon: string;
+    /** Место: значок строки или кнопка строки. */
+    slot: 'icon' | 'iconButton';
+}
+/**
+ * Помечает `<ng-template>` своего значка пунктов меню — для имён, которых нет ни в наборе кита, ни
+ * в перечне имён Material. Шаблон один на меню и рисует и значок строки, и значок кнопки строки; кит
+ * ставит его на место значка размером значка и цветом строки. Рисунок выбирают по `icon` контекста.
+ * Значок, который кит рисует сам, шаблон не перебивает.
+ *
+ * ```html
+ * <rt-side-menu [menuItems]="items">
+ *     <ng-template rtSideMenuIcon let-icon="icon"><img [src]="'/icons/' + icon + '.svg'" alt="" /></ng-template>
+ * </rt-side-menu>
+ * ```
+ */
+declare class RtSideMenuIconDirective {
+    readonly templateRef: TemplateRef<IRtSideMenuIconContext>;
+    static ngTemplateContextGuard(_directive: RtSideMenuIconDirective, context: unknown): context is IRtSideMenuIconContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSideMenuIconDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtSideMenuIconDirective, "ng-template[rtSideMenuIcon]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Меню, в котором стоит подпункт. Токен вместо самого компонента: меню объявляет подпункт в своих
+ * импортах, и прямая ссылка замкнула бы круг «меню → подпункт → меню».
+ *
+ * Активность и раскрытость — два значения: активным остаётся адрес, на котором человек стоит, а
+ * раскрытой — всякая папка, в которой нашлось совпадение.
+ */
+interface IRtSideMenuHost {
+    readonly activeMenuIds: Signal<ReadonlyArray<string | number>>;
+    readonly expandedMenuIds: Signal<ReadonlyArray<string | number>>;
+    readonly highlightedMenuId: Signal<string | number | null>;
+    readonly subMenuQuery: Signal<string>;
+    /** Номер, под которым меню хранит настройки, и пункты полосы: по ним избранное находит свой раздел. */
+    readonly menuId: Signal<string>;
+    readonly menuItems: Signal<ReadonlyArray<IRtSideMenu.Item>>;
+    /** Набор, который подменю наполняет сейчас, до отбора поиском. */
+    readonly shownSubMenu: Signal<IRtSideMenu.Item[]>;
+    readonly favoritesCount: Signal<IRtSideMenu.FavoritesCount>;
+    /** Поиск показывает совпавшие строки избранного; выключено — на время поиска блока нет. */
+    readonly isFavoritesSearchShown: Signal<boolean>;
+    /** Свой значок пунктов, чьё имя кит не рисует: шаблон `rtSideMenuIcon` меню. */
+    readonly ownIconTpl: Signal<TemplateRef<IRtSideMenuIconContext> | undefined>;
+    /** Подсказки строк подменю: выключено — их нет ни у подписей, ни у кнопок строк. */
+    readonly subMenuTooltipsShown: Signal<boolean>;
+    /** Раскрыть или свернуть папку нажатием её заголовка. */
+    toggleFolder(item: IRtSideMenu.Item): void;
+    /** Уход указателя с панели: подменю, открытое наведением, закрывается. */
+    toggleSubMenu(): void;
+    /** Строку избранного тянут: подменю, открытое наведением, не закрывается уходом указателя. */
+    holdSubMenu(held: boolean): void;
+}
+
+/**
+ * Боковая навигация: полоса пунктов и подменю раздела рядом. Перенос бокового меню первого кита на
+ * части второго; `rt-menu` — другое семейство, выпадающее меню действий.
+ */
+declare class RtSideMenuComponent implements IRtSideMenuHost {
+    #private;
+    protected readonly searchControl: FormControl<string | null>;
+    protected readonly panelRef: Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly headerTpl: Signal<TemplateRef<unknown> | undefined>;
+    protected readonly footerTpl: Signal<TemplateRef<unknown> | undefined>;
+    protected readonly searchLabel: Signal<string>;
+    protected readonly pinLabel: Signal<string>;
+    protected readonly unpinLabel: Signal<string>;
+    protected readonly nothingFoundLabel: Signal<string>;
+    protected readonly resizeLabel: Signal<string>;
+    protected readonly backLabel: Signal<string>;
+    /** Экран узкий: замер кита, и другого источника у этого признака нет. */
+    protected readonly narrow: Signal<boolean>;
+    protected readonly resizeValueNow: Signal<number | null>;
+    protected readonly resizeValueMin: number;
+    protected readonly resizeValueMax: number;
+    /** Натянутая ширина панели. Своего выбора нет — свойство не ставится, и ширину берёт оформление. */
+    protected readonly panelWidthStyle: Signal<string | null>;
+    /** Закрепление действует только на широком экране: на узком подменю занимает экран целиком. */
+    protected readonly isPinned: Signal<boolean>;
+    /** Подменю держится набором запроса: уходом указателя не закрывается. */
+    protected readonly isSearchHeld: Signal<boolean>;
+    /** Закреплённое подменю открыто, пока ему есть что показать: указатель на это не влияет. */
+    protected readonly subMenuOpened: Signal<boolean>;
+    protected readonly visibleSubMenuItems: Signal<IRtSideMenu.Item[]>;
+    protected readonly isNothingFound: Signal<boolean>;
+    /** Пункт полосы подсвечен активным: выбранный человеком, а без выбора — пункт текущего адреса. */
+    protected readonly activeRailIds: Signal<ReadonlyArray<string | number>>;
+    /** Набор, который подменю наполняет сейчас, до отбора поиском. */
+    readonly shownSubMenu: Signal<IRtSideMenu.Item[]>;
+    readonly selectedItem: WritableSignal<IRtSideMenu.Item | null>;
+    readonly selectedSubMenu: WritableSignal<IRtSideMenu.Item[] | null>;
+    /** Что набрано в поиске: строка берёт запрос отсюда, чтобы отметить совпавшее. */
+    readonly subMenuQuery: WritableSignal<string>;
+    readonly highlightedMenuId: Signal<string | number | null>;
+    /**
+     * Какие папки раскрыты. Пустой запрос оставляет раздел текущего адреса; непустой добавляет
+     * папки с совпадением — иначе найденное лежит за закрытым заголовком.
+     */
+    readonly expandedMenuIds: Signal<ReadonlyArray<string | number>>;
+    readonly activeMenuIds: InputSignal<ReadonlyArray<string | number>>;
+    readonly menuItems: InputSignal<ReadonlyArray<IRtSideMenu.Item>>;
+    /** Режим подменю от приложения. Задан — важнее сохранённого; нет ни того, ни другого — наведение. */
+    readonly subMenuMode: InputSignal<IRtSideMenu.SubMenuMode | undefined>;
+    /** Ширина закреплённого подменю в пикселях. Пусто — сохранённая, её нет — оформление. */
+    readonly subMenuWidth: InputSignal<number | null | undefined>;
+    /** Номер, под которым меню хранит свои настройки: у двух меню приложения — два номера. */
+    readonly menuId: InputSignalWithTransform<string, string | null | undefined>;
+    /** Число строк в заголовке блока избранного: всегда, у свёрнутого блока или никогда. */
+    readonly favoritesCount: InputSignal<IRtSideMenu.FavoritesCount>;
+    /** Место под кнопки избранного, ждущие наведения: держать всегда или отдавать подписи. */
+    readonly favoriteActionsReserve: InputSignal<IRtSideMenu.FavoriteActionsReserve>;
+    /** Поиск показывает совпавшие строки избранного; выключено — на время поиска блока нет. */
+    readonly isFavoritesSearchShown: InputSignalWithTransform<boolean, unknown>;
+    /** Кнопка закрепления в шапке подменю; выключено — подменю только всплывает, если режим не задан входом. */
+    readonly pinShown: InputSignalWithTransform<boolean, unknown>;
+    /** Подсказки строк подменю — у подписей и у кнопок строк. Доступные имена остаются. */
+    readonly subMenuTooltipsShown: InputSignalWithTransform<boolean, unknown>;
+    readonly subMenuModeChange: OutputEmitterRef<IRtSideMenu.SubMenuMode>;
+    readonly subMenuWidthChange: OutputEmitterRef<number>;
+    /** Начало и конец тяги: по ним потребитель накрывает чужие кадры и снимает накрытие. */
+    readonly subMenuResizeStart: OutputEmitterRef<void>;
+    readonly subMenuResizeEnd: OutputEmitterRef<void>;
+    readonly closeMobileMenuAction: OutputEmitterRef<void>;
+    readonly clickSubMenuAction: OutputEmitterRef<{
+        item: IRtSideMenu.Item;
+        event: MouseEvent;
+    }>;
+    readonly clickSubMenuAdditionalAction: OutputEmitterRef<{
+        data: IRtSideMenu.ItemData | undefined;
+        event: MouseEvent;
+    }>;
+    /** Свой значок пунктов, чьё имя кит не рисует; подпункты читают его через токен меню. */
+    readonly ownIconTpl: Signal<TemplateRef<IRtSideMenuIconContext> | undefined>;
+    constructor();
+    onClickMenu(item: IRtSideMenu.Item): void;
+    onClickSubMenu({ item, event }: {
+        item: IRtSideMenu.Item;
+        event: MouseEvent;
+    }): void;
+    onClickSubMenuAdditional(payload: {
+        data: IRtSideMenu.ItemData | undefined;
+        event: MouseEvent;
+    }): void;
+    onBackToMainMenu(): void;
+    /** Наведение на пункт полосы открывает его подменю; уход указателя с панели — без пункта. */
+    toggleSubMenu(item?: IRtSideMenu.Item): void;
+    closeSubMenu(): void;
+    holdSubMenu(held: boolean): void;
+    toggleFolder(item: IRtSideMenu.Item): void;
+    /** Человек взялся за поле поиска: дальше подменю закрывает нажатие снаружи, а не уход указателя. */
+    onSearchHold(): void;
+    /** Клавиши поля поиска раздаются списку; умолчание отменяется только у съеденной. */
+    onSearchKeydown(event: KeyboardEvent): void;
+    /** Нажат переключатель режима: выбор уходит в настройки меню и наружу. */
+    onSubMenuModeToggle(): void;
+    onResizeStart(event: PointerEvent): void;
+    onResizeKeydown(event: KeyboardEvent): void;
+    closeMobileMenu(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSideMenuComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSideMenuComponent, "rt-side-menu", never, { "activeMenuIds": { "alias": "activeMenuIds"; "required": true; "isSignal": true; }; "menuItems": { "alias": "menuItems"; "required": false; "isSignal": true; }; "subMenuMode": { "alias": "subMenuMode"; "required": false; "isSignal": true; }; "subMenuWidth": { "alias": "subMenuWidth"; "required": false; "isSignal": true; }; "menuId": { "alias": "menuId"; "required": false; "isSignal": true; }; "favoritesCount": { "alias": "favoritesCount"; "required": false; "isSignal": true; }; "favoriteActionsReserve": { "alias": "favoriteActionsReserve"; "required": false; "isSignal": true; }; "isFavoritesSearchShown": { "alias": "isFavoritesSearchShown"; "required": false; "isSignal": true; }; "pinShown": { "alias": "pinShown"; "required": false; "isSignal": true; }; "subMenuTooltipsShown": { "alias": "subMenuTooltipsShown"; "required": false; "isSignal": true; }; }, { "subMenuModeChange": "subMenuModeChange"; "subMenuWidthChange": "subMenuWidthChange"; "subMenuResizeStart": "subMenuResizeStart"; "subMenuResizeEnd": "subMenuResizeEnd"; "closeMobileMenuAction": "closeMobileMenuAction"; "clickSubMenuAction": "clickSubMenuAction"; "clickSubMenuAdditionalAction": "clickSubMenuAdditionalAction"; }, ["headerTpl", "footerTpl", "ownIconTpl"], never, true, never>;
+}
+
+/**
+ * Отбор пунктов подменю по подстроке подписи.
+ *
+ * Отбор спускается внутрь папок на любую глубину: потребитель кладёт в папки то, что человек и ищет
+ * по имени, и по одному верхнему уровню такой пункт не нашёлся бы.
+ *
+ * В выдаче стоят только строки, содержащие запрос. Папка остаётся путём к совпавшим детям, а её
+ * состав отбирается тем же правилом: иначе одно совпадение по имени папки вытаскивало бы весь её
+ * состав. Папка, совпавшая только по имени, остаётся одной строкой без детей.
+ *
+ * Отобранная папка — новый объект: правка на месте переписала бы набор потребителя, и стёртый
+ * запрос вернул бы урезанное меню.
+ */
+declare function filterSideMenuItems(items: ReadonlyArray<IRtSideMenu.Item>, query: string): IRtSideMenu.Item[];
+/**
+ * Папки отобранного списка — те, что должны стоять раскрытыми. Возвращаются номера, а не пункты:
+ * отобранный список пересобирается на каждую букву запроса, и ссылка на пункт этого не переживает.
+ */
+declare function sideMenuIdsToExpand(items: ReadonlyArray<IRtSideMenu.Item>): Array<string | number>;
+/**
+ * Пределы ширины подменю в пикселях. Уже нижнего не помещается ни одна подпись пункта, шире
+ * верхнего подменю закрывает содержимое страницы.
+ */
+declare const RT_SIDE_MENU_WIDTH_MIN: number;
+declare const RT_SIDE_MENU_WIDTH_MAX: number;
+/** Шаг ширины с клавиатуры: стрелку держат нажатой, и крупный шаг проскакивал бы подпись целиком. */
+declare const RT_SIDE_MENU_WIDTH_STEP: number;
+/** Приведение ширины к пределам. */
+declare function clampSideMenuWidth(width: number): number;
+/**
+ * Резка подписи на совпавшие и несовпавшие куски.
+ *
+ * Отмечаются все вхождения: отмеченное одно первое читается как «второго нет». Сравнение без учёта
+ * регистра, а куски режутся из оригинала — приведение к нижнему регистру переписало бы названия.
+ */
+declare function splitSideMenuTitle(name: string, query: string): IRtSideMenu.TitlePart[];
+/**
+ * Пункты подменю в том порядке, в каком они стоят на экране. Внутрь папки список спускается, только
+ * если та раскрыта: ходьба стрелками идёт по видимому, а не по всему набору.
+ */
+declare function walkSideMenuItems(items: ReadonlyArray<IRtSideMenu.Item>, expandedIds: ReadonlyArray<string | number>): IRtSideMenu.Item[];
+/**
+ * Куда уходит подсветка на шаг стрелкой. Считается по номеру пункта: видимый список пересобирается
+ * на каждую букву запроса. Без подсветки вниз берёт первый пункт, вверх — последний. У краёв ходьба
+ * останавливается: заворот уводил бы взгляд через всю панель.
+ */
+declare function stepSideMenuHighlight(walk: ReadonlyArray<IRtSideMenu.Item>, highlightedId: string | number | null, step: number): string | number | null;
+/** Чем вешается слушатель. У кита это `Renderer2.listen`, у проверки — своя функция. */
+type TRtPointerListen = (target: HTMLElement, event: string, handler: (event: PointerEvent) => void) => () => void;
+/** Что тяга сообщает меню: новую ширину по ходу и конец — отпусканием или отнятием указателя. */
+interface IRtSubMenuWidthDragHooks {
+    readonly onWidth: (width: number) => void;
+    readonly onEnd: () => void;
+}
+/**
+ * Тяга ширины подменю указательными событиями: мышиных палец и перо не дают. Слушатели висят на
+ * ручке, а держит их захват указателя — слушатель на документе терял бы движение над чужим кадром.
+ * Указатель, отнятый средой, кончает тягу так же, как отпускание.
+ *
+ * Возвращает снятие слушателей. Пустое значение — тянуть нечем.
+ */
+declare function startSideMenuWidthDrag(event: PointerEvent, startWidth: number, listen: TRtPointerListen, hooks: IRtSubMenuWidthDragHooks): (() => void) | null;
+/**
+ * Ширина, которой панель нарисована. Панели нет или раскладка не посчитана — нижний предел: с нуля
+ * тяга уводила бы ширину в отрицательные числа.
+ */
+declare function drawnSideMenuWidth(panel: HTMLElement | null): number;
+/**
+ * Число, которое уходит наружу по концу тяги: большее из натянутого и нарисованного. Нижний предел
+ * держит оформление, и панель не бывает уже его, даже если рука ушла левее.
+ */
+declare function reportedSideMenuWidth(dragged: number, panel: HTMLElement | null): number;
+/**
+ * Новая ширина по нажатой клавише. Пустое значение — клавиша не о ширине, и умолчание не отменяется:
+ * иначе ручка съедала бы табуляцию. Влево значит уже при любом направлении письма: ручка стоит у
+ * правого края панели.
+ */
+declare function sideMenuWidthByKey(key: string, width: number): number | null;
+/**
+ * Что показывает закреплённое подменю: выбранный человеком раздел, а пока выбора нет — раздел
+ * активного адреса. Выбор впереди активности: иначе до соседнего раздела не добраться.
+ */
+declare function pinnedSideMenuItems(picked: IRtSideMenu.Item[] | null | undefined, activeIds: ReadonlyArray<string | number>, items: ReadonlyArray<IRtSideMenu.Item>): IRtSideMenu.Item[];
+
+/**
+ * Значок пункта по его `icon`: имя кита как есть, имя Material первого кита — его парой из перечня
+ * кита, как у `rt-menu-item`. `null` — кит такой значок не рисует: пункт берёт свой шаблон меню или
+ * стоит без значка.
+ */
+declare function sideMenuIconName(icon: string | undefined): IRtIcon.Name | null;
+/**
+ * Имена значков меню, о которых оно должно предупредить: ни имени кита, ни пары в перечне. И значок
+ * пункта, и значок кнопки строки закрывает свой шаблон меню.
+ * Без предупреждения такой значок пуст, и пропуск не заметен. Обходит пункты на любую глубину;
+ * каждое имя — один раз.
+ */
+declare function unpairedSideMenuIcons(items: ReadonlyArray<IRtSideMenu.Item>, hasOwnIcon: boolean): string[];
+
+/** Номер меню, которому приложение своего не задало. */
+declare const RT_SIDE_MENU_DEFAULT_ID: string;
+/**
+ * Номер меню, под которым лежат его настройки. Пустой — тот же, что не заданный: атрибут без
+ * значения даёт пустую строку, и настройки легли бы под ключ, которого никто не называл.
+ */
+declare function normalizeSideMenuId(menuId: string | null | undefined): string;
+/** Запись хранилища как есть: номер меню — и что под ним лежит, в том числе сломанное. */
+type TRtSideMenuSettingsRecord = Record<string, unknown>;
+/**
+ * Настройки одного меню из того, что лежит под его номером. Недопустимое поле читается как
+ * отсутствие значения, соседние поля остаются: сломанная ширина не стирает режим. Незнакомые поля
+ * не удаляются. Ширина приводится к пределам подменю, списки избранного — к номерам без повторов.
+ */
+declare function normalizeSideMenuSettings(value: unknown): IRtSideMenu.Settings;
+/** Запись хранилища как объект. Не JSON, не объект, пустое хранилище — одинаково пустая запись. */
+declare function parseSideMenuSettingsRecord(raw: string | null): TRtSideMenuSettingsRecord;
+/**
+ * Настройки всех меню из записи. Меню, чьё значение не объект, пропускается: сломанный угол одного
+ * меню не стирает соседние.
+ */
+declare function readSideMenuSettings(record: TRtSideMenuSettingsRecord): Record<string, IRtSideMenu.Settings>;
+/**
+ * Запись с правкой полей одного меню. Остальные меню и поля уходят такими, какими лежали, даже
+ * сломанные: кит правит только то, о чём его попросили.
+ */
+declare function patchSideMenuSettings(record: TRtSideMenuSettingsRecord, menuId: string, patch: Partial<IRtSideMenu.Settings>): TRtSideMenuSettingsRecord;
+/** Запись без настроек одного меню. */
+declare function omitSideMenuSettings(record: TRtSideMenuSettingsRecord, menuId: string): TRtSideMenuSettingsRecord;
+
+/** Значки кнопок строки избранного: «убрать» и ручка перетаскивания. */
+interface IRtSideMenuFavoritesIcons {
+    readonly remove: IRtIcon.Name;
+    readonly drag: IRtIcon.Name;
+}
+interface IRtSideMenuSettingsConfig {
+    /** Свой ключ хранилища, если приложению нужен не общий ключ кита. */
+    readonly storageKey?: string;
+    /** Свои значки кнопок избранного; не названный берётся из набора кита. */
+    readonly icons?: Partial<IRtSideMenuFavoritesIcons>;
+}
+declare const RT_SIDE_MENU_SETTINGS_CONFIG: InjectionToken<IRtSideMenuSettingsConfig>;
+/**
+ * Настройки боковых меню в хранилище браузера: режим и ширина подменю, избранное и свёрнутые блоки
+ * избранного под номером каждого меню.
+ *
+ * Перед каждой записью ключ читается заново: соседняя вкладка или приложение могли записать своё,
+ * и запись из копии затёрла бы их. Правится одно поле одного меню, остальное уходит как лежало.
+ * Изменения из других вкладок приходят событием `storage` и обновляют сигналы.
+ *
+ * Хранилище берётся токеном `@rt-tools/core` напрямую, а не общим сервисом хранилища: сервису
+ * нужно знать, что запись не удалась, и держать правду в памяти до перезагрузки. Без хранилища, вне
+ * браузера, закрытое или полное — настройки живут в памяти, и ни чтение, ни запись не бросают.
+ *
+ * Сервис ставится провайдером окружения — `provideRtSideMenuSettings()`, — а меню берёт его
+ * необязательно: не поставлен — меню ничего не хранит, режим и ширина приходят входами.
+ */
+declare class RtSideMenuSettingsService {
+    #private;
+    /** Значки кнопок избранного: из настроек провайдера, иначе из набора кита. */
+    readonly favoritesIcons: IRtSideMenuFavoritesIcons;
+    /** Номера меню, чьи настройки лежат в хранилище. */
+    readonly menuIds: Signal<string[]>;
+    constructor();
+    /** Настройки одного меню целиком, с незнакомыми полями; не сохранены — пустой объект. */
+    settings(menuId: string): Signal<IRtSideMenu.Settings>;
+    subMenuMode(menuId: string): Signal<IRtSideMenu.SubMenuMode>;
+    subMenuWidth(menuId: string): Signal<number | null>;
+    /** Избранное меню в порядке списка; пусто — пустой список. */
+    favoriteIds(menuId: string): Signal<ReadonlyArray<IRtSideMenu.FavoriteId>>;
+    /** Пункты полосы, чей блок избранного свёрнут; ничего не свёрнуто — пустой список. */
+    favoritesCollapsed(menuId: string): Signal<ReadonlyArray<IRtSideMenu.Item['id']>>;
+    /** Сворачивает или разворачивает блок одного раздела; остальные разделы остаются как были. */
+    setFavoritesCollapsed(menuId: string, sectionId: IRtSideMenu.Item['id'], collapsed: boolean): void;
+    /** Звезда: нет в списке — встаёт последним, есть — уходит. */
+    toggleFavorite(menuId: string, id: IRtSideMenu.FavoriteId): void;
+    removeFavorite(menuId: string, id: IRtSideMenu.FavoriteId): void;
+    /** Перенос строки блока: места в блоке, скрытые номера остаются на своих. */
+    moveVisibleSideMenuFavorite(menuId: string, visibleIds: ReadonlyArray<IRtSideMenu.FavoriteId>, from: number, to: number): void;
+    /** Список целиком: приложение заводит избранное само, например по умолчанию для роли. */
+    setFavorites(menuId: string, ids: ReadonlyArray<IRtSideMenu.FavoriteId>): void;
+    setSubMenuMode(menuId: string, mode: IRtSideMenu.SubMenuMode): void;
+    setSubMenuWidth(menuId: string, width: number): void;
+    /** Настройки меню уходят только по вызову приложения: кит сам ничего не удаляет. */
+    deleteSettings(menuId: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSideMenuSettingsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * Сервис настроек бокового меню для приложения.
+ *
+ * ```ts
+ * bootstrapApplication(App, { providers: [provideRtSideMenuSettings()] });
+ * ```
+ */
+declare function provideRtSideMenuSettings(config?: IRtSideMenuSettingsConfig): EnvironmentProviders;
+
+/**
+ * Строка подменю: пункт со ссылкой или папка со своими пунктами. Раскрытость, подсветку и запрос
+ * строка берёт у меню — своего состояния у неё нет.
+ *
+ * В разделе, где приложение включило избранное, у пункта со ссылкой стоит звезда; в строке блока
+ * избранного — кнопка «убрать» и слот `[rtSideMenuSubItemAction]`, куда блок кладёт ручку.
+ */
+declare class RtSideMenuSubItemComponent {
+    #private;
+    protected readonly menuRef: IRtSideMenuHost;
+    protected readonly narrow: Signal<boolean>;
+    /** Значки кнопок избранного: из настроек провайдера, иначе из набора кита. */
+    protected readonly favoritesIcons: RtSideMenuSettingsService['favoritesIcons'] | null;
+    protected readonly addLabel: Signal<string>;
+    protected readonly removeLabel: Signal<string>;
+    /** Избранное включено у раздела, чьё подменю показано, и приложение поставило настройки меню. */
+    protected readonly favoritesOn: Signal<boolean>;
+    protected readonly favoriteIds: Signal<ReadonlyArray<IRtSideMenu.FavoriteId>>;
+    readonly item: InputSignal<IRtSideMenu.Item>;
+    /** Строка стоит в блоке избранного: вместо звезды — «убрать», без номера и подсветки клавиатуры. */
+    readonly inFavorites: InputSignalWithTransform<boolean, unknown>;
+    readonly clickSubMenuAction: OutputEmitterRef<{
+        item: IRtSideMenu.Item;
+        event: MouseEvent;
+    }>;
+    readonly clickSubMenuAdditionalAction: OutputEmitterRef<{
+        data: IRtSideMenu.ItemData | undefined;
+        event: MouseEvent;
+    }>;
+    onClickSubMenu(item: IRtSideMenu.Item, event: MouseEvent): void;
+    /** Кнопка потребителя в строке: ни перехода по ссылке строки, ни закрытия подменю. */
+    onClickSubMenuAdditional(item: IRtSideMenu.Item, event: MouseEvent): void;
+    /** Звезда переключает избранное и больше ничего: ни перехода, ни закрытия подменю. */
+    onToggleFavorite(item: IRtSideMenu.Item, event: MouseEvent): void;
+    /**
+     * «Убрать» в строке блока. Фокус уходит на такую же кнопку соседней строки до того, как строка
+     * исчезнет: иначе он падал бы на страницу, и человек с клавиатуры терял бы место.
+     */
+    onRemoveFavorite(item: IRtSideMenu.Item, event: MouseEvent): void;
+    onToggleFolder(item: IRtSideMenu.Item): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSideMenuSubItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSideMenuSubItemComponent, "rt-side-menu-sub-item", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "inFavorites": { "alias": "inFavorites"; "required": false; "isSignal": true; }; }, { "clickSubMenuAction": "clickSubMenuAction"; "clickSubMenuAdditionalAction": "clickSubMenuAdditionalAction"; }, never, ["[rtSideMenuSubItemAction]"], true, never>;
+}
+
+export { IRtSideMenu, RT_SIDE_MENU_DEFAULT_ID, RT_SIDE_MENU_SETTINGS_CONFIG, RT_SIDE_MENU_WIDTH_MAX, RT_SIDE_MENU_WIDTH_MIN, RT_SIDE_MENU_WIDTH_STEP, RtSideMenuComponent, RtSideMenuFooterDirective, RtSideMenuHeaderDirective, RtSideMenuIconDirective, RtSideMenuSettingsService, RtSideMenuSubItemComponent, clampSideMenuWidth, drawnSideMenuWidth, filterSideMenuItems, normalizeSideMenuId, normalizeSideMenuSettings, omitSideMenuSettings, parseSideMenuSettingsRecord, patchSideMenuSettings, pinnedSideMenuItems, provideRtSideMenuSettings, readSideMenuSettings, reportedSideMenuWidth, sideMenuIconName, sideMenuIdsToExpand, sideMenuWidthByKey, splitSideMenuTitle, startSideMenuWidthDrag, stepSideMenuHighlight, unpairedSideMenuIcons, walkSideMenuItems };
+export type { IRtSideMenuFavoritesIcons, IRtSideMenuIconContext, IRtSideMenuSettingsConfig, IRtSubMenuWidthDragHooks, TRtPointerListen, TRtSideMenuSettingsRecord };

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

@@ -0,0 +1,32 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { InputSignal, InputSignalWithTransform } from '@angular/core';
+import { TRtRadius } from '@rt-tools/ui-kit-v2/core';
+import { TRtSkeletonShape, TRtSkeletonSize } from '@rt-tools/ui-kit-v2/skeleton';
+
+/**
+ * Conditional renderer: показывает `<rt-skeleton>` пока `[isLoading]="true"`,
+ * иначе проецирует `<ng-content>`. Основной use-case — обёртка вокруг текстовых
+ * значений и форм-полей в dialog'ах с async-данными.
+ *
+ * @example
+ * ```html
+ * <rt-skeleton-wrapper [isLoading]="!tour()" width="240px" height="16px">
+ *     {{ tour()?.title }}
+ * </rt-skeleton-wrapper>
+ * ```
+ */
+declare class RtSkeletonWrapperComponent {
+    readonly width: InputSignal<string>;
+    readonly height: InputSignal<string>;
+    readonly shape: InputSignal<TRtSkeletonShape>;
+    readonly size: InputSignal<TRtSkeletonSize>;
+    /** Шаг скругления заглушки, передаётся в `rt-skeleton`. Пусто — скругление заглушки по умолчанию. */
+    readonly radius: InputSignal<TRtRadius | null>;
+    readonly animation: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly isLoading: InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSkeletonWrapperComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSkeletonWrapperComponent, "rt-skeleton-wrapper", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { RtSkeletonWrapperComponent };

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

@@ -0,0 +1,41 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { InputSignal, InputSignalWithTransform } from '@angular/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+type TRtSkeletonShape = 'rectangle' | 'circle' | 'square';
+type TRtSkeletonSize = 'sm' | 'md' | 'lg';
+/**
+ * Visual primitive для loading-state'а: серая полоска с shimmer-анимацией.
+ *
+ * Не использовать напрямую — оборачивай реальный content в `<rt-skeleton-wrapper>`
+ * с input'ом `[isLoading]`. Wrapper решает что показать (skeleton или content),
+ * этот компонент только рисует placeholder.
+ *
+ * Скругление прямоугольника и квадрата — шаг общего входа `radius`; круг остаётся кругом.
+ *
+ * Shimmer через background-position keyframes; `@media (prefers-reduced-motion)`
+ * убирает анимацию для пользователей с reduced-motion preference.
+ */
+declare class RtSkeletonComponent {
+    #private;
+    readonly shape: InputSignal<TRtSkeletonShape>;
+    readonly size: InputSignal<TRtSkeletonSize>;
+    readonly width: InputSignal<string>;
+    readonly height: InputSignal<string>;
+    readonly animation: InputSignalWithTransform<boolean, BooleanInput>;
+    protected get isRectangle(): boolean;
+    protected get isCircle(): boolean;
+    protected get isSquare(): boolean;
+    protected get isSizeSm(): boolean;
+    protected get isSizeMd(): boolean;
+    protected get isSizeLg(): boolean;
+    protected get isAnimated(): boolean;
+    protected get hostWidth(): string;
+    protected get hostHeight(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSkeletonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSkeletonComponent, "rt-skeleton", never, { "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtSkeletonComponent };
+export type { TRtSkeletonShape, TRtSkeletonSize };

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

@@ -0,0 +1,56 @@
+import { NumberInput, BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, InputSignalWithTransform, InputSignal } from '@angular/core';
+
+/**
+ * Модель `<rt-spinner>`: один корневой неймспейс с префиксом `I`.
+ *
+ * `Color` — семантическая палитра spinner'а:
+ *  - `primary`   — синий основной (action accent), default
+ *  - `neutral`   — нейтральный серый (для тонких inline-loader'ов)
+ *  - `on-primary` — белый (для overlay поверх primary-фона)
+ *
+ * `Appearance` — вид кольца: `border` — кольцо с дорожкой, `arc` — дуга без дорожки, как в Material.
+ */
+declare namespace IRtSpinner {
+    type Color = 'primary' | 'neutral' | 'on-primary';
+    type Appearance = 'border' | 'arc';
+}
+
+/**
+ * Атомарный rotating-spinner для loading-индикаторов.
+ *
+ * Без новых режимов кольцо рисует сам host: border с одной цветной стороной и вращение, своей
+ * разметки нет. Так спиннер стоит у семи компонентов кита, и их разметка от режимов не меняется.
+ *
+ * Режимы `overlay`, `plate` и вид `arc` рисуют внутреннюю разметку, а host перестаёт быть кольцом:
+ * - `overlay` — спиннер занимает позиционированного родителя целиком и ставит кольцо в центр;
+ *   слой — ступень `sticky`, ниже всего, что открывается поверх страницы;
+ * - `backdrop` — полупрозрачная подложка оверлея, без `overlay` не действует;
+ * - `plate` — круглая плашка с тенью под кольцом;
+ * - `appearance="arc"` — дуга без дорожки, как у Material.
+ *
+ * Анимация уважает `@media (prefers-reduced-motion)` — вращение замедляется.
+ */
+declare class RtSpinnerComponent {
+    /** Кольцо рисуется внутренней разметкой, а не самим host-ом. */
+    protected readonly framed: Signal<boolean>;
+    protected readonly modifiers: Signal<Record<string, boolean>>;
+    protected readonly cssDiameter: Signal<string>;
+    /** Диаметр spinner'а в px. Default 32. */
+    readonly diameter: InputSignalWithTransform<number, NumberInput>;
+    /** Семантическая палитра. Default `primary`. */
+    readonly color: InputSignal<IRtSpinner.Color>;
+    /** Вид кольца: `border` — с дорожкой, `arc` — дуга без дорожки. Default `border`. */
+    readonly appearance: InputSignal<IRtSpinner.Appearance>;
+    /** Спиннер накрывает позиционированного родителя и стоит в его центре. Default `false`. */
+    readonly overlay: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Полупрозрачная подложка оверлея; без `overlay` не действует. Default `false`. */
+    readonly backdrop: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Круглая плашка с тенью под кольцом. Default `false`. */
+    readonly plate: InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSpinnerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSpinnerComponent, "rt-spinner", never, { "diameter": { "alias": "diameter"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "backdrop": { "alias": "backdrop"; "required": false; "isSignal": true; }; "plate": { "alias": "plate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { IRtSpinner, RtSpinnerComponent };