@evergis/react 4.0.118 → 4.0.120

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

@@ -0,0 +1,23 @@
+/** Генератор id для узлов, создаваемых операциями сетки. */
+export interface GridIdFactory {
+    createRowId: () => string;
+    createCellId: () => string;
+}
+/**
+ * Все `id`, встречающиеся в поддереве конфига.
+ *
+ * Обходим целиком, а не только `children`: узлы конфига встречаются и в других коллекциях
+ * (`modals`, вложенные структуры), а `returnFound` из `find-and` ищет так же — вглубь по всему
+ * объекту. Дубликат id заставил бы движок молча взять первое совпадение.
+ */
+export declare const collectConfigIds: (source: unknown, acc?: Set<string>) => Set<string>;
+/**
+ * Фабрика уникальных id со сквозной нумерацией.
+ *
+ * Счётчик общий на всю страницу, а не на поддерево грида: на одной странице может быть несколько
+ * сеток, и локальные счётчики выдали бы им одинаковые `gridCell_1`.
+ *
+ * Префиксы намеренно не начинаются с `CONFIG_PAGE_ID` (`"page"`): по `id.startsWith("page")`
+ * `ContainersGroupContainer` опознаёт корневой блок страницы и оборачивает его в карточку.
+ */
+export declare const createGridIdFactory: (usedIds: Set<string>) => GridIdFactory;

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

@@ -0,0 +1,14 @@
+import { GridEditAction } from '../types';
+/** Значения пунктов контекстного меню сетки. */
+export declare const GRID_MENU_VALUE: {
+    readonly SplitVertical: "splitVertical";
+    readonly SplitHorizontal: "splitHorizontal";
+    readonly AddRowBefore: "addRowBefore";
+    readonly AddRowAfter: "addRowAfter";
+    readonly AddCellBefore: "addCellBefore";
+    readonly AddCellAfter: "addCellAfter";
+    readonly Merge: "merge";
+    readonly Delete: "delete";
+};
+export type GridMenuValue = (typeof GRID_MENU_VALUE)[keyof typeof GRID_MENU_VALUE];
+export declare const buildGridAction: (value: string, cellIds: string[]) => GridEditAction | null;

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

@@ -0,0 +1,18 @@
+import { ConfigContainerChild } from '../../types';
+import { GridEditAction, GridMenuState } from '../types';
+import { GridIdFactory } from './createGridNodeId';
+export declare const normalizeGrid: (root: ConfigContainerChild, factory: GridIdFactory) => ConfigContainerChild;
+export declare const deleteCells: (root: ConfigContainerChild, cellIds: string[], factory: GridIdFactory) => ConfigContainerChild;
+export declare const canMergeCells: (root: ConfigContainerChild, cellIds: string[]) => boolean;
+export declare const mergeCells: (root: ConfigContainerChild, cellIds: string[]) => ConfigContainerChild;
+export declare const canSwapCells: (root: ConfigContainerChild, sourceId: string, targetId: string) => boolean;
+/**
+ * Меняет две ячейки местами.
+ *
+ * Доля трека остаётся за ПОЗИЦИЕЙ, а не едет с ячейкой: границы после обмена стоят там же, где
+ * стояли, переезжает только содержимое. Иначе каждая перестановка заодно перекраивала бы
+ * пропорции сетки, хотя их никто не трогал.
+ */
+export declare const swapCells: (root: ConfigContainerChild, sourceId: string, targetId: string) => ConfigContainerChild;
+export declare const getGridMenuState: (root: ConfigContainerChild, selectedIds: string[]) => GridMenuState;
+export declare const applyGridAction: (root: ConfigContainerChild, action: GridEditAction, factory: GridIdFactory) => ConfigContainerChild;

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

@@ -0,0 +1,18 @@
+import { ConfigContainerChild } from '../../types';
+import { GridAxis } from '../types';
+/**
+ * Правки долей треков — итог перетаскивания границ.
+ *
+ * Отдельно от структурных операций (`gridOperations`): здесь ничего не создаётся и не удаляется,
+ * меняются только размеры уже существующих треков, и приходят эти правки не через меню, а прямо
+ * от ручек ресайза.
+ */
+/** Новые доли пары соседних треков после перетаскивания их общей границы. */
+export declare const resizeTracks: (root: ConfigContainerChild, parentId: string, index: number, sizes: [number, number], axis: GridAxis) => ConfigContainerChild;
+/**
+ * Итог перетаскивания нижней границы сетки: своя высота корня плюс новые доли всех строк.
+ *
+ * Доли обязаны пересчитаться вместе с высотой: тянут границу последней строки, и остальные при
+ * этом должны остаться той же величины в пикселях, а не разъехаться пропорционально новой высоте.
+ */
+export declare const resizeGridHeight: (root: ConfigContainerChild, height: string, sizes: number[]) => ConfigContainerChild;

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

@@ -0,0 +1,33 @@
+import { CssSize, ConfigContainerChild } from '../../types';
+import { GridAxis } from '../types';
+/**
+ * Дети, которые реально становятся треками.
+ *
+ * `ContainerChildren` не рендерит слоты заголовка, поэтому и в `grid-template-*` их быть не
+ * должно — иначе треков окажется больше, чем ячеек, и раскладка съедет.
+ */
+export declare const getLayoutChildren: (node?: ConfigContainerChild) => ConfigContainerChild[];
+/** Опция, в которой лежит доля трека: у строки это высота, у ячейки — ширина. */
+export declare const getTrackSizeKey: (axis: GridAxis) => "height" | "width";
+/**
+ * Доля трека числом.
+ *
+ * Не-`fr` значения (px, проценты, `auto`) сеткой не поддерживаются и считаются за `1fr`:
+ * смешивание фиксированных и резиновых треков сломало бы инвариант ресайза «сумма долей пары
+ * неизменна». Единица модели — только `fr`.
+ */
+export declare const parseFrValue: (size?: CssSize) => number;
+/** Доли всех треков одного родителя в порядке следования. */
+export declare const getTrackSizes: (children: ConfigContainerChild[], axis: GridAxis) => number[];
+/** Округление доли — иначе в конфиг попадают хвосты вида `1.0000000000000002fr`. */
+export declare const roundFr: (value: number) => number;
+export declare const toFrSize: (value: number) => string;
+/**
+ * Значение `grid-template-*` из готовых размеров треков.
+ *
+ * `minmax(0, X)` вместо голого размера: голый трек имеет неявный минимум `auto`, и широкий контент
+ * (таблица, график) распирает его изнутри, ломая заданные пропорции.
+ */
+export declare const buildTrackTemplate: (sizes: string[]) => string;
+/** Значение `grid-template-rows` / `grid-template-columns` по долям детей. */
+export declare const buildGridTemplate: (children: ConfigContainerChild[], axis: GridAxis) => string;

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

@@ -0,0 +1,58 @@
+import { ConfigContainerChild } from '../../types';
+import { GridAxis } from '../types';
+import { GridIdFactory } from './createGridNodeId';
+/** Узел-сетка: `ContainersGroup`, у которого включена опция `grid`. */
+export declare const isGridNode: (node?: ConfigContainerChild) => boolean;
+/**
+ * Подменяет «раскладочных» детей узла, сохраняя слоты заголовка.
+ *
+ * Слоты кладутся первыми: их порядок относительно тела ни на что не влияет — тело их отфильтровывает,
+ * а `ExpandableTitle` ищет по `id`.
+ */
+export declare const setLayoutChildren: (node: ConfigContainerChild, children: ConfigContainerChild[]) => ConfigContainerChild;
+/**
+ * Иммутабельно применяет `mapper` к узлу с заданным `id` где угодно в поддереве.
+ *
+ * `null` из `mapper` удаляет узел. Ветки без изменений возвращаются по прежней ссылке — так
+ * `memo`-контейнеры незатронутых поддеревьев не перерисовываются.
+ */
+export declare const mapNodeById: (node: ConfigContainerChild, id: string, mapper: (found: ConfigContainerChild) => ConfigContainerChild | null) => ConfigContainerChild;
+/** Есть ли в поддереве узел с таким `id`. */
+export declare const containsNodeId: (node: ConfigContainerChild, id: string) => boolean;
+/**
+ * Иммутабельно подменяет сразу несколько узлов — по одному вхождению на каждый `id`.
+ *
+ * Именно за один проход, а не несколькими `mapNodeById` подряд: при обмене двух узлов местами
+ * после первой замены на месте источника уже лежит узел с `id` цели, и следующий проход нашёл бы
+ * его же — оба места достались бы одному узлу. Внутрь подменённого узла обход не спускается:
+ * он приходит готовым.
+ */
+export declare const replaceNodesByIds: (node: ConfigContainerChild, replacements: Record<string, ConfigContainerChild>) => ConfigContainerChild;
+/** Где находится ячейка: её строка, сетка-владелец строки и позиция в строке. */
+export interface GridCellContext {
+    grid: ConfigContainerChild;
+    row: ConfigContainerChild;
+    rows: ConfigContainerChild[];
+    cells: ConfigContainerChild[];
+    rowIndex: number;
+    cellIndex: number;
+}
+/** Ищет ячейку по всему дереву сеток, включая вложенные. Возвращает ближайший к ней контекст. */
+export declare const findCellContext: (grid: ConfigContainerChild, cellId: string) => GridCellContext | null;
+/** Задать долю трека узлу. */
+export declare const withTrackSize: (node: ConfigContainerChild, axis: GridAxis, value: number) => ConfigContainerChild;
+/** Доля трека узла. */
+export declare const getTrackSize: (node: ConfigContainerChild, axis: GridAxis) => number;
+/** Средняя доля треков — база для вновь добавляемого, чтобы он не выбивался из масштаба. */
+export declare const getAverageTrackSize: (tracks: ConfigContainerChild[], axis: GridAxis) => number;
+/**
+ * Убирает треки по индексам, отдавая их доли соседу слева (у первого трека — соседу справа).
+ *
+ * Без передачи доли `fr` перенормируются сами, и вместе с удалённым треком визуально сместятся
+ * все остальные границы.
+ */
+export declare const removeTracks: (tracks: ConfigContainerChild[], indexes: number[], axis: GridAxis) => ConfigContainerChild[];
+/** Пустая ячейка сетки. */
+export declare const createGridCell: (factory: GridIdFactory, width?: number) => ConfigContainerChild;
+/** Строка сетки с уже вложенными ячейками (по умолчанию — одна пустая). */
+export declare const createGridRow: (factory: GridIdFactory, cells?: ConfigContainerChild[], height?: number) => ConfigContainerChild;

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

@@ -0,0 +1,13 @@
+/** Ячейка сетки, найденная в DOM. */
+export interface GridCellElement {
+    id: string;
+    element: HTMLElement;
+}
+/**
+ * Ячейка под точкой экрана.
+ *
+ * Ячейки вкладываются друг в друга, поэтому `closest` от верхнего элемента даёт самую глубокую из
+ * них — то же правило, что у выделения кликом. Строки маркера не несут: обмен определён только на
+ * ячейках, и попадание курсора в зазор строки целью не считается.
+ */
+export declare const readCellAtPoint: (x: number, y: number) => GridCellElement | null;

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

@@ -0,0 +1,16 @@
+import { GridAxis } from '../types';
+export declare const getTemplateProperty: (axis: GridAxis) => "gridTemplateRows" | "gridTemplateColumns";
+/**
+ * Пиксельные размеры треков отрисованной сетки.
+ *
+ * Берём computed-значение `grid-template-*`: у отрисованного грида браузер отдаёт уже
+ * разрешённый список used values в пикселях, причём БЕЗ зазоров — то есть сумма пары треков
+ * соответствует сдвигу курсора один в один.
+ *
+ * Прямоугольники самих ячеек для этого не годятся: они не равны треку, если у ячейки задан свой
+ * `width`, есть `margin` или отключён `stretch`.
+ *
+ * `null` — значение не разрешилось в пиксели (например, грид скрыт `display: none`): в этом
+ * случае считать доли не по чему, и ресайз должен просто не начинаться.
+ */
+export declare const readTrackPixels: (grid: HTMLElement, axis: GridAxis) => number[] | null;

package/dist/components/Dashboard/hooks/useWidgetContext.d.ts

@@ -36,6 +36,7 @@ export declare const useWidgetContext: <T extends WidgetType = WidgetType.Dashbo
     selectAttachmentsFromCatalog: (onApply: (resources: import('@evergis/api').CatalogResourceDc[]) => void) => void;
     config: import('../types').ConfigContainer;
     isEditing: boolean;
+    onContainerChange: (config: import('../types').ConfigContainerChild) => void;
     isLoading: boolean;
     pageIndex: number;
     filters: import('../types').SelectedFilters;

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

@@ -179,6 +179,25 @@ export interface ConfigLayoutOptions {
     radius?: number;
     cornerRadius?: number;
     column?: boolean;
+    /**
+     * Превращает `ContainersGroup` в CSS-сетку: его дети трактуются как строки
+     * ({@link ContainerTemplate.GridRow}), дети строк — как ячейки (снова `ContainersGroup`),
+     * и любая ячейка может включить `grid` у себя — вложенность не ограничена.
+     *
+     * Доли треков берутся из детей: `options.height` строки и `options.width` ячейки в `fr`
+     * (`"2fr"`). Сам узел долю не применяет — её собирает родитель в `grid-template-*`.
+     */
+    grid?: boolean;
+    /**
+     * Режим редактирования РАСКЛАДКИ сетки: перетаскивание границ, выделение ячеек,
+     * контекстное меню с объединением/разделением/удалением. Читается только у внешнего
+     * узла с `grid`; вложенные сетки наследуют режим через контекст.
+     *
+     * Не путать с `editMode` у `DashboardProvider`/`FeatureCardProvider` (в контейнерах —
+     * `isEditing`): тот переключает редактирование АТРИБУТОВ объекта и к раскладке отношения
+     * не имеет.
+     */
+    editMode?: boolean;
     twoColumns?: boolean;
     /** Вписать график контейнера Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
     fill?: boolean;
@@ -562,6 +581,7 @@ export declare enum ContainerTemplate {
     Pages = "Pages",
     Pagination = "Pagination",
     ContainersGroup = "ContainersGroup",
+    GridRow = "GridRow",
     DefaultAttributes = "DefaultAttributes",
     Tabs = "Tabs",
     Attribute = "Attribute",
@@ -634,6 +654,7 @@ export interface ContainerProps {
     index?: number;
     innerComponent?: FC<InnerContainerProps>;
     renderElement?: RenderElementFunction;
+    onChange?: (config: ConfigContainerChild) => void;
 }
 export type PieChartDisplayedData = Array<Omit<PieChartData, "value"> & {
     value: string | number;

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

@@ -1,2 +1,2 @@
 import { GetRenderElementProps, RenderElementFunction } from '../types';
-export declare const getRenderElement: ({ t, config, elementConfig, attributes, layerInfo, selectedTabId, setSelectedTabId, pageIndex, expandedContainers, type, }: GetRenderElementProps) => RenderElementFunction;
+export declare const getRenderElement: ({ t, config, elementConfig, attributes, layerInfo, selectedTabId, setSelectedTabId, pageIndex, expandedContainers, onChange, type, }: GetRenderElementProps) => RenderElementFunction;

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

@@ -18,6 +18,8 @@ export interface WrapperSizeParams {
     defaultWidth?: CssSize;
 }
 export declare const isFillSize: (size?: CssSize) => boolean;
+/** Доля трека сетки: `"2fr"`, `"1.5fr"`. */
+export declare const isFrSize: (size?: CssSize) => boolean;
 /**
  * CSS-объект корневой обёртки контейнера: внутренние дефолты плюс размеры из `options`.
  *
@@ -29,7 +31,10 @@ export declare const isFillSize: (size?: CssSize) => boolean;
  * (`min-width`/`min-height: 0`). Для fill-высоты добавляется `flex: 1 1 auto` — в колонке
  * контейнер забирает остаток ячейки под заголовком, а не переполняет её на его высоту.
  *
+ * Размер в `fr` (`"2fr"`) — это доля трека сетки, адресованная родителю, а не самому узлу;
+ * здесь он превращается в тот же fill-режим (см. {@link isFrSize}).
+ *
  * `overflow` уходит в CSS как есть и ничем не подменяется: не задан — работает браузерный
  * `visible`, то есть контент крупнее бокса вытекает на соседние слоты.
  */
-export declare const getWrapperSizeStyle: ({ style, width: widthOption, height, overflow, defaults, defaultWidth, }: WrapperSizeParams) => CSSObject | undefined;
+export declare const getWrapperSizeStyle: ({ style, width: widthOption, height: heightOption, overflow, defaults, defaultWidth, }: WrapperSizeParams) => CSSObject | undefined;

package/dist/constants/styling.d.ts

@@ -11,6 +11,7 @@ export declare const DEFAULT_CIRCLE_STROKE_WIDTH = 0;
 export declare const DEFAULT_LINE_WIDTH = 1;
 export declare const DEFAULT_LINE_CAP = "butt";
 export declare const DEFAULT_LINE_JOIN = "miter";
+export declare const DEFAULT_SYMBOL_COLOR = "#000000";
 export declare const DEFAULT_SYMBOL_PLACEMENT = "point";
 export declare const DEFAULT_SYMBOL_SPACING = 250;
 export declare const DEFAULT_ICON_OVERLAP = "never";

package/dist/contexts/DashboardContext/types.d.ts

@@ -1,6 +1,6 @@
 import { FC, PropsWithChildren } from 'react';
 import { CatalogResourceDc, ExtendedProjectInfoDc, QueryLayerServiceInfoDc } from '@evergis/api';
-import { ConfigContainer, DashboardLayerPayload, DashboardState, LayerItemProps, SelectedFilters, WidgetDataSource } from '../../components';
+import { ConfigContainer, ConfigContainerChild, DashboardLayerPayload, DashboardState, LayerItemProps, SelectedFilters, WidgetDataSource } from '../../components';
 export type DashboardContextProps = PropsWithChildren<{
     config?: ConfigContainer;
     containerIds?: string[];
@@ -11,7 +11,16 @@ export type DashboardContextProps = PropsWithChildren<{
     dataSources?: WidgetDataSource[];
     geometryFilter?: boolean;
     loading?: boolean;
+    /** Режим редактирования АТРИБУТОВ объекта (в контейнерах — `isEditing`), не раскладки. */
     editMode?: boolean;
+    /**
+     * Контейнер изменил собственный конфиг — хост сохраняет его у себя.
+     *
+     * Источник сейчас один: сетка (`options.grid` + `options.editMode`) после перетаскивания
+     * границ или операции над ячейками. Узел приходит целиком и уже с новым содержимым, его `id`
+     * лежит внутри — применяется как `replaceObject(config, { id }, next)`.
+     */
+    onContainerChange?: (config: ConfigContainerChild) => void;
     filters?: SelectedFilters;
     dashboardLayers?: DashboardState["layers"];
     setDashboardLayer?: (props: DashboardLayerPayload) => void;

package/dist/contexts/FeatureCardContext/types.d.ts

@@ -1,6 +1,6 @@
 import { PropsWithChildren } from 'react';
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-import { ClientFeatureAttribute, ConfigContainer, EditAttributeValue, SelectedFilters, WidgetDataSource } from '../../components';
+import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, EditAttributeValue, SelectedFilters, WidgetDataSource } from '../../components';
 import { SelectedFeature } from '../../types';
 export type FeatureCardContextSettings = PropsWithChildren<{
     config?: ConfigContainer;
@@ -9,7 +9,10 @@ export type FeatureCardContextSettings = PropsWithChildren<{
     feature?: SelectedFeature;
     pageIndex?: number;
     isRaster?: boolean;
+    /** Режим редактирования АТРИБУТОВ объекта (в контейнерах — `isEditing`), не раскладки. */
     editMode?: boolean;
+    /** Контейнер изменил собственный конфиг — см. одноимённый проп `DashboardProvider`. */
+    onContainerChange?: (config: ConfigContainerChild) => void;
     isFeatureEditable?: boolean;
     hasCopyRights?: boolean;
     editOnly?: boolean;