@evergis/react 4.0.117 → 4.0.119

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"> & ContainerBoxOptions;
+export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "alignItems" | "grid" | "editMode" | "gap"> & ContainerBoxOptions;
 export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.ContainersGroup;
     options?: ContainersGroupContainerOptions;
@@ -348,6 +348,14 @@ 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 interface GridRowContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
+    templateName?: ContainerTemplate.GridRow;
+    options?: GridRowContainerOptions;
+}
+export interface GridRowContainerProps extends Omit<ContainerProps, "elementConfig"> {
+    elementConfig?: GridRowContainerConfig;
+}
 export type IconContainerOptions = Record<string, never>;
 export interface IconContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Icon;
@@ -489,7 +497,7 @@ export interface FeatureCardSlideshowHeaderConfig extends Omit<ConfigContainerHe
  * Поскольку оба поля помечены как опциональные (`?`), значения **без** дискриминатора по-прежнему
  * приемлемы для любой ветви — это переходная мягкая совместимость с legacy-конфигами.
  */
-export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTooltipConfig | ElementUploaderConfig | AddFeatureContainerConfig | AttachmentContainerConfig | CameraContainerConfig | ChartContainerConfig | ContainersGroupContainerConfig | DataSourceContainerConfig | DataSourceProgressContainerConfig | DefaultAttributesContainerConfig | DividerContainerElementConfig | EditContainerConfig | EditGroupContainerConfig | EditBooleanContainerConfig | EditStringContainerConfig | EditNumberContainerConfig | EditDropdownContainerConfig | EditChipsContainerConfig | EditCheckboxContainerConfig | EditDateContainerConfig | EditAttachmentContainerConfig | ExportPdfContainerConfig | FiltersContainerConfig | IconContainerConfig | ImageContainerConfig | LayersContainerConfig | OneColumnContainerConfig | ProgressContainerConfig | RoundedBackgroundContainerConfig | SlideshowContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig;
+export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTooltipConfig | ElementUploaderConfig | AddFeatureContainerConfig | AttachmentContainerConfig | CameraContainerConfig | ChartContainerConfig | ContainersGroupContainerConfig | DataSourceContainerConfig | DataSourceProgressContainerConfig | DefaultAttributesContainerConfig | DividerContainerElementConfig | EditContainerConfig | EditGroupContainerConfig | EditBooleanContainerConfig | EditStringContainerConfig | EditNumberContainerConfig | EditDropdownContainerConfig | EditChipsContainerConfig | EditCheckboxContainerConfig | EditDateContainerConfig | EditAttachmentContainerConfig | ExportPdfContainerConfig | FiltersContainerConfig | GridRowContainerConfig | IconContainerConfig | ImageContainerConfig | LayersContainerConfig | OneColumnContainerConfig | ProgressContainerConfig | RoundedBackgroundContainerConfig | SlideshowContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig;
 /**
  * Строгий authoring-тип узла конфига. В отличие от мягкого {@link ConfigContainerChild}
  * (`id?` — опционален ради legacy-совместимости), здесь `id` **обязателен** и рекурсивно
@@ -557,6 +565,7 @@ export type ContainerTemplateToProps = {
     [ContainerTemplate.EditAttachment]: EditAttachmentContainerProps;
     [ContainerTemplate.ExportPdf]: ExportPdfContainerProps;
     [ContainerTemplate.Filters]: FiltersContainerProps;
+    [ContainerTemplate.GridRow]: GridRowContainerProps;
     [ContainerTemplate.Icon]: IconContainerProps;
     [ContainerTemplate.Image]: ImageContainerProps;
     [ContainerTemplate.Layers]: LayersContainerProps;

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

@@ -3,6 +3,13 @@ import { AttributeIconType, AttributeType, QueryLayerServiceInfoDc } from '@ever
 import { ConfigContainer, ConfigContainerChild, ConfigElementType } from './types';
 export declare const CONFIG_PAGES_ID = "pages";
 export declare const CONFIG_PAGE_ID = "page";
+/**
+ * Slot-id детей, которые контейнер отдаёт заголовку (`ExpandableTitle`), а не телу.
+ *
+ * `ContainerChildren` исключает их из рендера тела; сетка обязана исключать их же при сборке
+ * `grid-template-*`, иначе слот заголовка съест трек и раскладка съедет.
+ */
+export declare const TITLE_SLOT_IDS: string[];
 export declare const DEFAULT_PAGES_CONFIG: ConfigContainerChild;
 export declare const DEFAULT_DASHBOARD_CONFIG: ConfigContainer;
 export declare const FEATURE_CARD_OTHER_COLOR = "#D4DADD";
@@ -57,3 +64,11 @@ export declare const CONTAINER_BODY_ATTRIBUTE = "data-container-body";
  * `flex-shrink: 0` и не сжимается.
  */
 export declare const CONTAINER_BODY_FILL_STYLE: CSSObject;
+/**
+ * Дефолт корневой обёртки группы контейнеров.
+ *
+ * `border-box` — чтобы `padding` из авторского `style` не раздувал бокс сверх выданного размера.
+ * Особенно чувствительно в сетке: ячейка с отступами иначе перерастает свой трек, и указывать
+ * `boxSizing` руками пришлось бы в каждом узле конфига.
+ */
+export declare const CONTAINERS_GROUP_DEFAULTS: CSSObject;

package/dist/components/Dashboard/containers/ContainersGroupContainer/FlowGroup.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { ContainersGroupContainerProps } from '../../types';
+/** Обычная (не сеточная) раскладка группы: дети в колонку или в строку. */
+export declare const FlowGroup: FC<ContainersGroupContainerProps>;

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

@@ -1,3 +1,9 @@
 import { FC } from 'react';
 import { ContainersGroupContainerProps } from '../../types';
+/**
+ * Диспетчер двух раскладок группы: обычной и сеточной.
+ *
+ * Собственных хуков здесь намеренно нет. `options.grid` переключается на лету (контрол в
+ * сторибуке, редактор дашборда), и любой хук до ветвления менял бы их порядок между рендерами.
+ */
 export declare const ContainersGroupContainer: FC<ContainersGroupContainerProps>;

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

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

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

@@ -9,6 +9,7 @@ export * from './DataSourceProgressContainer';
 export * from './DefaultAttributesContainer';
 export * from './DividerContainer';
 export * from './FiltersContainer';
+export * from './GridRowContainer';
 export * from './IconContainer';
 export * from './ImageContainer';
 export * from './LayersContainer';

package/dist/components/Dashboard/containers/registry.d.ts

@@ -43,5 +43,6 @@ export declare const getContainerComponents: () => {
     readonly Attachment: FC<import('../componentTypes').AttachmentContainerProps>;
     readonly EditGroup: FC<import('../componentTypes').EditGroupContainerProps>;
     readonly ContainersGroup: FC<import('../componentTypes').ContainersGroupContainerProps>;
+    readonly GridRow: FC<import('../componentTypes').GridRowContainerProps>;
     readonly default: FC<import('../componentTypes').ContainersGroupContainerProps>;
 };

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

@@ -0,0 +1,9 @@
+import { GridEditSessionValue } from '../types';
+/**
+ * Сессия редактирования раскладки. Создаётся ВНЕШНИМ grid-узлом с `options.editMode`;
+ * вложенные сетки её только читают, собственный `editMode` у них игнорируется.
+ *
+ * `null` — режим просмотра: ни выделения, ни ручек, ни контекстного меню.
+ */
+export declare const GridEditContext: import('react').Context<GridEditSessionValue>;
+export declare const useGridEdit: () => GridEditSessionValue | null;

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

@@ -0,0 +1,11 @@
+import { FC } from 'react';
+import { ContainerProps } from '../../types';
+/**
+ * Сессия редактирования раскладки: черновик, выделение и контекстное меню на всё дерево сетки.
+ *
+ * Черновик отличается структурой от конфига, пришедшего сверху, поэтому `renderElement` из пропсов
+ * здесь не годится — он замкнут на исходный узел и не найдёт ячейки, созданные split/add. Вместо
+ * него строится собственный, замкнутый на черновик; всё дерево ниже получает его по цепочке
+ * рекурсии `getRenderElement`.
+ */
+export declare const GridEditSession: FC<ContainerProps>;

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

@@ -0,0 +1,11 @@
+import { FC } from 'react';
+import { ContainersGroupContainerProps } from '../../componentTypes';
+/**
+ * Точка входа в сетку.
+ *
+ * Сессию редактирования открывает только ВНЕШНИЙ узел: вложенные сетки наследуют её через
+ * контекст, а собственный `options.editMode` у них игнорируется — иначе на одном дереве
+ * оказалось бы несколько независимых черновиков, и правки во вложенной сетке не попали бы
+ * в конфиг, который внешняя отдаёт в `onChange`.
+ */
+export declare const GridGroup: FC<ContainersGroupContainerProps>;

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

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

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

@@ -0,0 +1,16 @@
+import { FC } from 'react';
+import { GridMenuPosition } from '../../types';
+interface GridContextMenuProps {
+    /** `null` — меню закрыто. */
+    position: GridMenuPosition | null;
+    onClose: VoidFunction;
+}
+/**
+ * Контекстное меню сетки, открывающееся в точке курсора.
+ *
+ * `Popup` построен на tippy и пробрасывает в него незнакомые пропсы, поэтому позиционирование
+ * по координатам делается штатным tippy-механизмом `getReferenceClientRect` — виртуальным
+ * прямоугольником нулевого размера в точке нажатия.
+ */
+export declare const GridContextMenu: FC<GridContextMenuProps>;
+export {};

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

@@ -0,0 +1,8 @@
+/**
+ * Технический якорь меню.
+ *
+ * Меню открывается в точке курсора через tippy-проп `getReferenceClientRect`, но самому tippy
+ * всё равно нужен реальный элемент, к которому он монтируется. Этот узел ничего не занимает
+ * и не виден.
+ */
+export declare const MenuAnchor: import('styled-components').StyledComponent<"span", any, {}, never>;

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

@@ -0,0 +1,14 @@
+import { FC } from 'react';
+interface GridHeightResizerProps {
+    /** Доли всех строк сетки — база для пересчёта. */
+    sizes: number[];
+    getGrid: () => HTMLElement | null;
+    onCommit: (height: string, sizes: number[]) => void;
+}
+/**
+ * Ручка на нижней границе сетки: тянет высоту последней строки вместе с высотой самой сетки.
+ *
+ * Выглядит так же, как ручка между треками, но соседа снизу у неё нет — растёт сам контейнер.
+ */
+export declare const GridHeightResizer: FC<GridHeightResizerProps>;
+export {};

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

@@ -0,0 +1,13 @@
+import { FC } from 'react';
+import { GridAxis } from '../../types';
+interface GridResizerProps {
+    axis: GridAxis;
+    /** Граница между треками `index` и `index + 1`. */
+    index: number;
+    /** Доли пары треков из конфига — база для пересчёта. */
+    sizes: [number, number];
+    getGrid: () => HTMLElement | null;
+    onCommit: (index: number, sizes: [number, number]) => void;
+}
+export declare const GridResizer: FC<GridResizerProps>;
+export {};

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

@@ -0,0 +1,11 @@
+import { GridAxis } from '../../types';
+/**
+ * Ручка перетаскивания границы треков.
+ *
+ * Абсолютная и целиком лежит в зазоре, поэтому включение режима редактирования не сдвигает
+ * раскладку ни на пиксель. Сам ползунок (`::after`) появляется только при наведении и во время
+ * перетаскивания — в покое сетка выглядит как обычно.
+ */
+export declare const ResizeHandle: import('styled-components').StyledComponent<"div", any, {
+    $axis: GridAxis;
+}, never>;

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

@@ -0,0 +1,24 @@
+import { FC } from 'react';
+import { ConfigContainerChild, RenderElementFunction } from '../../../types';
+import { GridAxis } from '../../types';
+interface GridTrackProps {
+    item: ConfigContainerChild;
+    axis: GridAxis;
+    index: number;
+    /** Доли текущего трека и следующего. `null` — трек последний, границы за ним нет. */
+    pairSizes: [number, number] | null;
+    /** Доли всех строк сетки — переданы последней строке, за которой тянется нижняя граница. */
+    outerSizes?: number[];
+    getGrid: () => HTMLElement | null;
+    onResizeCommit: (index: number, sizes: [number, number]) => void;
+    onHeightCommit: (height: string, sizes: number[]) => void;
+    renderElement: RenderElementFunction;
+}
+/**
+ * Один трек сетки: обёртка + содержимое + ручка ресайза на дальней границе.
+ *
+ * Выделение и меню доступны только на оси ячеек: строка — структурный узел, самостоятельных
+ * операций над ней нет, добавление и удаление строк идут через выбранную в строке ячейку.
+ */
+export declare const GridTrack: FC<GridTrackProps>;
+export {};

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

@@ -0,0 +1,21 @@
+import { FC } from 'react';
+import { ConfigContainerChild, RenderElementFunction } from '../../../types';
+import { ContainerBodyProps } from '../../../hooks/useContainerRoot';
+import { GridAxis } from '../../types';
+interface GridTracksProps {
+    /** Узел, чьи дети становятся треками: сетка (строки) или строка (ячейки). */
+    node: ConfigContainerChild;
+    axis: GridAxis;
+    renderElement: RenderElementFunction;
+    /** Пропсы тела контейнера из `useContainerRoot`. */
+    body?: ContainerBodyProps;
+    gap?: number;
+}
+/**
+ * Раскладка одной оси сетки: собирает `grid-template-*` из долей детей и рендерит треки.
+ *
+ * Каждый ребёнок обязательно получает собственную DOM-обёртку, даже если его содержимое не
+ * отрендерилось: иначе число узлов разойдётся с числом треков и сетка съедет.
+ */
+export declare const GridTracks: FC<GridTracksProps>;
+export {};

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

@@ -0,0 +1,51 @@
+import { GridAxis } from '../../types';
+/**
+ * Тело сетки.
+ *
+ * Наследуется от обычного `Container` в колоночном режиме: строчная ветка базы даёт
+ * `justify-content: space-between` (растащил бы треки) и `align-items: center` (отключил бы
+ * stretch у ячеек) — в неё лучше не входить вовсе. Из колоночной гасим ровно одно правило —
+ * фиксированный `margin-bottom` у детей, потому что в сетке зазор задаёт `gap`.
+ *
+ * Унаследованные `width: 100%` и `min-width: 0` у детей оставлены намеренно: для grid-item это
+ * ровно то, что нужно, а попытка их перебить упёрлась бы в равную специфичность с `$sizeCss`
+ * самой ячейки.
+ */
+export declare const GridBody: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & import('../../../styled').ContainerRootProps & {
+    isTitle?: boolean;
+    isColumn?: boolean;
+    isMain?: boolean;
+    noBorders?: boolean;
+    $alignItems?: import('../../..').AlignItems;
+} & {
+    $template: string;
+    $axis: GridAxis;
+    $gap: number;
+}, never>;
+/**
+ * Обёртка одного трека.
+ *
+ * Существует ради двух вещей. Во-первых, гарантирует соответствие «трек ↔ DOM-узел»: содержимое
+ * ячейки может не отрендериться (`hideIfEmptyDataSource`, чужой `tabId`, пустое значение), и без
+ * обёртки пропавший узел утащил бы всю сетку на трек влево. Во-вторых, даёт систему координат
+ * (`position: relative`) для ручки ресайза, лежащей в зазоре.
+ */
+export declare const GridTrackBox: import('styled-components').StyledComponent<"div", any, {
+    $selected?: boolean;
+    $selectable?: boolean;
+    $hoverable?: boolean;
+}, never>;
+/**
+ * Содержимое трека, запертое в его границах.
+ *
+ * Трек объявлен как `minmax(0, Nfr)` и по содержимому не растёт, а корень контейнера внутри —
+ * flex-элемент, который ниже собственного содержимого не сжимается. Без явного `overflow` лишнее
+ * рисовалось бы ЗА пределами трека, поверх соседней строки: обе обёртки позиционированы, поэтому
+ * поверх оказывается та, что ниже по DOM. Ярче всего это вылезало после объединения ячеек —
+ * оно складывает их содержимое в столбик и разом удваивает требуемую высоту.
+ *
+ * Отдельный узел, а не `overflow` на самой обёртке трека: ручки ресайза лежат в ней же и
+ * намеренно выходят за границы трека на `HANDLE_BLEED_PX` — скролл-контейнер срезал бы им
+ * половину зоны захвата.
+ */
+export declare const GridTrackContent: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -0,0 +1,77 @@
+import { CSSObject } from 'styled-components';
+/**
+ * Минимальный размер трека, px. Ниже него ресайз не пускает — иначе ячейку не за что схватить.
+ *
+ * Это верхняя граница минимума, а не жёсткое значение: в низкой сетке пара треков может не
+ * набирать и двух таких минимумов, и фиксированный порог запер бы границу намертво.
+ */
+export declare const MIN_TRACK_PX = 40;
+/** Какую долю пары треков минимум разрешено занимать каждому из них в тесной сетке. */
+export declare const MIN_TRACK_RATIO = 0.25;
+/**
+ * Дефолт корневой обёртки сетки и строки: занять по вертикали весь выделенный бокс.
+ *
+ * Без него высота узла определяется содержимым, а `1fr`-треки внутри неопределённой высоты по
+ * спецификации CSS раскладываются по контенту — пропорции не работают. Сильнее всего это било по
+ * вложенным сеткам: ячейка собственной высоты не имеет, она приходит ей от трека, и внутренняя
+ * сетка съёживалась до контента вместе с возможностью тянуть её границы.
+ *
+ * Явный `options.height` дефолт перекрывает — см. {@link getWrapperSizeStyle}.
+ */
+export declare const GRID_FILL_DEFAULTS: CSSObject;
+/**
+ * Зазор между треками по умолчанию, px.
+ *
+ * Ноль: сетка бесшовная, ячейки стыкуются вплотную. Зазор — оформительское решение конкретной
+ * раскладки, поэтому задаётся явно через `options.gap`, а не навязывается всем сеткам.
+ */
+export declare const DEFAULT_GRID_GAP = 0;
+/**
+ * Насколько ручка ресайза заходит на содержимое с каждой стороны, px.
+ *
+ * По умолчанию зазора нет вовсе, так что попасть курсором ровно в границу невозможно — зона
+ * захвата всегда шире зазора на эту величину с каждой стороны. Ручка абсолютная и в раскладке
+ * не участвует, поэтому расширение ничего не сдвигает.
+ */
+export declare const HANDLE_BLEED_PX = 3;
+/**
+ * Сдвиг курсора, после которого нажатие на ячейке считается перетаскиванием, px.
+ *
+ * До порога жест остаётся кликом: ячейку выделяют тем же нажатием, и дрожание руки не должно
+ * превращать выделение в перестановку.
+ */
+export declare const DRAG_THRESHOLD_PX = 4;
+/** Маркер ячейки в DOM: по нему ищется цель перетаскивания под курсором. */
+export declare const GRID_CELL_ATTR = "data-grid-cell";
+/** Маркер ручки ресайза: нажатие на ней тянет границу, а не ячейку. */
+export declare const GRID_HANDLE_ATTR = "data-grid-handle";
+/** Тот же маркер пропсами: имя атрибута вычисляемое, а в JSX такое подставляется только спредом. */
+export declare const GRID_HANDLE_PROPS: {
+    "data-grid-handle": boolean;
+};
+/**
+ * Нажатия, которые перетаскиванием ячейки не считаются.
+ *
+ * Ручка тянет границу трека, а поля ввода живут своей жизнью: там нажатие ставит каретку и
+ * выделяет текст, и подменять это перестановкой ячеек нельзя.
+ */
+export declare const NO_CELL_DRAG_SELECTOR = "[data-grid-handle], input, textarea, select, [contenteditable=\"true\"]";
+/**
+ * Разметка идущего жеста: ячейка-источник, цель под курсором и сам факт перетаскивания.
+ *
+ * Атрибутами, а не пропсами: цель меняется десятки раз за жест, и каждая смена перерисовывала бы
+ * поддерево сетки вместе с `renderElement`. Ровно так же ресайз рисует превью — прямо в DOM, а в
+ * состояние результат уходит один раз, на отпускание мыши.
+ */
+export declare const GRID_DRAG_SOURCE_ATTR = "data-grid-drag-source";
+export declare const GRID_DROP_TARGET_ATTR = "data-grid-drop-target";
+export declare const GRID_DRAGGING_ATTR = "data-grid-dragging";
+/** Потолок на число треков в одном родителе — страховка от бесконечного дробления через split. */
+export declare const MAX_TRACKS = 12;
+/** Доля трека новой ячейки/строки, если посчитать среднее не из чего. */
+export declare const DEFAULT_TRACK_FR = 1;
+/** Знаменатель округления долей: три знака после запятой. */
+export declare const FR_PRECISION = 1000;
+/** Префиксы id создаваемых узлов. Не должны начинаться с `CONFIG_PAGE_ID` (`"page"`). */
+export declare const GRID_ROW_ID_PREFIX = "gridRow_";
+export declare const GRID_CELL_ID_PREFIX = "gridCell_";

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

@@ -0,0 +1,25 @@
+import { MouseEvent as ReactMouseEvent } from 'react';
+import { ConfigContainerChild } from '../../types';
+import { GridEditAction } from '../types';
+interface UseGridCellSwapParams {
+    /** Актуальная раскладка: по ней проверяется, можно ли меняться с ячейкой под курсором. */
+    draft: ConfigContainerChild;
+    applyAction: (action: GridEditAction) => void;
+}
+export interface GridCellSwap {
+    beginDrag: (cellId: string, event: ReactMouseEvent<HTMLElement>) => void;
+    /** `true` — этим кликом закончилось перетаскивание, и выделение он менять не должен. */
+    consumeDragClick: () => boolean;
+}
+/**
+ * Перетаскивание ячейки на место другой ячейки.
+ *
+ * Один экземпляр на сессию: жест начинается в одной ячейке, а заканчивается в другой, возможно из
+ * другой строки или вложенной сетки, — держать его в самой ячейке негде.
+ *
+ * Пока жест идёт, в состояние не пишется ничего: источник и цель размечаются атрибутами прямо в
+ * DOM, как ресайз рисует инлайн-превью. В конфиг уходит ровно одна правка — на отпускание мыши
+ * над валидной целью.
+ */
+export declare const useGridCellSwap: ({ draft, applyAction }: UseGridCellSwapParams) => GridCellSwap;
+export {};

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

@@ -0,0 +1,22 @@
+import { ConfigContainerChild, WidgetType } from '../../types';
+import { GridAxis, GridEditAction } from '../types';
+interface UseGridDraftParams {
+    /** Узел сетки из конфига — начальное значение черновика. */
+    node: ConfigContainerChild;
+    type: WidgetType;
+    onChange?: (config: ConfigContainerChild) => void;
+}
+export interface GridDraft {
+    draft: ConfigContainerChild;
+    applyAction: (action: GridEditAction) => void;
+    commitResize: (parentId: string, index: number, sizes: [number, number], axis: GridAxis) => void;
+    commitHeight: (height: string, sizes: number[]) => void;
+}
+/**
+ * Локальный черновик раскладки: правки применяются сразу, наружу уходят через `onChange`.
+ *
+ * Черновик, а не controlled-проп, по двум причинам: редактирование работает даже если хост
+ * `onChange` не обслуживает, и промежуточные состояния не гоняются через внешний стейт.
+ */
+export declare const useGridDraft: ({ node, type, onChange }: UseGridDraftParams) => GridDraft;
+export {};

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

@@ -0,0 +1,20 @@
+import { GridResize } from './useGridResize';
+interface UseGridHeightResizeParams {
+    /** Доли всех строк сетки — их сумма сохраняется при пересчёте. */
+    sizes: number[];
+    getGrid: () => HTMLElement | null;
+    onCommit: (height: string, sizes: number[]) => void;
+}
+/**
+ * Перетаскивание НИЖНЕЙ границы сетки — внешней, за которой уже нет соседнего трека.
+ *
+ * Отличается от обычного ресайза тем, что менять доли не за счёт кого-то: последняя строка растёт
+ * вместе с самой сеткой. Поэтому в конфиг уходит и новая `options.height` корня, и пересчитанные
+ * доли всех строк — без пересчёта верхние строки разъехались бы пропорционально новой высоте,
+ * хотя их границ никто не трогал.
+ *
+ * Высота пишется в пикселях: единица, в которой её задал автор конфига, при таком жесте не
+ * восстановима, а пиксели дают ровно тот результат, который пользователь видел под курсором.
+ */
+export declare const useGridHeightResize: ({ sizes, getGrid, onCommit }: UseGridHeightResizeParams) => GridResize;
+export {};

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

@@ -0,0 +1,2 @@
+import { IOption } from '@evergis/uilib-gl';
+export declare const useGridMenuOptions: () => IOption[];

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

@@ -0,0 +1,27 @@
+import { GridAxis } from '../types';
+interface UseGridResizeParams {
+    axis: GridAxis;
+    /** Граница между треками `index` и `index + 1`. */
+    index: number;
+    /** Доли пары треков из конфига. */
+    sizes: [number, number];
+    getGrid: () => HTMLElement | null;
+    onCommit: (index: number, sizes: [number, number]) => void;
+}
+export interface GridResize {
+    /** Callback-ref для ручки: `useDragAndDropEffect` принимает элемент, а не ref. */
+    setHandle: (element: HTMLElement | null) => void;
+    dragging: boolean;
+}
+/**
+ * Перетаскивание границы между двумя соседними треками.
+ *
+ * Во время жеста раскладка меняется ИНЛАЙН-стилем на самом гриде, без обновления состояния:
+ * каждый `mousemove` иначе перерисовывал бы всё поддерево сетки. В конфиг доли уходят один раз,
+ * на отпускание мыши.
+ *
+ * Пиксельный снимок треков берётся однократно на `mousedown` — если пересчитывать его на каждом
+ * шаге уже после применения новых долей, округление `fr → px → fr` даёт дрейф границы.
+ */
+export declare const useGridResize: ({ axis, index, sizes, getGrid, onCommit }: UseGridResizeParams) => GridResize;
+export {};

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

@@ -0,0 +1,12 @@
+export interface GridSelection {
+    selectedIds: string[];
+    selectCell: (id: string, additive: boolean) => void;
+    clearSelection: VoidFunction;
+}
+/**
+ * Выделение ячеек сетки. Shift (`additive`) добавляет и убирает, обычный клик — заменяет.
+ *
+ * Выделяются только ячейки: строки структурны, самостоятельных операций над ними нет —
+ * добавление и удаление строк делается через выбранную в ней ячейку.
+ */
+export declare const useGridSelection: () => GridSelection;