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

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

@@ -0,0 +1,72 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { RtPopoverDirective } from '@rt-tools/ui-kit-v2/popover';
+import { IButton } from '@rt-tools/ui-kit-v2/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Модель `rt-split-button`: один корневой неймспейс с префиксом `I`.
+ */
+declare namespace IRtSplitButton {
+    /** Пункт выпадающего меню второстепенных действий. */
+    interface MenuItem {
+        /** Машинный ключ — эмитится в `(itemSelect)` при выборе пункта. */
+        value: string;
+        /** Видимая подпись пункта. */
+        label: string;
+        /** Опциональная иконка слева от подписи. */
+        icon?: string;
+        /** Пункт заблокирован (не кликабелен). */
+        disabled?: boolean;
+    }
+    /** Палитра — подмножество темы `[rtButton]` (общий вид лица и каретки). */
+    type Theme = IButton.Theme;
+    /** Размер — как у `[rtButton]`. */
+    type Size = IButton.Size;
+}
+
+/**
+ * Кнопка с раздельным действием: основной CTA («лицо») + каретка, по клику на
+ * которую раскрывается меню второстепенных действий. Применяется, когда у
+ * сценария ДВА позитивных действия и нужно явно выделить главное, не пряча
+ * второстепенное (например, футер формы: лицо «Сохранить», в меню
+ * «Сохранить черновик»).
+ *
+ * Меню — поверх `[rtPopover]` (CDK Overlay): авто-flip у края, outside-click и
+ * Escape закрывают, не режется `overflow: hidden` предками (футер aside'а).
+ * Лицо и каретка — две `[rtButton]`, визуально сшитые в один контрол.
+ *
+ * `ViewEncapsulation.None` — стили префиксованы `.rt-split-button`.
+ */
+declare class RtSplitButtonComponent {
+    #private;
+    protected readonly menu: Signal<RtPopoverDirective | undefined>;
+    /** Своё имя каретки важнее умолчания: экран знает, что за действия в меню */
+    protected readonly menuAriaText: Signal<string>;
+    /** Подпись основного действия («лицо»). */
+    readonly label: InputSignal<string>;
+    /** Пункты выпадающего меню второстепенных действий. */
+    readonly menuItems: InputSignal<readonly IRtSplitButton.MenuItem[]>;
+    /** Семантическая палитра лица и каретки. */
+    readonly theme: InputSignal<IRtSplitButton.Theme>;
+    /** Размер контрола. */
+    readonly size: InputSignal<IRtSplitButton.Size>;
+    /** Доступное имя для каретки (icon-only кнопка открытия меню). */
+    readonly menuAriaLabel: InputSignal<string>;
+    /** Загрузка: спиннер на лице + блокировка обеих кнопок. */
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Нативное отключение обеих кнопок. */
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Клик по лицу (основное действие). */
+    readonly faceClick: OutputEmitterRef<void>;
+    /** Выбор пункта меню — эмитит `value` выбранного пункта. */
+    readonly itemSelect: OutputEmitterRef<string>;
+    protected onFace(): void;
+    protected onToggle(): void;
+    protected onItem(item: IRtSplitButton.MenuItem): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtSplitButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtSplitButtonComponent, "rt-split-button", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "menuItems": { "alias": "menuItems"; "required": true; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "menuAriaLabel": { "alias": "menuAriaLabel"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "faceClick": "faceClick"; "itemSelect": "itemSelect"; }, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { IRtSplitButton, RtSplitButtonComponent };

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

@@ -0,0 +1,81 @@
+import * as i0 from '@angular/core';
+import { Signal, InputSignal } from '@angular/core';
+import { TRtKitLabelMap, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Контракты `rt-stat-tile` — KPI-плитка с базой сравнения.
+ * Один корневой неймспейс с префиксом `I`, внутри литеральные union'ы,
+ * используемые как контракт `input()` сигналов компонента.
+ */
+declare namespace IRtStatTile {
+    /** Направление изменения — определяет цвет и иконку строки дельты. */
+    type Direction = 'up' | 'down' | 'flat' | 'unknown';
+    /**
+     * Изменение к одной базе сравнения.
+     *
+     * - `percent` — уже посчитанное изменение в процентах; `null` означает
+     *   «база нулевая или данных нет», и плитка рисует «—», а не «+100 %».
+     * - `label` — подпись базы («к прошлому периоду», «к прошлому году»).
+     * - `baseline` — необязательное «было X» той же строкой.
+     */
+    interface Delta {
+        readonly percent: number | null;
+        readonly label: string;
+        readonly baseline?: string;
+    }
+}
+
+/** Строка дельты в готовом к рендеру виде — вся ветвистость решена здесь. */
+interface IDeltaRow {
+    key: string;
+    label: string;
+    text: string;
+    baseline: string;
+    direction: IRtStatTile.Direction;
+    icon: IRtIcon.Name;
+}
+/**
+ * KPI-плитка: крупное значение, необязательная вторичная строка и до двух строк
+ * сравнения (к предыдущему периоду и к прошлому году).
+ *
+ * Компонент ничего не считает и не форматирует: `value` и `baseline` приходят
+ * готовыми строками, `percent` — посчитанным числом. Так плитка не знает ни про
+ * валюты, ни про методику метрик и остаётся общей для любого домена.
+ *
+ * Нулевая база показывается как «—»: «+100 %» от нуля вводит в заблуждение, а
+ * «∞» нечитаемо.
+ */
+declare class RtStatTileComponent {
+    #private;
+    /**
+     * Дельта к предыдущему периоду — рядом со значением. Пустая база (`percent`
+     * = null) не рисуется вовсе: «—» рядом с цифрой читается как поломка, а не
+     * как «сравнивать не с чем».
+     */
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly primaryDelta: Signal<IDeltaRow | null>;
+    /** Годовое сравнение — отдельным компактным чипом, без слов в строке. */
+    protected readonly yearDelta: Signal<IDeltaRow | null>;
+    /**
+     * База сравнения — короткой строкой «было X» и ничем больше: всё остальное
+     * (занятость, состав воронки) живёт во вторичной строке, иначе одна плитка
+     * растягивает ряд под самую длинную подпись.
+     */
+    protected readonly baselineText: Signal<string>;
+    /** Подпись метрики. */
+    readonly label: InputSignal<string>;
+    /** Уже отформатированное значение — плитка его не преобразует. */
+    readonly value: InputSignal<string>;
+    /** Вторичная строка под значением (занятость, доля оценки и т.п.). */
+    readonly secondary: InputSignal<string | null>;
+    /** Сравнение с предыдущим равным периодом. */
+    readonly deltaPrimary: InputSignal<IRtStatTile.Delta | null>;
+    /** Сравнение с тем же периодом год назад. */
+    readonly deltaSecondary: InputSignal<IRtStatTile.Delta | null>;
+    /** Пояснение методики — нативный title на иконке подсказки. */
+    readonly hint: InputSignal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtStatTileComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtStatTileComponent, "rt-stat-tile", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "secondary": { "alias": "secondary"; "required": false; "isSignal": true; }; "deltaPrimary": { "alias": "deltaPrimary"; "required": false; "isSignal": true; }; "deltaSecondary": { "alias": "deltaSecondary"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { IRtStatTile, RtStatTileComponent };

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

@@ -0,0 +1,51 @@
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, InputSignalWithTransform } from '@angular/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+declare namespace IRtStepper {
+    interface Step {
+        label: string;
+        description: string;
+    }
+}
+
+/**
+ * Линейный прогресс-степпер: тонкая полоса, набор точек и подпись
+ * текущего шага. Шаги задаются через input `steps` (массив `IRtStepper.Step`
+ * со связкой label + description), активный шаг — через `currentIndex`.
+ *
+ * Активная точка увеличена и подсвечивается янтарным; над ней висит подпись
+ * текущего шага (тоже янтарная, выравнивается по краю на крайних шагах).
+ * Пройденные точки и заполненная часть полосы — progress-цвет; будущие точки
+ * и трек — приглушённый цвет (в dark-теме оба ухода от яркого синего). Под
+ * полосой — описание текущего шага, многоабзацное (`\n\n`). Сам список названий
+ * шагов на ui не выводится — публичен только текущий, остальные читаются
+ * скринридером через aria.
+ */
+declare class RtStepperComponent {
+    #private;
+    protected readonly currentStep: Signal<IRtStepper.Step | null>;
+    /** Номер текущего шага для скринридера: `0`, когда шагов нет вовсе. */
+    protected readonly currentStepNumber: Signal<number>;
+    /**
+     * Доля заполненной полосы от 0 до 100. На один шаг и меньше — 0%, иначе
+     * `idx / (total - 1)`. Без clamp в шаблоне получаем переполнение если
+     * передадут `currentIndex > total`.
+     */
+    protected readonly progressPercent: Signal<number>;
+    protected readonly totalSteps: Signal<number>;
+    /**
+     * Якорь подписи текущего шага: подпись висит над активной точкой и не должна
+     * вылезать за края рельсы. Первый шаг — выравнивание по левому краю точки,
+     * последний — по правому, остальные центрируются над точкой.
+     */
+    protected readonly labelAnchor: Signal<'start' | 'center' | 'end'>;
+    /** Абзацы описания текущего шага: бэк отдаёт плоскую строку, делим по `\n\n`. */
+    protected readonly descriptionParagraphs: Signal<readonly string[]>;
+    readonly steps: InputSignal<readonly IRtStepper.Step[]>;
+    readonly currentIndex: InputSignalWithTransform<number, number | string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtStepperComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtStepperComponent, "rt-stepper", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "currentIndex": { "alias": "currentIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { IRtStepper, RtStepperComponent };