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

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

@@ -1,5 +1,6 @@
+import { BooleanInput } from "@angular/cdk/coercion";
 import * as i0 from "@angular/core";
-import { InputSignal, Signal } from "@angular/core";
+import { InputSignal, InputSignalWithTransform, Signal } from "@angular/core";
 import { IRtIcon, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
 /**
  * Контракты `rt-stat-tile` — KPI-плитка с базой сравнения.
@@ -9,16 +10,23 @@ import { IRtIcon, TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
 export declare namespace IRtStatTile {
   /** Направление изменения — определяет цвет и иконку строки дельты. */
   type Direction = 'up' | 'down' | 'flat' | 'unknown';
+  /**
+   * Единица изменения: проценты к базе или процентные пункты — разница двух
+   * долей (занятость с 68 % до 78 % выросла на 10 п.п., а не на 15 %).
+   */
+  type Unit = 'percent' | 'points';
   /**
    * Изменение к одной базе сравнения.
    *
-   * - `percent` — уже посчитанное изменение в процентах; `null` означает
-   *   «база нулевая или данных нет», и плитка рисует «—», а не «+100 %».
+   * - `percent` — уже посчитанное изменение в единицах `unit`; `null` означает
+   *   «база нулевая или данных нет», и строка не рисуется вовсе.
+   * - `unit` — единица числа, по умолчанию проценты.
    * - `label` — подпись базы («к прошлому периоду», «к прошлому году»).
    * - `baseline` — необязательное «было X» той же строкой.
    */
   interface Delta {
     readonly percent: number | null;
+    readonly unit?: Unit;
     readonly label: string;
     readonly baseline?: string;
   }
@@ -40,17 +48,22 @@ interface IDeltaRow {
  * готовыми строками, `percent` — посчитанным числом. Так плитка не знает ни про
  * валюты, ни про методику метрик и остаётся общей для любого домена.
  *
- * Нулевая база показывается как «—»: «+100 %» от нуля вводит в заблуждение, а
- * «∞» нечитаемо.
+ * Строка с неизвестной базой не рисуется: «+100 %» от нуля вводит в
+ * заблуждение, а «—» рядом с цифрой читается как поломка.
+ *
+ * Цвет строки говорит, хорошо изменение или плохо, а стрелка — только знак
+ * числа: у метрики, где рост хуже (отмены, потерянная выручка), рост красный и
+ * со стрелкой вверх.
  */
 export declare class RtStatTileComponent {
   #private;
+  /** Подписи кита для шаблона — приставка годового чипа. */
+  protected readonly t: Signal<TRtKitLabelMap>;
   /**
    * Дельта к предыдущему периоду — рядом со значением. Пустая база (`percent`
    * = null) не рисуется вовсе: «—» рядом с цифрой читается как поломка, а не
    * как «сравнивать не с чем».
    */
-  protected readonly t: Signal<TRtKitLabelMap>;
   protected readonly primaryDelta: Signal<IDeltaRow | null>;
   /** Годовое сравнение — отдельным компактным чипом, без слов в строке. */
   protected readonly yearDelta: Signal<IDeltaRow | null>;
@@ -72,6 +85,11 @@ export declare class RtStatTileComponent {
   readonly deltaSecondary: InputSignal<IRtStatTile.Delta | null>;
   /** Пояснение методики — нативный title на иконке подсказки. */
   readonly hint: InputSignal<string | null>;
+  /**
+   * Рост метрики плох для владельца (отмены, потерянная выручка): рост обеих
+   * строк красный, падение зелёное. Стрелка по-прежнему показывает знак числа.
+   */
+  readonly growthIsWorse: InputSignalWithTransform<boolean, BooleanInput>;
   static ɵfac: i0.ɵɵFactoryDeclaration<RtStatTileComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<RtStatTileComponent, "rt-stat-tile", never, {
     "label": {
@@ -104,6 +122,11 @@ export declare class RtStatTileComponent {
       "required": false;
       "isSignal": true;
     };
+    "growthIsWorse": {
+      "alias": "growthIsWorse";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 export {};

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

@@ -405,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`).
  *
@@ -428,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. */