@rt-tools/ui-kit-v2 0.29.1 → 0.30.0

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

@@ -1,37 +1,25 @@
 import * as i0 from "@angular/core";
 import { ElementRef, InputSignal, InputSignalWithTransform, OutputEmitterRef, Signal, TemplateRef, WritableSignal } from "@angular/core";
-import { IRtIcon, IRtInput, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
+import { IRtIcon, IRtInput, IRtOptionTree, RtOptionList, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
 import { RtFormControlBase } from "@rt-tools/ui-kit-v2/form-control";
 import { IRtPopover, RtPopoverDirective } from "@rt-tools/ui-kit-v2/popover";
 import * as i1 from "@rt-tools/ui-kit-v2/radius";
 /**
  * Модель `<rt-select>`: один корневой неймспейс с префиксом `I`.
  * Generic-параметр `TValue` повторяет тип значения, который сидит в опциях.
+ *
+ * Опция и строка дерева объявлены в ядре: их раскладывают и деревья кита, а те не берут выбор из
+ * списка. Здесь — те же типы под прежними именами.
  */
 export declare namespace IRtSelect {
   /** Одна опция dropdown'а. */
-  interface Option<TValue> {
-    label: string;
-    value: TValue;
-    disabled?: boolean;
-    /** Дети опции того же вида. Хотя бы одна опция с детьми делает список деревом. */
-    children?: ReadonlyArray<Option<TValue>>;
-  }
+  type Option<TValue> = IRtOptionTree.Option<TValue>;
   /** Видимая строка дерева: опция, её уровень и то, ветка ли она и раскрыта ли. */
-  interface Row<TValue> {
-    readonly option: Option<TValue>;
-    readonly level: number;
-    readonly branch: boolean;
-    readonly open: boolean;
-    readonly parent: TValue | null;
-  }
+  type Row<TValue> = IRtOptionTree.Row<TValue>;
   /** Сколько включённых листьев ветки выбрано: все, часть или ни одного. */
-  type TBranchState = 'all' | 'some' | 'none';
+  type TBranchState = IRtOptionTree.TBranchState;
   /** Что делать по боковой стрелке: какую ветку переключить и куда увести подсветку. */
-  interface SideKeyAnswer<TValue> {
-    readonly toggle: TValue | null;
-    readonly index: number;
-  }
+  type SideKeyAnswer<TValue> = IRtOptionTree.SideKeyAnswer<TValue>;
   /**
    * Что кит отдаёт своей разметке указателя. Три значения и не больше: большее привязало бы
    * разметку потребителя к устройству семьи, и семью стало бы не поправить, не сломав её.
@@ -75,6 +63,7 @@ export declare class RtSelectTriggerDirective<TValue = unknown> {
   static ɵfac: i0.ɵɵFactoryDeclaration<RtSelectTriggerDirective<any>, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<RtSelectTriggerDirective<any>, "[rtSelectTrigger]", never, {}, {}, never, never, true, never>;
 }
+/** Клавиши, открывающие закрытый dropdown с фокуса на trigger'е. */
 type TBooleanInput = boolean | string;
 /**
  * Single-select dropdown с опциональным filter input.
@@ -96,10 +85,12 @@ export declare class RtSelectComponent<TValue> extends RtFormControlBase<TValue
   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>;
+  /** Клавиатура списка: подсветка, клавиши открытия, id для `aria-activedescendant`, прокрутка к опции. */
+  protected readonly optionList: RtOptionList;
+  protected readonly activeIndex: WritableSignal<number>;
   /** Идентификатор подсвеченной опции — тот же, что уходит в `aria-activedescendant`. */
   protected readonly activeOptionId: Signal<string | null>;
   /**
@@ -140,7 +131,6 @@ export declare class RtSelectComponent<TValue> extends RtFormControlBase<TValue
    */
   readonly panelMaxHeight: InputSignal<string | null>;
   readonly selectionChange: OutputEmitterRef<TValue | null>;
-  constructor();
   setDisabledState(disabled: boolean): void;
   protected getEmptyValue(): TValue | null;
   protected focusAfterClear(): void;
@@ -209,56 +199,4 @@ export declare class RtSelectComponent<TValue> extends RtFormControlBase<TValue
     outputs: {};
   }]>;
 }
-/**
- * Держит подсвеченную клавишами опцию в видимой части панели.
- *
- * Панель списка ограничена по высоте, и длинный список прокручивается внутри неё. Клавиши двигают
- * подсветку, но фокус остаётся на поле: браузер сам панель не прокручивает, и подсветка уходила
- * за нижний край — человек выбирал Enter'ом то, чего не видел. После каждой отрисовки, в которой
- * сменилась подсвеченная опция, она прокручивается ровно настолько, чтобы встать в панель.
- *
- * Панель рисуется в наложении, вне поддерева семьи, поэтому опция ищется в документе по своему
- * идентификатору — тому же, что стоит в `aria-activedescendant`. На сервере отрисовки нет, и
- * эффект не выполняется; среда без `scrollIntoView` пропускается.
- *
- * Зовётся в контексте внедрения — полем или конструктором семьи.
- *
- * @param activeOptionId идентификатор подсвеченной опции; `null` — подсветки нет или панель закрыта
- */
-export declare function rtScrollActiveOptionIntoView(activeOptionId: () => string | null): void;
-/**
- * Дерево опций выбора из списка — общее для `rt-select` и `rt-multiselect`.
- *
- * Обе семьи раскладывают, ищут и считают дерево одинаково, поэтому это чистые функции в одном
- * месте: две копии разошлись бы на первой правке. Состояние — какие ветки раскрыты — живёт в семье,
- * здесь только расчёт по нему.
- */
-type TOption<TValue> = IRtSelect.Option<TValue>;
-type TRow<TValue> = IRtSelect.Row<TValue>;
-/** Список — дерево, если хоть у одной опции есть дети. Плоский список рисуется как прежде. */
-export declare function rtTreeIsTree<TValue>(options: ReadonlyArray<TOption<TValue>>): boolean;
-/** Опция по значению на любой глубине. */
-export declare function rtTreeFind<TValue>(options: ReadonlyArray<TOption<TValue>>, value: TValue): TOption<TValue> | undefined;
-/**
- * Включённые листья под опцией; у самого листа — он сам. Отключённая ветка не отдаёт никого: её
- * листья выбрать нельзя, как и её саму.
- */
-export declare function rtTreeLeaves<TValue>(option: TOption<TValue>): ReadonlyArray<TValue>;
-/** Сколько включённых листьев ветки выбрано. Флажок ветки выводится из этого, а не хранится. */
-export declare function rtTreeBranchState<TValue>(option: TOption<TValue>, chosen: ReadonlyArray<TValue>): IRtSelect.TBranchState;
-/** Ветки, под которыми лежит выбранное значение: они раскрыты, когда список открывается. */
-export declare function rtTreeOpenFor<TValue>(options: ReadonlyArray<TOption<TValue>>, chosen: ReadonlyArray<TValue>): ReadonlySet<TValue>;
-/**
- * Видимые строки по уровням. Без поискового слова раскрыты ветки из `open`. Со словом строка
- * остаётся, если совпала она сама или кто-то под ней, и путь к совпадению показан раскрытым.
- * Ветка, совпавшая сама, держит детей такими, какими они были.
- */
-export declare function rtTreeRows<TValue>(options: ReadonlyArray<TOption<TValue>>, open: ReadonlySet<TValue>, rawTerm?: string): ReadonlyArray<TRow<TValue>>;
-/**
- * Ответ на боковую стрелку. Вправо: свёрнутая ветка раскрывается, раскрытая уводит подсветку на
- * первого ребёнка. Влево: раскрытая ветка сворачивается, иначе подсветка уходит на родителя.
- */
-export declare function rtTreeSideKey<TValue>(rows: ReadonlyArray<TRow<TValue>>, index: number, key: string): IRtSelect.SideKeyAnswer<TValue>;
-/** Набор раскрытых веток с переключённой одной. */
-export declare function rtTreeToggle<TValue>(open: ReadonlySet<TValue>, value: TValue): ReadonlySet<TValue>;
 export {};

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

@@ -1,7 +1,7 @@
 import * as i0 from "@angular/core";
 import { ElementRef, EnvironmentProviders, InjectionToken, InputSignal, InputSignalWithTransform, OutputEmitterRef, Signal, TemplateRef, WritableSignal } from "@angular/core";
 import { FormControl } from "@angular/forms";
-import { IRtIcon, IRtInput } from "@rt-tools/ui-kit-v2/core";
+import { IRtIcon, IRtInput, IRtMatchPart } from "@rt-tools/ui-kit-v2/core";
 /**
  * Входы вида бокового меню: подписи и заливка значков, поле поиска, подсказка прокрутки панели. Ни
  * один не меняет поведения — по ним приложение даёт меню вид первого кита, а без них меню рисуется
@@ -113,11 +113,8 @@ export declare namespace IRtSideMenu {
       data?: ItemData;
     };
   }
-  /** Кусок подписи: отмеченный — тот, которым она совпала с запросом. */
-  interface TitlePart {
-    text: string;
-    matched: boolean;
-  }
+  /** Кусок подписи: отмеченный — тот, которым она совпала с запросом. Объявлен в ядре. */
+  type TitlePart = IRtMatchPart;
 }
 /** Шапка бокового меню: над полосой пунктов. */
 export declare class RtSideMenuHeaderDirective {
@@ -368,12 +365,12 @@ export declare class RtSideMenuComponent extends RtSideMenuLookBase implements I
   }, ["headerTpl", "footerTpl", "ownIconTpl"], never, true, never>;
 }
 /**
- * Отбор пунктов подменю по подстроке подписи.
+ * Отбор пунктов подменю по подписи — правилом поиска кита: каждое слово запроса в любом порядке.
  *
  * Отбор спускается внутрь папок на любую глубину: потребитель кладёт в папки то, что человек и ищет
  * по имени, и по одному верхнему уровню такой пункт не нашёлся бы.
  *
- * В выдаче стоят только строки, содержащие запрос. Папка остаётся путём к совпавшим детям, а её
+ * В выдаче стоят только строки, совпавшие с запросом. Папка остаётся путём к совпавшим детям, а её
  * состав отбирается тем же правилом: иначе одно совпадение по имени папки вытаскивало бы весь её
  * состав. Папка, совпавшая только по имени, остаётся одной строкой без детей.
  *
@@ -396,18 +393,6 @@ export declare const RT_SIDE_MENU_WIDTH_MAX: number;
 export declare const RT_SIDE_MENU_WIDTH_STEP: number;
 /** Приведение ширины к пределам. */
 export declare function clampSideMenuWidth(width: number): number;
-/**
- * Резка подписи на совпавшие и несовпавшие куски.
- *
- * Отмечаются все вхождения: отмеченное одно первое читается как «второго нет». Сравнение без учёта
- * регистра, а куски режутся из оригинала — приведение к нижнему регистру переписало бы названия.
- */
-export declare function splitSideMenuTitle(name: string, query: string): IRtSideMenu.TitlePart[];
-/**
- * Резка подписи по каждому слову запроса. Приложение делит поиск по пробелам и ищет каждое слово
- * отдельно, поэтому и отмечено каждое. Слово внутри уже отмеченного куска не режет его второй раз.
- */
-export declare function splitTitleByWords(name: string, query: string): IRtSideMenu.TitlePart[];
 /**
  * Пункты подменю в том порядке, в каком они стоят на экране. Внутрь папки список спускается, только
  * если та раскрыта: ходьба стрелками идёт по видимому, а не по всему набору.

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

@@ -1,8 +1,7 @@
 import { BooleanInput } from "@angular/cdk/coercion";
 import * as i0 from "@angular/core";
 import { ElementRef, InputSignal, InputSignalWithTransform, OnDestroy, OutputEmitterRef, Signal, WritableSignal } from "@angular/core";
-import { IRtIcon, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
-import { IRtSideMenu } from "@rt-tools/ui-kit-v2/side-menu";
+import { IRtIcon, IRtMatchPart, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
 import * as i1 from "@rt-tools/ui-kit-v2/radius";
 /**
  * Контракты `rt-tag` — status pill компонент.
@@ -41,7 +40,7 @@ export declare class RtTagComponent implements OnDestroy {
   /** Размер значка ведёт ступень пилюли: свой вход у него был бы вторым числом об одном. */
   protected readonly iconSize: Signal<IRtIcon.Size>;
   /** Подпись, разрезанная по словам `highlight`: без них — один кусок целиком. */
-  protected readonly parts: Signal<ReadonlyArray<IRtSideMenu.TitlePart>>;
+  protected readonly parts: Signal<ReadonlyArray<IRtMatchPart>>;
   readonly value: InputSignal<string>;
   /**
    * Слова поиска, найденные куски которых метка отмечает: приложение, что ищет и по меткам,

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

@@ -240,8 +240,6 @@ export declare class RtTreeSelectorComponent<TValue> {
   }, ["controlsTpl", "underSearchTpl", "nodeEnd", "nodeMeta"], never, true, never>;
 }
 type TNode<TValue> = IRtTree.Node<TValue>;
-/** Слова строки поиска в нижнем регистре, без пустых. */
-export declare function rtTreeSelectorWords(term: string): ReadonlyArray<string>;
 /**
  * Узлы, в которых нашлось каждое слово поиска — в подписи, описании или метках. Совпавшая ветка
  * остаётся со всем поддеревом: без детей она выглядела бы листом. Несовпавшая ветка остаётся путём к

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

@@ -1,8 +1,6 @@
 import * as i0 from "@angular/core";
 import { InputSignal, InputSignalWithTransform, ModelSignal, OutputEmitterRef, Signal, TemplateRef } from "@angular/core";
-import { IRtIcon, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
-import { IRtSelect } from "@rt-tools/ui-kit-v2/select";
-import { IRtSideMenu } from "@rt-tools/ui-kit-v2/side-menu";
+import { IRtIcon, IRtMatchPart, IRtOptionTree, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
 import { IRtTag } from "@rt-tools/ui-kit-v2/tag";
 /**
  * Модель `<rt-tree>`: один корневой неймспейс с префиксом `I`. Узел повторяет опцию выбора из
@@ -10,7 +8,7 @@ import { IRtTag } from "@rt-tools/ui-kit-v2/tag";
  */
 export declare namespace IRtTree {
   /** Узел дерева: опция выбора из списка с необязательным описанием и детьми того же вида. */
-  interface Node<TValue> extends IRtSelect.Option<TValue> {
+  interface Node<TValue> extends IRtOptionTree.Option<TValue> {
     /** Вторая строка под подписью. */
     description?: string;
     /** Метки под подписью: поиск отмечает в них найденное так же, как в подписи. */
@@ -28,16 +26,16 @@ export declare namespace IRtTree {
    */
   type Mode = 'multiple' | 'single' | 'none';
   /** Отметка строки: выбрано всё, часть или ничего. У листа части не бывает. */
-  type Mark = IRtSelect.TBranchState;
+  type Mark = IRtOptionTree.TBranchState;
   /** Видимая строка дерева: та же, что у выбора из списка, с узлом дерева внутри. */
-  interface Row<TValue> extends IRtSelect.Row<TValue> {
+  interface Row<TValue> extends IRtOptionTree.Row<TValue> {
     readonly option: Node<TValue>;
   }
   /** Подпись и описание строки, разрезанные по найденному слову. */
   interface LabelParts {
-    readonly label: ReadonlyArray<IRtSideMenu.TitlePart>;
-    readonly description: ReadonlyArray<IRtSideMenu.TitlePart>;
-    readonly badges: ReadonlyArray<ReadonlyArray<IRtSideMenu.TitlePart>>;
+    readonly label: ReadonlyArray<IRtMatchPart>;
+    readonly description: ReadonlyArray<IRtMatchPart>;
+    readonly badges: ReadonlyArray<ReadonlyArray<IRtMatchPart>>;
   }
   /** Отметка строки, радио ли она и сколько выбрано под группой; `null` — числа нет. */
   interface RowState {

package/src/styles/_place.scss

@@ -1,7 +0,0 @@
-/* Корень документа — запасное место страницы. Компонент кита считает пороги от ближайшего
-   места по имени: внутри `rt-container` от его ширины, вне его от корня, а ширина корня равна
-   окну. Так потребитель без контейнера видит пороги окна, как раньше. Объявление стоит вне
-   слоя, как и свойства на корне: потребитель перебивает его порядком. */
-:root {
-    container: rt-place / inline-size;
-}