@rt-tools/ui-kit-v2 0.1.0 → 0.3.0

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

@@ -216,7 +216,7 @@ declare namespace IRtIcon {
     /** Допустимые имена иконок. Литеральный union из {@link iconsName}. */
     type Name = (typeof iconsName)[number];
     /** Доступные размеры. Маппинг на пиксели — в `rt-icon.component.ts`. */
-    type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
     /** Семантические цвета. Маппинг на CSS-переменные `--rt-icon-color-*` — в `rt-icon.component.ts`. */
     type Color = 'current' | 'muted' | 'info' | 'success' | 'warning' | 'danger' | 'inverse';
 }
@@ -490,7 +490,8 @@ declare namespace IRtInput {
  * - self-injected `NgControl` + ручная привязка `valueAccessor` (без
  *   `NG_VALUE_ACCESSOR` provider — иначе NG0200 cycle при self-reference),
  *   что даёт доступ к `control.invalid/touched` для авто-подсветки ошибки;
- * - сигнал значения `value`, состояния `isDisabled`/`isInvalid`;
+ * - сигнал значения `value`, состояния `isDisabled`/`isInvalid` (отключение
+ *   складывается из входа `disabled` и слова формы — см. `isDisabled`);
  * - общие инпуты `size`/`disabled`/`controlId`/`ariaLabel`/`clearable`;
  * - оркестрацию очистки (`clear`) через абстрактные хуки конкретного поля.
  *
@@ -501,7 +502,14 @@ declare namespace IRtInput {
 declare abstract class RtFormControlBase<TValue> implements ControlValueAccessor, OnInit {
     #private;
     protected readonly value: WritableSignal<TValue>;
-    protected readonly isDisabled: WritableSignal<boolean>;
+    /**
+     * Отключение: вход и форма — два независимых источника, поле отключено,
+     * если так сказал любой из них. Сводить их в один signal нельзя: форма
+     * зовёт `setDisabledState` при связывании контрола, то есть раньше, чем
+     * поле впервые обновит своё вью, и мирроринг входа затирал бы её слово —
+     * контрол, созданный отключённым, оказывался бы редактируемым.
+     */
+    protected readonly isDisabled: Signal<boolean>;
     protected readonly isInvalid: WritableSignal<boolean>;
     /** Видимость кнопки очистки: включена, есть значение, поле активно. */
     protected readonly showClearButton: Signal<boolean>;
@@ -751,8 +759,8 @@ declare namespace IButton {
     type Theme = 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
     /** Внешний вид: filled (заливка), outlined (контур), text (без фона). */
     type Appearance = 'filled' | 'outlined' | 'text';
-    /** Размер по высоте: sm — 30px, md — 40px (default), lg — 50px. */
-    type Size = 'sm' | 'md' | 'lg';
+    /** Размер по высоте: sm — 30px, md — 40px (default), lg — 50px, xl — 60px, 2xl — 70px. */
+    type Size = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
     /** Положение иконки относительно лейбла. */
     type IconPos = 'left' | 'right';
 }
@@ -1375,10 +1383,12 @@ declare function toRtMessage<TMessage extends IRtMappableMessage>(message: TMess
  * `useExisting: forwardRef(...)` — `useClass` на self-reference вызывает
  * NG0200 cycle при boot'е.
  *
- * Source-of-truth для disabled — внутренний `isDisabled` signal: и signal-input
- * `disabled`, и CVA `setDisabledState` пишут в один и тот же signal (input —
- * через `effect()`, CVA — напрямую), так `[disabled]="true"` и
- * `FormControl.disable()` ведут себя одинаково.
+ * Отключение складывается из двух независимых источников: входа `disabled` и
+ * слова формы (CVA `setDisabledState`). Отключено, если так сказал любой из
+ * них. Сводить их в один signal нельзя: форма зовёт `setDisabledState` при
+ * связывании контрола, то есть раньше, чем чекбокс впервые обновит своё вью,
+ * и мирроринг входа затирал бы её слово — контрол, созданный отключённым,
+ * оказывался бы кликабельным.
  *
  * `indeterminate` — чисто визуальное mixed-состояние; клик по нему разрешается
  * в `true` (стандартное поведение tri-state чекбокса).
@@ -1388,12 +1398,11 @@ declare function toRtMessage<TMessage extends IRtMappableMessage>(message: TMess
 declare class RtCheckboxComponent implements ControlValueAccessor {
     #private;
     protected readonly isChecked: WritableSignal<boolean>;
-    protected readonly isDisabled: WritableSignal<boolean>;
+    protected readonly isDisabled: Signal<boolean>;
     readonly inputId: InputSignal<string | null>;
     readonly ariaLabel: InputSignal<string | null>;
     readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
     readonly indeterminate: InputSignalWithTransform<boolean, BooleanInput>;
-    constructor();
     writeValue(value: boolean | null | undefined): void;
     registerOnChange(fn: (value: boolean) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -1916,19 +1925,22 @@ declare const rtAsideUnsavedGuard: CanDeactivateFn<IRtAsideDeactivate | null>;
  * `useExisting: forwardRef(...)` — `useClass` на self-reference вызывает
  * NG0200 cycle при boot'е.
  *
- * Source-of-truth для disabled — внутренний `isDisabled` signal: и signal-input
- * `disabled`, и CVA `setDisabledState` пишут в него, поэтому `[disabled]="true"`
- * и `FormControl.disable()` ведут себя одинаково.
+ * Отключение складывается из двух независимых источников: входа `disabled` и
+ * слова формы (CVA `setDisabledState`). Отключено, если так сказал любой из
+ * них. Сводить их в один signal нельзя: форма зовёт `setDisabledState` при
+ * связывании контрола, то есть раньше, чем счётчик впервые обновит своё вью,
+ * и мирроринг входа затирал бы её слово — контрол, созданный отключённым,
+ * оказывался бы рабочим.
  *
  * Хост объявлен группой с `aria-label`, значение помечено `aria-live`, так что
  * скринридер называет назначение счётчика и проговаривает новое число.
  *
- * ViewEncapsulation — default (Emulated), стили обёрнуты в `:host { ... }`.
+ * ViewEncapsulation.None — стили таргетируют имя элемента и BEM-класс блока.
  */
 declare class RtCounterComponent implements ControlValueAccessor {
     #private;
     protected readonly value: WritableSignal<number>;
-    protected readonly isDisabled: WritableSignal<boolean>;
+    protected readonly isDisabled: Signal<boolean>;
     /** Своя подпись важнее умолчания: форма знает, что именно считает */
     protected readonly decreaseAriaLabel: Signal<string>;
     protected readonly increaseAriaLabel: Signal<string>;
@@ -1944,7 +1956,6 @@ declare class RtCounterComponent implements ControlValueAccessor {
     readonly decreaseLabel: InputSignal<string>;
     readonly increaseLabel: InputSignal<string>;
     readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
-    constructor();
     writeValue(value: number | null | undefined): void;
     registerOnChange(fn: (value: number) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -1976,7 +1987,7 @@ declare const RT_COUNTER_INCREASE_KEY: string;
  * раскладку, и её не приходится расширять каждый раз, когда у `rt-counter`
  * появляется новый input.
  *
- * ViewEncapsulation — default (Emulated), стили обёрнуты в `:host { ... }`.
+ * ViewEncapsulation.None — стили таргетируют имя элемента и BEM-класс блока.
  */
 declare class RtCounterRowComponent {
     readonly label: InputSignal<string>;
@@ -2382,7 +2393,7 @@ declare namespace IRtIconButton {
     /** Семантическая палитра кнопки. */
     type Variant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'success' | 'warning';
     /** Размер квадрата кнопки. Маппинг на пиксели — в SCSS (`--rt-icon-button-size`). */
-    type Size = 'sm' | 'md' | 'lg';
+    type Size = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
     /** Форма границы кнопки. */
     type Shape = 'circle' | 'square';
     /** HTML-тип нативного `<button>`. */
@@ -3763,7 +3774,13 @@ declare class RtSkeletonComponent {
     readonly size: InputSignal<IRtSkeletonSize>;
     readonly width: InputSignal<string>;
     readonly height: InputSignal<string>;
-    readonly borderRadius: InputSignal<IRtSkeletonRadius>;
+    /**
+     * Скругление. `null` — «не задано»: прямоугольник берёт `xl`, квадрат —
+     * `sm` (пилюля из квадрата не квадрат). Умолчанием нельзя было держать сам
+     * `xl`: тогда явный `xl` неотличим от невыставленного, и квадрату
+     * приходилось прибивать `sm` жёстко — вход у него молча пропадал.
+     */
+    readonly borderRadius: InputSignal<IRtSkeletonRadius | null>;
     readonly animation: InputSignalWithTransform<boolean, BooleanInput>;
     protected get isRectangle(): boolean;
     protected get isCircle(): boolean;
@@ -3796,7 +3813,8 @@ declare class RtSkeletonWrapperComponent {
     readonly height: InputSignal<string>;
     readonly shape: InputSignal<IRtSkeletonShape>;
     readonly size: InputSignal<IRtSkeletonSize>;
-    readonly borderRadius: InputSignal<IRtSkeletonRadius>;
+    /** Как у `rt-skeleton`: `null` — «по фигуре», а не «без скругления». */
+    readonly borderRadius: InputSignal<IRtSkeletonRadius | null>;
     readonly animation: InputSignalWithTransform<boolean, BooleanInput>;
     readonly isLoading: InputSignalWithTransform<boolean, BooleanInput>;
     static ɵfac: i0.ɵɵFactoryDeclaration<RtSkeletonWrapperComponent, never>;
@@ -3999,7 +4017,10 @@ declare namespace IRtStepper {
  * скринридером через 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 в шаблоне получаем переполнение если
@@ -4739,7 +4760,6 @@ type IRtTextareaResize = 'none' | 'vertical';
  */
 declare class RtTextareaComponent extends RtFormControlBase<string> {
     protected readonly fieldEl: Signal<ElementRef<HTMLTextAreaElement> | undefined>;
-    protected readonly effectiveDisabled: Signal<boolean>;
     protected readonly hasValue: Signal<boolean>;
     readonly displayText: Signal<string>;
     readonly placeholder: InputSignal<string>;
@@ -5231,22 +5251,24 @@ declare namespace IRtToggleSwitch {
  * `useExisting: forwardRef(...)` — `useClass` на self-reference вызывает
  * NG0200 cycle при boot'е.
  *
- * Source-of-truth для disabled — внутренний `isDisabled` signal. И signal-input
- * `disabled`, и CVA `setDisabledState` пишут в один и тот же signal: input —
- * через `effect()`, CVA — напрямую через метод. Так `[disabled]="true"` и
- * `FormControl.disable()` ведут себя одинаково.
+ * Отключение складывается из двух независимых источников: входа `disabled` и
+ * слова формы (CVA `setDisabledState`). Отключено, если так сказал любой из
+ * них. Сводить их в один signal нельзя: форма зовёт `setDisabledState` при
+ * связывании контрола, то есть раньше, чем переключатель впервые обновит своё
+ * вью, и мирроринг входа затирал бы её слово — контрол, созданный отключённым,
+ * оказывался бы кликабельным.
  *
  * Опциональные иконки `iconOff` / `iconOn` рисуются внутри трека статично:
  * off-иконка в начальной половине, on-иконка в конечной. Бегунок непрозрачен
  * и наезжает на иконку активного состояния, так что видна всегда иконка того
  * состояния, куда переключится контрол.
  *
- * ViewEncapsulation — default (Emulated), стили обёрнуты в `:host { ... }`.
+ * ViewEncapsulation.None — стили таргетируют имя элемента и BEM-класс блока.
  */
 declare class RtToggleSwitchComponent implements ControlValueAccessor {
     #private;
     protected readonly isOn: WritableSignal<boolean>;
-    protected readonly isDisabled: WritableSignal<boolean>;
+    protected readonly isDisabled: Signal<boolean>;
     /**
      * BEM-модификаторы для `[rtMod]`. Собираем в .ts, потому что
      * Angular template-parser не поддерживает computed property keys
@@ -5262,7 +5284,6 @@ declare class RtToggleSwitchComponent implements ControlValueAccessor {
     /** Иконка включённого состояния — в конечной половине трека. Пусто — без иконки. */
     readonly iconOn: InputSignal<IRtIcon.Name | null>;
     readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
-    constructor();
     writeValue(value: boolean | null | undefined): void;
     registerOnChange(fn: (value: boolean) => void): void;
     registerOnTouched(fn: () => void): void;