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

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`, когда сортирует другая. */
@@ -395,6 +405,35 @@ declare function hasRowsIn(dataSource: unknown): boolean;
  * её значение нечем.
  */
 declare function cardColumnsOf<TRow>(displayedColumns: ReadonlyArray<string>, columnDefs: ReadonlyArray<CdkColumnDef>, columnsConfig: ReadonlyArray<IRtTable.ColumnConfig>): ReadonlyArray<IRtTableCardColumn<TRow>>;
+/** С какой стороны под закреплённой колонкой лежит прокрученное содержимое. */
+interface IRtTablePinnedEdges {
+  /** Прокручено от начала: под колонкой, закреплённой у начала, есть скрытые колонки. */
+  start: boolean;
+  /** Прокручено не до конца: под колонкой, закреплённой у конца, есть скрытые колонки. */
+  end: boolean;
+}
+/**
+ * Скрытые края по положению прокрутки. При письме справа налево браузер отдаёт отрицательный
+ * сдвиг, поэтому берётся его величина: «начало» — сторона, откуда прокрутка началась.
+ */
+declare function hiddenEdges(scrollLeft: number, scrollWidth: number, clientWidth: number): IRtTablePinnedEdges;
+/**
+ * Ближайший предок, который прокручивается вбок. Таблица сама не прокручивается: её прокручивает
+ * контейнер потребителя, и тень у края зависит от его положения.
+ */
+declare function horizontalScrollParentOf(element: Element, view: Window): HTMLElement | null;
+/**
+ * Следит за прокруткой контейнера таблицы и за его размерами: тень у края нужна, пока под
+ * закреплённой колонкой есть скрытое содержимое, а оно меняется и при прокрутке, и при смене
+ * ширины окна или набора колонок.
+ */
+declare class RtTablePinnedEdges {
+  #private;
+  constructor(changed: (edges: IRtTablePinnedEdges) => void);
+  /** Находит контейнер прокрутки над `table` и сообщает скрытые края сразу и после каждой перемены. */
+  watch(table: HTMLElement, view: Window): void;
+  stop(): void;
+}
 /**
  * Таблица — стилизованная обёртка над `cdk-table` (`@angular/cdk/table`).
  *
@@ -418,6 +457,8 @@ export declare class RtTableComponent<TRow> extends CdkTable<TRow> {
    * остаются висеть вне таблицы. Считается один раз — тег хоста по ходу жизни не меняется.
    */
   protected readonly hostRole: 'table' | null;
+  /** Скрытые края для модификаторов хоста `--hidden-start` и `--hidden-end`. */
+  protected readonly hiddenEdges: Signal<IRtTablePinnedEdges>;
   /** `true` когда initial-load в полёте и entities ещё нет — рендерим skeleton rows. */
   protected readonly isInitialLoading: Signal<boolean>;
   /** `true` когда загрузка завершена и entities пустые — рендерим empty placeholder. */
@@ -754,7 +795,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 +809,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;