@rt-tools/ui-kit 0.5.1 → 0.6.1

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@rt-tools/ui-kit",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "license": "Apache-2.0",
   "author": "Yauheni Krumin",
   "type": "module",
   "dependencies": {
     "tslib": "^2.8.0",
-    "@rt-tools/core": "^0.4.0",
+    "@rt-tools/core": "^0.5.0",
     "@rt-tools/store": "^0.3.2",
     "@rt-tools/utils": "^0.4.0"
   },
   "peerDependencies": {
-    "@rt-tools/core": "^0.4.0",
+    "@rt-tools/core": "^0.5.0",
     "@rt-tools/store": "^0.3.2",
     "@rt-tools/utils": "^0.4.0",
     "@angular/cdk": "^22.0.0",

package/src/lib/ui-kit/side-menu/menu/rtui-side-menu.component.scss

@@ -266,7 +266,12 @@ $side-menu: (
             // Component-local elevation token for the slide-out sub-menu drawer.
             --rt-side-menu-sub-content-shadow: 14px 0 28px rgb(0 0 0 / 25%), 10px 0 10px rgb(0 0 0 / 22%);
 
-            position: relative;
+            // Расположение шторки оставлено за Material: `absolute` с растяжкой по верху и низу, а
+            // место под боковую шторку оно освобождает отступом на содержимом контейнера. Стоявший
+            // здесь `relative` возвращал шторку в поток, она вставала над содержимым, и контейнер
+            // получал вдвое большую высоту прокрутки. Прокручивать его хватало одного
+            // `scrollIntoView` на активном пункте подменю: панель уезжала вверх на ширину рельсы и
+            // обратно не возвращалась.
             width: max(var(--rt-side-menu-sub-menu-width), var(--rt-side-menu-sub-menu-dragged-width, 0px));
             min-width: max(var(--rt-side-menu-sub-menu-width), var(--rt-side-menu-sub-menu-dragged-width, 0px));
             height: 100%;
@@ -317,10 +322,17 @@ $side-menu: (
         &--pinned {
             position: relative;
             left: 0;
-            width: var(--rt-side-menu-sub-menu-shown-width);
+            width: 0;
             height: 100%;
             flex: 0 0 auto;
 
+            // Ширину закреплённая панель занимает, только пока ей есть что показать. Ширина,
+            // поставленная одним лишь закреплением, оставляла пустую полосу слева от страницы на
+            // каждом адресе, у которого разделов нет: панели там не видно, а место она держала.
+            &.rtui-sub-side-menu--opened {
+                width: var(--rt-side-menu-sub-menu-shown-width);
+            }
+
             .rtui-sub-side-menu-content {
                 box-shadow: none;
 

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

@@ -10,9 +10,9 @@ import { OverlayRef, ComponentType, ConnectedPosition, CdkOverlayOrigin } from '
 import { ComponentType as ComponentType$1 } from '@angular/cdk/portal';
 import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
 import { MatButtonAppearance } from '@angular/material/button';
+import { MatFormFieldAppearance } from '@angular/material/form-field';
 import * as i1 from '@angular/material/tooltip';
 import { TooltipPosition } from '@angular/material/tooltip';
-import { MatFormFieldAppearance } from '@angular/material/form-field';
 import { MatSnackBarConfig, MatSnackBarRef } from '@angular/material/snack-bar';
 import { EPosition, OSTypes } from '@rt-tools/core';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
@@ -568,9 +568,33 @@ declare namespace IRtUiConfig {
         radius?: IRtuiButton.Radius;
         appearance?: IRtuiButton.Appearance;
     }
+    /** Per-instance-overridable defaults for the dynamic selectors family. */
+    interface DynamicSelectors {
+        /**
+         * Appearance every form field of the family renders with.
+         *
+         * The family nests: a selector holds an input, an input opens a popup, a popup holds a
+         * list. Set once here, the look reaches all of them; passed as an input, it has to be
+         * repeated at every use, and the one that was missed differs from the rest.
+         */
+        appearance?: MatFormFieldAppearance;
+    }
+    /** Per-instance-overridable defaults for the aside curtain. */
+    interface Aside {
+        /**
+         * Whether Esc closes an open curtain.
+         *
+         * The kit default is `false`: the key is pressed to lift a hint or to leave a field, and
+         * the whole panel closed together with what was entered. An application that needs the
+         * former behaviour names it here once instead of naming it at every call.
+         */
+        closeOnEscape?: boolean;
+    }
     /** Component-level settings. Each entry overrides `global` for that component only. */
     interface Components {
         button?: Button;
+        dynamicSelectors?: DynamicSelectors;
+        aside?: Aside;
     }
     interface Config {
         global?: Global;
@@ -1510,8 +1534,22 @@ declare abstract class RtuiDynamicSelectorsDirective {
     placeholderIcon: InputSignalWithTransform<string, string>;
     /** Placeholder description */
     placeholderDescription: InputSignalWithTransform<string, string>;
-    /** Material elements appearance */
-    appearance: InputSignal<MatFormFieldAppearance>;
+    /**
+     * Material elements appearance.
+     *
+     * Пустота умолчанием, а не прежнее значение: значение, оставленное умолчанием входа, побеждает
+     * настройку всегда — вход задан, и цепочка разрешения на нём кончается, а настройка не
+     * срабатывает ни разу и выглядит сломанной.
+     */
+    appearance: InputSignal<MatFormFieldAppearance | undefined>;
+    /**
+     * Вид поля, с которым семейство рисуется: вход на месте, потом раздел настройки, потом
+     * умолчание кита.
+     *
+     * Считается один раз здесь, а шаблоны читают готовое: повторённая в каждом из пяти шаблонов
+     * семейства, эта цепочка разъехалась бы с настройкой в первом же месте, куда забыли заглянуть.
+     */
+    readonly resolvedAppearance: Signal<MatFormFieldAppearance>;
     static ɵfac: i0.ɵɵFactoryDeclaration<RtuiDynamicSelectorsDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RtuiDynamicSelectorsDirective, never, never, { "buttonTitle": { "alias": "buttonTitle"; "required": false; "isSignal": true; }; "isSingleSelection": { "alias": "isSingleSelection"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "useNameBreaking": { "alias": "useNameBreaking"; "required": false; "isSignal": true; }; "useTitleCase": { "alias": "useTitleCase"; "required": false; "isSignal": true; }; "isPlaceholderIconOutlined": { "alias": "isPlaceholderIconOutlined"; "required": false; "isSignal": true; }; "isDeleteButtonShown": { "alias": "isDeleteButtonShown"; "required": false; "isSignal": true; }; "isListDraggable": { "alias": "isListDraggable"; "required": false; "isSignal": true; }; "placeholderIcon": { "alias": "placeholderIcon"; "required": false; "isSignal": true; }; "placeholderDescription": { "alias": "placeholderDescription"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1854,7 +1892,13 @@ declare class RtuiDynamicSelectorSelectedListComponent<ENTITY extends Record<str
     isDeleteButtonShown: InputSignalWithTransform<boolean, BooleanInput>;
     /** Indicates is items editable */
     isItemsEditable: InputSignalWithTransform<boolean, BooleanInput>;
-    /** Material elements appearance */
+    /**
+     * Material elements appearance.
+     *
+     * Значение приходит уже разрешённым — от того, кто список рисует: вложенный компонент,
+     * разрешающий вид заново, заводит свою цепочку, и вид поля внутри списка отличается от вида
+     * поля под ним. Прежнее умолчание оставлено на случай одиночного употребления списка.
+     */
     appearance: InputSignal<MatFormFieldAppearance>;
     readonly deleteFromSelectedAction: OutputEmitterRef<ENTITY[KEY]>;
     readonly dropAction: OutputEmitterRef<CdkDragDrop<ENTITY[]>>;