@evergis/react 4.0.124 → 4.0.125

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Everpoint
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Everpoint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
-# @evergis/react
-
-В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
-но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
-
-***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
-от системы поддержки мультиязычности `Evergis Online`!
+# @evergis/react
+
+В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
+но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
+
+***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
+от системы поддержки мультиязычности `Evergis Online`!

package/dist/components/Dashboard/componentTypes.d.ts

@@ -192,7 +192,7 @@ export interface ChartContainerConfig extends Omit<ConfigContainerChild, "option
 export interface ChartContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ChartContainerConfig;
 }
-export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "alignItems" | "grid" | "editMode" | "fixedHeight" | "gap"> & ContainerBoxOptions;
+export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "alignItems" | "grid" | "editMode" | "fixedHeight" | "autoHeight" | "gap"> & ContainerBoxOptions;
 export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.ContainersGroup;
     options?: ContainersGroupContainerOptions;
@@ -348,7 +348,7 @@ export interface FiltersContainerConfig extends Omit<ConfigContainerChild, "opti
 export interface FiltersContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: FiltersContainerConfig;
 }
-export type GridRowContainerOptions = Pick<ConfigOptions, "gap" | "alignItems"> & ContainerBoxOptions;
+export type GridRowContainerOptions = Pick<ConfigOptions, "gap" | "alignItems" | "autoHeight"> & ContainerBoxOptions;
 export interface GridRowContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.GridRow;
     options?: GridRowContainerOptions;

package/dist/components/Dashboard/containers/GridRowContainer/index.d.ts

@@ -7,5 +7,9 @@ import { GridRowContainerProps } from '../../types';
  * доля строки (`options.height`) читается РОДИТЕЛЬСКОЙ сеткой при сборке `grid-template-rows`,
  * а сама строка получает от неё готовую высоту трека — и занимает её целиком
  * ({@link GRID_FILL_DEFAULTS}), иначе колонки внутри строки схлопнулись бы до содержимого.
+ *
+ * Собственный `options.autoHeight` строки заменяет это «целиком» на минимум и разрешает ЯЧЕЙКАМ
+ * растить строку своим содержимым. Родительская сетка увидит рост, только если включила
+ * `autoHeight` у себя: опция читается у каждого узла и вверх сама не поднимается.
  */
 export declare const GridRowContainer: FC<GridRowContainerProps>;

package/dist/components/Dashboard/grid/GridGroupView/index.d.ts

@@ -6,5 +6,8 @@ import { ContainerProps } from '../../types';
  * По умолчанию сетка занимает всю высоту выделенного ей бокса ({@link GRID_FILL_DEFAULTS}) —
  * иначе `1fr`-строки раскладываются по содержимому. Если высота не определена и у родителя,
  * пропорции всё равно не заработают: взять их неоткуда, нужна заданная `options.height`.
+ *
+ * `options.autoHeight` меняет ту же высоту на минимум ({@link GRID_AUTO_FILL_DEFAULTS}): пропорции
+ * считаются от неё, но переросшее содержимое строк тянет сетку вниз, а не прокручивается внутри.
  */
 export declare const GridGroupView: FC<ContainerProps>;

package/dist/components/Dashboard/grid/components/GridHeightResizer/index.d.ts

@@ -2,6 +2,8 @@ import { FC } from 'react';
 interface GridHeightResizerProps {
     /** Доли всех строк сетки — база для пересчёта. */
     sizes: number[];
+    /** `options.autoHeight` сетки: жест задаёт не высоту, а нижний предел, ниже которого не сжимать. */
+    autoHeight?: boolean;
     getGrid: () => HTMLElement | null;
     onCommit: (height: string, sizes: number[]) => void;
 }

package/dist/components/Dashboard/grid/components/GridTrack/index.d.ts

@@ -5,6 +5,8 @@ interface GridTrackProps {
     item: ConfigContainerChild;
     axis: GridAxis;
     index: number;
+    /** `options.autoHeight` родителя: трек растёт под содержимое, а не запирает его в скролле. */
+    autoHeight?: boolean;
     /** Доли текущего трека и следующего. `null` — трек последний, границы за ним нет. */
     pairSizes: [number, number] | null;
     /** Доли всех строк сетки — переданы последней строке, за которой тянется нижняя граница. */

package/dist/components/Dashboard/grid/components/GridTracks/styled.d.ts

@@ -21,6 +21,7 @@ export declare const GridBody: import('styled-components').StyledComponent<"div"
     $template: string;
     $axis: GridAxis;
     $gap: number;
+    $autoHeight?: boolean;
 }, never>;
 /**
  * Обёртка одного трека.
@@ -29,11 +30,16 @@ export declare const GridBody: import('styled-components').StyledComponent<"div"
  * ячейки может не отрендериться (`hideIfEmptyDataSource`, чужой `tabId`, пустое значение), и без
  * обёртки пропавший узел утащил бы всю сетку на трек влево. Во-вторых, даёт систему координат
  * (`position: relative`) для ручки ресайза, лежащей в зазоре.
+ *
+ * `min-height: 0` — то, чем обёртка разрешает треку быть ниже своего содержимого. В режиме
+ * `autoHeight` он снимается: этот же ноль становится «минимальным вкладом» grid-элемента, из
+ * которого сетка считает `auto`-минимум трека, и с ним `minmax(auto, Nfr)` не сработал бы вовсе.
  */
 export declare const GridTrackBox: import('styled-components').StyledComponent<"div", any, {
     $selected?: boolean;
     $selectable?: boolean;
     $hoverable?: boolean;
+    $autoHeight?: boolean;
 }, never>;
 /**
  * Содержимое трека, запертое в его границах.
@@ -47,5 +53,12 @@ export declare const GridTrackBox: import('styled-components').StyledComponent<"
  * Отдельный узел, а не `overflow` на самой обёртке трека: ручки ресайза лежат в ней же и
  * намеренно выходят за границы трека на `HANDLE_BLEED_PX` — скролл-контейнер срезал бы им
  * половину зоны захвата.
+ *
+ * В режиме `autoHeight` клип снимается целиком: скролл-контейнер сам является тем боксом, внутри
+ * которого содержимое запирается, и `auto`-минимум трека при нём не сработал бы — трек так и не
+ * узнал бы, что содержимое переросло. Горизонтальный клип уходит вместе с вертикальным: пары
+ * `overflow-x: auto` + `overflow-y: visible` в CSS не существует, вторая ось поднимает первую.
  */
-export declare const GridTrackContent: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const GridTrackContent: import('styled-components').StyledComponent<"div", any, {
+    $autoHeight?: boolean;
+}, never>;

package/dist/components/Dashboard/grid/constants.d.ts

@@ -19,6 +19,14 @@ export declare const MIN_TRACK_RATIO = 0.25;
  * Явный `options.height` дефолт перекрывает — см. {@link getWrapperSizeStyle}.
  */
 export declare const GRID_FILL_DEFAULTS: CSSObject;
+/**
+ * Тот же дефолт для режима `options.autoHeight`: занять выделенный бокс, но не запереться в нём.
+ *
+ * Жёсткая `height: 100%` в этом режиме и есть источник проблемы: узел ровно равен своему треку,
+ * и выросшее содержимое ему уже некуда деть, кроме внутреннего скролла. Минимум даёт ту же
+ * стартовую высоту, оставляя запас на рост.
+ */
+export declare const GRID_AUTO_FILL_DEFAULTS: CSSObject;
 /**
  * Зазор между треками по умолчанию, px.
  *

package/dist/components/Dashboard/grid/hooks/useGridHeightResize.d.ts

@@ -2,6 +2,8 @@ import { GridResize } from './useGridResize';
 interface UseGridHeightResizeParams {
     /** Доли всех строк сетки — их сумма сохраняется при пересчёте. */
     sizes: number[];
+    /** `options.autoHeight` сетки: результат жеста — минимум, а не жёсткая высота. */
+    autoHeight?: boolean;
     getGrid: () => HTMLElement | null;
     onCommit: (height: string, sizes: number[]) => void;
 }
@@ -15,6 +17,11 @@ interface UseGridHeightResizeParams {
  *
  * Высота пишется в пикселях: единица, в которой её задал автор конфига, при таком жесте не
  * восстановима, а пиксели дают ровно тот результат, который пользователь видел под курсором.
+ *
+ * В режиме `autoHeight` в конфиг уходит та же `options.height`, но и превью, и результат означают
+ * МИНИМУМ: корню пишется `min-height`, трекам — `minmax(auto, Npx)`. Иначе жест врал бы ровно там,
+ * ради чего режим включают: под курсором сетка садилась бы на заданные пиксели, а после отпускания
+ * снова раздувалась содержимым.
  */
-export declare const useGridHeightResize: ({ sizes, getGrid, onCommit }: UseGridHeightResizeParams) => GridResize;
+export declare const useGridHeightResize: ({ sizes, autoHeight, getGrid, onCommit, }: UseGridHeightResizeParams) => GridResize;
 export {};

package/dist/components/Dashboard/grid/utils/gridTracks.d.ts

@@ -27,7 +27,15 @@ export declare const toFrSize: (value: number) => string;
  *
  * `minmax(0, X)` вместо голого размера: голый трек имеет неявный минимум `auto`, и широкий контент
  * (таблица, график) распирает его изнутри, ломая заданные пропорции.
+ *
+ * `autoMin` возвращает этот самый минимум `auto` — ровно то, ради чего включают `autoHeight`:
+ * переросшее содержимое раздвигает трек вместо того, чтобы прокручиваться внутри него.
+ */
+export declare const buildTrackTemplate: (sizes: string[], autoMin?: boolean) => string;
+/**
+ * Значение `grid-template-rows` / `grid-template-columns` по долям детей.
+ *
+ * `autoHeight` отпускает минимум только у СТРОК: ширину растить нечем и незачем — по горизонтали
+ * узел и так волен прокручиваться, а `auto`-минимум колонки просто сломал бы заданные пропорции.
  */
-export declare const buildTrackTemplate: (sizes: string[]) => string;
-/** Значение `grid-template-rows` / `grid-template-columns` по долям детей. */
-export declare const buildGridTemplate: (children: ConfigContainerChild[], axis: GridAxis) => string;
+export declare const buildGridTemplate: (children: ConfigContainerChild[], axis: GridAxis, autoHeight?: boolean) => string;

package/dist/components/Dashboard/types.d.ts

@@ -206,6 +206,25 @@ export interface ConfigLayoutOptions {
      * высоты нет и так.
      */
     fixedHeight?: boolean;
+    /**
+     * Секция растёт под содержимое: `options.height` применяется как МИНИМУМ (`min-height`),
+     * треки объявляются `minmax(auto, Nfr)` вместо `minmax(0, Nfr)`, а их содержимое перестаёт
+     * прокручиваться внутри трека. Нужен витринам, доращивающим контент уже после рендера
+     * («Показать ещё»): в обычном режиме трек по содержимому не растёт, и выросшее уходит во
+     * внутренний скролл вместо того, чтобы растянуть секцию.
+     *
+     * Читается у КАЖДОГО узла отдельно и управляет его собственными треками: у сетки это строки,
+     * у строки (`GridRow`) — вертикальный размер её ячеек. Чтобы рост дошёл снизу вверх, опция
+     * нужна на всей цепочке предков — включённая только у корня, она ничего не даст.
+     *
+     * Следствия, с которыми режим поставляется:
+     * - точен для секции с ОДНОЙ строкой; при нескольких переросшая строка раздувает соседей
+     *   пропорционально долям — это семантика `fr`, «сосед держит свои пиксели» в CSS Grid не
+     *   выражается;
+     * - вместе с вертикальным клипом уходит и горизонтальный: `overflow-y: visible` при
+     *   `overflow-x: auto` в CSS невозможен.
+     */
+    autoHeight?: boolean;
     twoColumns?: boolean;
     /** Вписать график контейнера Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
     fill?: boolean;

package/dist/components/Dashboard/utils/getWrapperSizeStyle.d.ts

@@ -16,6 +16,8 @@ export interface WrapperSizeParams {
     defaults?: CSSObject;
     /** Ширина по умолчанию, если `options.width` не задан. Контейнеры передают `FILL_SIZE`, элементы — нет. */
     defaultWidth?: CssSize;
+    /** `options.autoHeight`: высота — не жёсткий размер, а минимум, ниже которого узел не опускается. */
+    heightAsMin?: boolean;
 }
 export declare const isFillSize: (size?: CssSize) => boolean;
 /** Доля трека сетки: `"2fr"`, `"1.5fr"`. */
@@ -36,5 +38,9 @@ export declare const isFrSize: (size?: CssSize) => boolean;
  *
  * `overflow` уходит в CSS как есть и ничем не подменяется: не задан — работает браузерный
  * `visible`, то есть контент крупнее бокса вытекает на соседние слоты.
+ *
+ * `heightAsMin` переводит высоту в `min-height`: узел не опускается ниже неё, но перерастает под
+ * содержимое. Парного `minHeight: 0` в fill-режиме при этом нет — он немедленно погасил бы сам
+ * минимум, ради которого режим и включают.
  */
-export declare const getWrapperSizeStyle: ({ style, width: widthOption, height: heightOption, overflow, defaults, defaultWidth, }: WrapperSizeParams) => CSSObject | undefined;
+export declare const getWrapperSizeStyle: ({ style, width: widthOption, height: heightOption, overflow, defaults, defaultWidth, heightAsMin, }: WrapperSizeParams) => CSSObject | undefined;