@rt-tools/ui-kit-v2 0.39.0 → 0.39.1

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

@@ -0,0 +1,76 @@
+import { IFilterModel, ISortModel, TFilterOperatorType, TListSortOrderType, TNullable } from "@rt-tools/utils";
+/** Значение условия в том виде, в каком оно хранится и сверяется. Одно для обеих таблиц. */
+export type TRtFilterValue = string | number | boolean;
+/**
+ * Какие значения поля снимают условие колонки.
+ *
+ * `empty-string` — только пустая строка; `0` и `false` остаются значениями, так ведёт себя `rt-table`.
+ * `falsy` — любое ложное значение, как в первом ките; так ведёт себя `rt-data-table`.
+ */
+export type TRtFilterEmptyMode = 'empty-string' | 'falsy';
+/** Снимает ли это значение условие колонки при режиме таблицы. */
+export declare function rtIsEmptyFilterValue(value: unknown, mode: TRtFilterEmptyMode): boolean;
+/** Условие по этой колонке из набора либо `null`, когда колонка ничего не отбирает. */
+export declare function rtFilterOf<KEY extends string>(filters: ReadonlyArray<IFilterModel<KEY>>, propertyName: KEY): IFilterModel<KEY> | null;
+/**
+ * Набор условий после перемены значения по одной колонке.
+ *
+ * Пустое по режиму значение снимает колонку с отбора, а не уходит пустым условием: условие без
+ * значения просит потребителя ответить «подходит всё», и потребитель, прочитавший его буквально, не
+ * вернёт ни одной строки.
+ *
+ * Возвращает прежний набор тем же объектом, когда менять нечего: по этому признаку таблица и решает,
+ * сообщать ли наружу.
+ */
+export declare function rtFiltersWithValue<KEY extends string>(filters: ReadonlyArray<IFilterModel<KEY>>, propertyName: KEY, operatorType: TFilterOperatorType, value: TRtFilterValue, mode: TRtFilterEmptyMode): ReadonlyArray<IFilterModel<KEY>>;
+/**
+ * Набор условий после перемены вида сравнения по одной колонке.
+ *
+ * Колонка с условием меняет в нём вид сравнения. Колонка без условия, но с набранным значением,
+ * получает условие; без значения отбирать нечего, и набор не меняется — наружу ничего не уходит.
+ */
+export declare function rtFiltersWithOperator<KEY extends string>(filters: ReadonlyArray<IFilterModel<KEY>>, propertyName: KEY, operatorType: TFilterOperatorType, value: IFilterModel<KEY>['value'], mode: TRtFilterEmptyMode): ReadonlyArray<IFilterModel<KEY>>;
+/** Ключи записей списка. */
+export declare function rtKeysOf<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(entities: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): Array<ENTITY_TYPE[KEY]>;
+/** Записи страницы, добавленные к отмеченным; повторов не будет. */
+export declare function rtWithPageEntities<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Отмеченные без записей страницы. */
+export declare function rtWithoutPageEntities<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Отмеченные после отметки или снятия одной записи. */
+export declare function rtWithEntity<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, entity: ENTITY_TYPE, checked: boolean, keyExp: KEY): ENTITY_TYPE[];
+/** Хоть одна запись страницы отмечена. */
+export declare function rtAnyOnPage<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(page: ReadonlyArray<ENTITY_TYPE>, selectedKeys: ReadonlyArray<ENTITY_TYPE[KEY]>, keyExp: KEY): boolean;
+/** Отмечены все записи страницы; пустая страница у первого кита считается отмеченной целиком. */
+export declare function rtAllOnPage<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(page: ReadonlyArray<ENTITY_TYPE>, selectedKeys: ReadonlyArray<ENTITY_TYPE[KEY]>, keyExp: KEY): boolean;
+/** Записи первой страницы, чьи ключи названы приложением как отмеченные заранее. */
+export declare function rtPresetEntities<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(entities: ReadonlyArray<ENTITY_TYPE>, keys: ReadonlyArray<ENTITY_TYPE[KEY]>, keyExp: KEY): ENTITY_TYPE[];
+/** Отметки после смены страницы под «отметить все»: пришедшие строки отмечаются, кроме исключённых. */
+export declare function rtSelectedAfterPage<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, excluded: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Исключения после отметки или снятия одной записи под «отметить все». */
+export declare function rtExcludedAfterEntity<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(excluded: ReadonlyArray<ENTITY_TYPE>, entity: ENTITY_TYPE, checked: boolean, keyExp: KEY): ENTITY_TYPE[];
+/** Исключения после отметки всей страницы под «отметить все»: её записи уходят из исключений. */
+export declare function rtExcludedAfterPageMarked<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(excluded: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Исключения после снятия всей страницы под «отметить все»: её записи становятся исключениями. */
+export declare function rtExcludedAfterPageUnmarked<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(excluded: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Значение атрибута `aria-sort` шапки: направление либо его отсутствие. Одно для обеих таблиц. */
+export type TRtAriaSort = 'ascending' | 'descending' | 'none';
+/**
+ * Что просит нажатие на шапку после убывания.
+ *
+ * `clears` — порядок снимается: по возрастанию → по убыванию → без порядка, так ведёт себя `rt-table`.
+ * `repeats` — снова по возрастанию, как в первом ките; так ведёт себя `rt-data-table`.
+ */
+export type TRtSortCycle = 'clears' | 'repeats';
+/** Порядок стоит по этой колонке. */
+export declare function rtIsSortedBy(current: TNullable<ISortModel<string>>, propertyName: TNullable<string>): boolean;
+/** Направление порядка по этой колонке либо `null`, когда порядок стоит по другой или не стоит вовсе. */
+export declare function rtSortDirectionOf(current: TNullable<ISortModel<string>>, propertyName: string): TListSortOrderType | null;
+/**
+ * Следующий порядок после нажатия на шапку колонки.
+ *
+ * Оба круга смотрят на нажатую колонку: другая колонка встаёт по возрастанию, та, что идёт по
+ * возрастанию, — по убыванию. Круги расходятся только после убывания.
+ */
+export declare function rtNextSort(current: TNullable<ISortModel<string>>, propertyName: string, cycle: TRtSortCycle): ISortModel<string> | null;
+/** Значение `aria-sort` шапки: скринридер называет порядок колонки, а не только её имя. */
+export declare function rtAriaSortOf(current: TNullable<ISortModel<string>>, propertyName: string): TRtAriaSort;

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

@@ -4,6 +4,7 @@ import { InputSignal, InputSignalWithTransform, ModelSignal, OutputEmitterRef, P
 import { IRtIconButton } from "@rt-tools/ui-kit-v2/icon-button";
 import { IRtIcon, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
 import { IFilterModel, ISortModel, TFilterOperatorType, TListSortOrderType } from "@rt-tools/utils";
+import { TRtAriaSort, TRtFilterValue } from "@rt-tools/ui-kit-v2/table-core";
 import { CdkColumnDef, CdkTable, CdkTableDataSourceInput } from "@angular/cdk/table";
 import * as i1 from "@rt-tools/ui-kit-v2/radius";
 import { Observable } from "rxjs";
@@ -59,6 +60,11 @@ export declare class RtCopyCellComponent {
    * для hover.
    */
   readonly revealOnHover: InputSignalWithTransform<boolean, BooleanInput>;
+  /**
+   * Ячейка в рамке поля ввода: фон, рамка и радиус поля, значение кеглем поля, кнопка видна
+   * всегда. Так адрес для копирования стоит в форме панели, где строки таблицы для наведения нет.
+   */
+  readonly framed: InputSignalWithTransform<boolean, BooleanInput>;
   constructor();
   /**
    * Замер обрезки в момент наведения.
@@ -89,6 +95,11 @@ export declare class RtCopyCellComponent {
       "required": false;
       "isSignal": true;
     };
+    "framed": {
+      "alias": "framed";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, ["*"], true, never>;
 }
 export declare namespace IRtTable {
@@ -157,12 +168,11 @@ export declare namespace IRtTable {
   }
 }
 /** Значение атрибута `aria-sort` заголовка: направление либо его отсутствие. */
-export type TRtTableAriaSort = 'ascending' | 'descending' | 'none';
+export type TRtTableAriaSort = TRtAriaSort;
 /**
- * Следующее состояние сортировки при нажатии на заголовок колонки.
- *
- * Порядок кругов: по возрастанию → по убыванию → без сортировки. Третье состояние
- * нужно, чтобы пользователь мог вернуть исходный порядок, не перезагружая список.
+ * Следующее состояние сортировки при нажатии на заголовок колонки — по ядру таблиц, круг `clears`:
+ * по возрастанию → по убыванию → без сортировки. Третье состояние нужно, чтобы пользователь мог
+ * вернуть исходный порядок, не перезагружая список.
  */
 export declare function nextSort(current: ISortModel<string> | null, propertyName: string): ISortModel<string> | null;
 /** Направление сортировки по этой колонке либо `null`, когда сортирует другая. */
@@ -754,7 +764,7 @@ export declare class RtTableSettingsPanelComponent {
   }, never, never, true, never>;
 }
 /** Значение условия в том виде, в каком оно хранится и сверяется. */
-export type TRtTableFilterValue = string | number | boolean;
+export type TRtTableFilterValue = TRtFilterValue;
 /** Что приходит в ячейку от человека: дата приходит объектом, остальное — уже готовым значением. */
 export type TRtTableFilterInput = TRtTableFilterValue | Date | null | undefined;
 /**
@@ -768,21 +778,14 @@ export declare function filterValueOf(value: TRtTableFilterInput): TRtTableFilte
 /** Условие по этой колонке из набора либо `null`, когда колонка ничего не отбирает. */
 export declare function filterOf(filters: readonly IFilterModel<string>[], propertyName: string): IFilterModel<string> | null;
 /**
- * Набор условий после перемены значения по одной колонке.
- *
- * Пустое значение снимает колонку с отбора, а не уходит пустым условием: условие без значения
- * просит потребителя ответить «подходит всё», и потребитель, прочитавший его буквально, не
- * вернёт ни одной строки.
- *
- * Возвращает прежний набор тем же объектом, когда менять нечего: по этому признаку ячейка и
- * решает, сообщать ли наружу.
+ * Набор условий после перемены значения по одной колонке — по ядру таблиц в режиме `rt-table`.
+ * Возвращает прежний набор тем же объектом, когда менять нечего: по этому признаку ячейка и решает,
+ * сообщать ли наружу.
  */
 export declare function filtersWithValue(filters: readonly IFilterModel<string>[], propertyName: string, operatorType: TFilterOperatorType, value: TRtTableFilterValue): readonly IFilterModel<string>[];
 /**
- * Набор условий после перемены вида сравнения по одной колонке.
- *
- * Пока значения нет, менять вид сравнения не у чего: отбирать нечего, и набор условий не
- * изменился — значит, наружу ничего не уходит.
+ * Набор условий после перемены вида сравнения по одной колонке. Значение `rt-table` всегда лежит в
+ * условии, так что колонка без условия менять нечего и наружу ничего не уходит.
  */
 export declare function filtersWithOperator(filters: readonly IFilterModel<string>[], propertyName: string, operatorType: TFilterOperatorType): readonly IFilterModel<string>[];
 /** Вид сравнения, с которого колонка начинает: свой, первый разрешённый либо равенство. */

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

@@ -36,6 +36,11 @@ export declare namespace IRtTabs {
   type AnimationDuration = string | number | null;
   /** Сторона размещения header-контрола относительно полосы вкладок. */
   type ControlSide = 'left' | 'right';
+  /**
+   * Где стоит бейдж вкладки: `inline` — после подписи, как прежде; `overlay` — кружком над правым
+   * верхним углом иконки, не меняя ширины вкладки. У вкладки без иконки бейдж всегда `inline`.
+   */
+  type BadgePosition = 'inline' | 'overlay';
   /** Семантический цвет иконки/бейджа вкладки — маппится на палитру `rt-icon`. */
   type TitleColor = IRtIcon.Color;
 }
@@ -66,8 +71,15 @@ export declare class RtTabDirective {
   readonly glyph: InputSignal<string | null>;
   /** Семантический цвет иконки заголовка. */
   readonly iconColor: InputSignal<IRtTabs.TitleColor>;
+  /**
+   * Залитый рисунок иконки — уходит в `fill` у `rt-icon`. Значок Material заливается всегда, имя
+   * кита — в материальном наборе: в своём наборе у него один рисунок. Дефолт `false`.
+   */
+  readonly iconFill: InputSignalWithTransform<boolean, BooleanInput>;
   /** Значение бейджа справа от заголовка (число/строка). `null` — без бейджа. */
   readonly badge: InputSignal<string | number | null>;
+  /** Где стоит бейдж: после подписи или кружком над углом иконки. Дефолт `'inline'`. */
+  readonly badgePosition: InputSignal<IRtTabs.BadgePosition>;
   /**
    * Подсказка при наведении на бейдж. Подсказка самой кнопки занята неверной вкладкой,
    * поэтому у бейджа своя. Пусто — подсказки нет.
@@ -120,6 +132,10 @@ export declare class RtTabDirective {
    * Крестик — отдельная кнопка, и без имени диктор назвал бы её просто «кнопка».
    */
   readonly closeLabel: Signal<string>;
+  /** У вкладки есть иконка — по имени кита или по значку Material. */
+  readonly hasIcon: Signal<boolean>;
+  /** Бейдж стоит над иконкой: попросили `overlay`, бейдж есть и есть над чем стоять. */
+  readonly badgeOverlay: Signal<boolean>;
   /** Крестик рисуется только у доступной вкладки: отключённую закрыть нельзя. */
   readonly showClose: Signal<boolean>;
   static ɵfac: i0.ɵɵFactoryDeclaration<RtTabDirective, never>;
@@ -154,11 +170,21 @@ export declare class RtTabDirective {
       "required": false;
       "isSignal": true;
     };
+    "iconFill": {
+      "alias": "iconFill";
+      "required": false;
+      "isSignal": true;
+    };
     "badge": {
       "alias": "badge";
       "required": false;
       "isSignal": true;
     };
+    "badgePosition": {
+      "alias": "badgePosition";
+      "required": false;
+      "isSignal": true;
+    };
     "badgeTitle": {
       "alias": "badgeTitle";
       "required": false;