@evergis/react 4.0.129 → 4.0.131

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

@@ -109,7 +109,7 @@ export interface ElementSvgProps extends Omit<ContainerProps, "elementConfig"> {
     layerInfo?: QueryLayerServiceInfoDc;
     attributes?: ClientFeatureAttribute[];
 }
-export type ElementTableOptions = Pick<ConfigOptions, "columnNames" | "sort">;
+export type ElementTableOptions = Pick<ConfigOptions, "sort" | "width" | "height">;
 export interface ElementTableConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "table";
     options?: ElementTableOptions;

package/dist/components/Dashboard/components/AddButton/styled.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Кнопка «добавить»: серая скруглённая, со значком и подписью. Общая на весь дашборд — вложения
+ * и таблица структурированных данных добавляют одинаковой кнопкой, разница только в значке.
+ *
+ * Размеры сняты с макета (все — в половину его пикселей, макет снят на удвоенной плотности):
+ * высота 24, поля 10, просвет между значком и подписью 6, значок 14, подпись 14.
+ *
+ * Скругление и ширина по содержимому — от самого `IconButton`: он скруглён по умолчанию, а с
+ * подписью в детях перестаёт держать фиксированную ширину. Значок ужат до 0.875rem: свой 1rem
+ * он заполняет краями, и на макете кружок мельче подписи, а не вровень с ней.
+ *
+ * Подпись темнее значка: `IconButton` красит и то и другое цветом иконки, но в макете подпись —
+ * обычный текст (`textPrimary`), а приглушён только значок.
+ */
+export declare const AddButtonRow: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;

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

@@ -1,3 +1,4 @@
+export * from './AddButton/styled';
 export * from './AddFeatureButton';
 export * from './Chart';
 export * from './ChartLegend';

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

@@ -22,6 +22,18 @@ export declare const DEFAULT_CHART_ANGLE = 4;
 export declare const DEFAULT_CHART_HEIGHT = 90;
 export declare const STACK_BAR_TOTAL_HEIGHT = 20;
 export declare const FILTER_PREFIX = "%";
+/** Имя системного геометрического фильтра — выделение, нарисованное пользователем на карте. */
+export declare const GEOMETRY_FILTER_NAME = "geometry";
+/** Имя системного фильтра «экстент видимой области карты» (EWKT, `SRID=3857`). */
+export declare const EXTENT_FILTER_NAME = "extent";
+/** Имя системного фильтра «уровень зума карты» (целое число). */
+export declare const ZOOM_FILTER_NAME = "zoom";
+/**
+ * Системные фильтры текущего вида карты. Их значения приходят не из `SelectedFilters`, а из
+ * `GlobalContext`, поэтому имена зарезервированы: одноимённый пользовательский фильтр будет
+ * перехвачен системной подстановкой — ровно как в случае `geometry`.
+ */
+export declare const MAP_VIEW_FILTER_NAMES: string[];
 export declare const PROVIDER_PREFIX = "$";
 export declare enum ProviderPrefix {
     Card = "card",

package/dist/components/Dashboard/containers/AttachmentContainer/styled.d.ts

@@ -34,6 +34,5 @@ export declare const ListActions: import('styled-components').StyledComponent<"d
 export declare const ListItemContainer: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ShowMoreButton: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const AddButtonContainer: import('styled-components').StyledComponent<"div", any, {}, never>;
-export declare const AddButtonRow: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;
 export declare const HiddenFileInput: import('styled-components').StyledComponent<"input", any, {}, never>;
 export declare const LinkDialogContent: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -1,4 +1,6 @@
 import { AttributeType } from '@evergis/api';
+/** Слот представления: единственный ребёнок контейнера, рисующий данные (элемент `table`). */
+export declare const STRUCTURED_DATA_VIEW_SLOT = "data";
 /**
  * Типы атрибутов с редактором ячейки. Атрибут любого другого типа показывается только на чтение,
  * даже если помечен `isEditable: true` — редактора для него нет.

package/dist/components/Dashboard/containers/StructuredDataContainer/hooks/useStructuredData.d.ts

@@ -9,6 +9,10 @@ import { StructuredDataContextValue } from '../types';
  * Вид источника на права правки не влияет — от него зависит только адресат «Сохранить». Слой
  * принимает запись через features-API, источник без `layerName` (EQL, python-скрипт, внешний
  * url) не принимает ничего, и правка такой таблицы уходит только в фильтр.
+ *
+ * Значение фильтра читается так же, как его читают остальные потребители дашборда: выбор
+ * пользователя, а пока его нет — `defaultValue` из конфига фильтра. Общего стейта, залитого
+ * дефолтами, в дашборде нет, поэтому фолбэк делает каждый потребитель сам.
  */
 export declare const useStructuredData: (type: WidgetType, elementConfig?: StructuredDataContainerConfig) => {
     contextValue: StructuredDataContextValue;

package/dist/components/Dashboard/containers/StructuredDataContainer/styled.d.ts

@@ -14,5 +14,8 @@ export declare const StructuredDataActions: import('styled-components').StyledCo
 /**
  * Область представления. Прокручивается внутри себя, чтобы длинная таблица не растягивала
  * контейнер за пределы отведённой ему ячейки; `min-height: 0` разрешает flex-ребёнку сжиматься.
+ *
+ * Собственный бокс таблицы (`options.width`/`height` представления) живёт внутри и на эту
+ * прокрутку не влияет: он ограничивает саму таблицу, а не отведённое контейнером место.
  */
 export declare const StructuredDataView: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;

package/dist/components/Dashboard/containers/StructuredDataContainer/utils/filterValue.d.ts

@@ -3,8 +3,9 @@ import { DraftRow, StructuredDataAttribute } from '../types';
 /**
  * Строки черновика → значение фильтра `valueType: "features"`.
  *
- * В `properties` попадают ВСЕ атрибуты схемы, а не только показанные колонками: схема и вид
- * разделены, и вид не должен резать данные. Геометрия не поддерживается — `geometry: null`.
+ * В `properties` попадает ровно схема: значения по её атрибутам, включая незаполненные. Лишние
+ * ключи черновика (пришли из источника, остались от прежней схемы) наружу не уходят, а объявленный
+ * атрибут уходит всегда. Геометрия не поддерживается — `geometry: null`.
  */
 export declare const toFeaturesFilterValue: (rows: DraftRow[], schema: StructuredDataAttribute[]) => FeaturesFilterValue;
 /**

package/dist/components/Dashboard/elements/ElementTable/components/TableCell.d.ts

@@ -3,7 +3,7 @@ import { TableCellProps } from '../types';
 /**
  * Ячейка таблицы.
  *
- * Вне фокуса значение всегда показано через `stringFormat` — редактор подставляется по клику.
+ * Вне фокуса значение всегда показано через `stringFormat`, редактор подставляется на фокус.
  * Иначе форматирование (округление, разряды, единицы) пришлось бы дублировать внутри инпута,
  * а вводить в отформатированное поле нельзя.
  */

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

@@ -1,3 +1,8 @@
+/**
+ * Насколько тело таблицы заехало под липкую шапку. Пишется на таблицу при прокрутке, читается
+ * стилем тела: ровно на эту величину тело и отсекается.
+ */
+export declare const HEAD_OVERLAP_VARIABLE = "--table-head-overlap";
 /**
  * Признак времени в шаблоне `stringFormat.format`.
  *

package/dist/components/Dashboard/elements/ElementTable/hooks/useCellEditing.d.ts

@@ -1,15 +1,31 @@
-import { KeyboardEvent } from 'react';
+import { FocusEvent, KeyboardEvent } from 'react';
 /**
- * Режим правки одной ячейки: открывается кликом по значению, закрывается кликом снаружи.
+ * Правка одной ячейки.
  *
- * Закрывать по `blur` нельзя: `DatePicker` уводит фокус из поля уже на клике по иконке
- * календаря — редактор исчезал бы раньше, чем календарь успевал открыться. Поэтому слушаем
- * `mousedown` на документе, а клики внутри портала (`#portal-root`) считаем «своими»:
- * выпадающие слои контролов uilib живут именно там, вне DOM-поддерева ячейки.
+ * Открывает её фокус, а не клик: по таблице ходят Tab-ом, и на каждой ячейке сразу нужно поле
+ * с курсором — кнопка, требующая ещё и Enter, ломала бы весь проход.
+ *
+ * Поэтому состояний три. `focused` — ячейка под фокусом с закрытым редактором, состояние после
+ * Enter/Escape: фокус возвращается на кнопку, но правку заново не открывает (иначе выйти из неё
+ * было бы нечем), а Tab с неё идёт дальше по таблице.
+ *
+ * Закрывать правку по любому уходу фокуса нельзя: DatePicker уводит его из поля уже на клике по
+ * иконке календаря — редактор исчезал бы раньше, чем календарь успевал открыться. Клавиатурный
+ * уход видно по `relatedTarget` (фокус ушёл на соседнюю ячейку), мышиный ловит `mousedown`
+ * снаружи. Клики внутри портала (`#portal-root`) считаем «своими»: выпадающие слои контролов
+ * uilib живут именно там, вне DOM-поддерева ячейки.
  */
 export declare const useCellEditing: () => {
     editing: boolean;
-    editorRef: import('react').MutableRefObject<HTMLDivElement>;
-    startEditing: () => void;
-    onKeyDown: ({ key }: KeyboardEvent<HTMLDivElement>) => void;
+    buttonProps: {
+        ref: import('react').MutableRefObject<HTMLButtonElement>;
+        onFocus: () => void;
+        onBlur: () => void;
+        onClick: () => void;
+    };
+    editorProps: {
+        ref: import('react').MutableRefObject<HTMLDivElement>;
+        onBlur: ({ relatedTarget }: FocusEvent<HTMLDivElement>) => void;
+        onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
+    };
 };

package/dist/components/Dashboard/elements/ElementTable/hooks/useHeadOverlap.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Отсечка тела таблицы по нижней кромке липкой шапки.
+ *
+ * Шапка прозрачная — фон контейнера виден сквозь неё, и красить её нечем: цвет контейнера задаётся
+ * конфигом и меняется. Значит, строки не должны под неё заезжать в принципе. Тело для этого
+ * отсекается (`clip-path`) ровно на то, на сколько шапка его накрыла: низ шапки минус верх тела.
+ *
+ * Разница считается по факту, а не по величине прокрутки: она одинаково верна и когда прокручивает
+ * собственный бокс таблицы, и когда её прокручивает область представления контейнера. Пока
+ * не прокручено, низ шапки совпадает с верхом тела — отсекать нечего.
+ *
+ * Прокрутка не всплывает, но проходит фазу перехвата, поэтому слушаем документ: какой именно
+ * предок прокручивается, знать не нужно.
+ */
+export declare const useHeadOverlap: (table: HTMLTableElement | null) => void;

package/dist/components/Dashboard/elements/ElementTable/hooks/useTableView.d.ts

@@ -1,10 +1,17 @@
 import { ElementTableConfig } from '../../../types';
 import { TableSort } from '../types';
 /**
- * Вид таблицы: набор и порядок колонок из `columnNames` плюс локальная сортировка.
+ * Вид таблицы: колонки плюс локальная сортировка.
+ *
+ * Набор и порядок колонок — это схема контейнера (`attributesDescription`) как есть: показываем
+ * ровно то, что описано, и в том же порядке. Своего отбора у представления нет — иначе описанный
+ * атрибут и видимая колонка расходились бы, а в фильтр всё равно уходят все атрибуты схемы.
  *
  * Сортировка живёт здесь, а не в контейнере: она ничего не меняет в данных и не должна
  * влиять на порядок строк, уходящих в фильтр.
+ *
+ * `width`/`height` — размер собственного бокса таблицы: он ограничивает её саму и прокручивает
+ * то, что не влезло. Место, отведённое контейнеру, задаётся его же опциями и живёт отдельно.
  */
 export declare const useTableView: (elementConfig?: ElementTableConfig) => {
     context: import('../../../containers/StructuredDataContainer/types').StructuredDataContextValue;
@@ -12,5 +19,7 @@ export declare const useTableView: (elementConfig?: ElementTableConfig) => {
     rows: import('../../../containers/StructuredDataContainer/types').DraftRow[];
     sort: TableSort;
     sortEnabled: boolean;
+    sizeCss: import('styled-components').CSSObject;
+    contentWidth: boolean;
     onSortToggle: (attributeName: string) => void;
 };

package/dist/components/Dashboard/elements/ElementTable/styled.d.ts

@@ -1,15 +1,59 @@
-export declare const TableWrapper: import('styled-components').StyledComponent<"table", any, {}, never>;
+import { ContainerRootProps } from '../../styled';
+/**
+ * Собственный бокс таблицы. Без размеров в `options` представления узел ничего не меняет:
+ * таблица растёт под содержимое, а прокручивает лишнее область представления контейнера.
+ *
+ * С размерами бокс становится её скролл-контейнером — и липкая шапка липнет уже к нему.
+ */
+export declare const TableBox: import('styled-components').StyledComponent<"div", any, ContainerRootProps, never>;
+/**
+ * Таблица. По умолчанию втискивается в ширину, которую ей дали: колонкам достаётся то, что есть,
+ * а длинные значения режутся многоточием внутри ячейки.
+ *
+ * `$contentWidth` (ширина бокса задана в `options`) переводит её на ширину по содержимому:
+ * колонки встают по своим значениям, предел ячейки снимается, и всё, что не влезло, уходит
+ * в горизонтальную прокрутку бокса. Иначе вышла бы бессмыслица — бокс с прокруткой, а значения
+ * всё равно с многоточием. `min-width` оставляет таблицу растянутой на весь бокс, когда
+ * содержимого на его ширину не набирается.
+ *
+ * Снятый предел ширины ячейки едет вниз css-переменной, а не правилом по `TableCellWrapper`:
+ * ячейка объявлена ниже по файлу, и селектор по ней отсюда попал бы в TDZ.
+ */
+export declare const TableWrapper: import('styled-components').StyledComponent<"table", any, {
+    $contentWidth?: boolean;
+}, never>;
 /**
  * Шапка липнет к верху области прокрутки — при длинной таблице заголовки остаются видны.
  *
- * Собственного фона у шапки нет: цвет из палитры не следовал за подложкой контейнера
- * и выделялся белым прямоугольником на любом фоне, отличном от базового.
+ * Своего фона у неё нет и не должно быть: контейнер дашборда красится цветом из конфига, и любой
+ * назначенный шапке цвет остался бы прямоугольником чужого цвета, как только фон контейнера
+ * поменяли. Под шапкой виден фон контейнера, а строки под неё не заезжают — тело отсечено
+ * (см. TableBody и useHeadOverlap).
  */
 export declare const TableHead: import('styled-components').StyledComponent<"thead", any, {}, never>;
 export declare const TableHeadCell: import('styled-components').StyledComponent<"th", any, {
     $sortable?: boolean;
 }, never>;
 export declare const TableHeadContent: import('styled-components').StyledComponent<"span", any, {}, never>;
+/**
+ * Место под значок сортировки. Занято всегда, пока сортировка включена, а сам значок только
+ * прячется: появляясь и исчезая, он менял бы ширину колонки — и таблицу дёргало бы на каждый
+ * клик по заголовку, вместе с телом. Оба направления рисуются значком в 1rem, поэтому
+ * переключение asc/des ширину тоже не трогает.
+ */
+export declare const TableSortSlot: import('styled-components').StyledComponent<"span", any, {
+    $active?: boolean;
+}, never>;
+/**
+ * Тело таблицы. Отсекается ровно на то, на сколько его накрыла липкая шапка: строки уходят под
+ * её нижнюю кромку и сквозь прозрачную шапку не проступают. Величину пишет {@link useHeadOverlap},
+ * без неё отсечка нулевая и разметка не меняется.
+ */
+export declare const TableBody: import('styled-components').StyledComponent<"tbody", any, {}, never>;
+/**
+ * Строка. Разделитель рисуют её ячейки: собственная рамка строки при раздельных рамках не
+ * рисуется вовсе, а при схлопнутых её рисовала бы таблица — и отсечка тела её бы не резала.
+ */
 export declare const TableRow: import('styled-components').StyledComponent<"tr", any, {}, never>;
 export declare const TableCellWrapper: import('styled-components').StyledComponent<"td", any, {}, never>;
 /** Колонка действий: узкая, не растягивается содержимым. */
@@ -17,7 +61,10 @@ export declare const TableActionsCell: import('styled-components').StyledCompone
 export declare const CellText: import('styled-components').StyledComponent<"div", any, {}, never>;
 /**
  * Редактируемая ячейка вне фокуса. Показывает значение по `stringFormat`, а редактор
- * подставляется по клику — иначе форматирование пришлось бы дублировать внутри инпута.
+ * подставляется на фокус — иначе форматирование пришлось бы дублировать внутри инпута.
+ *
+ * Кнопка, а не просто текст, именно ради фокуса: она — таб-стоп ячейки, и Tab по таблице
+ * открывает редактор с курсором внутри.
  */
 export declare const CellButton: import('styled-components').StyledComponent<"button", any, {}, never>;
 export declare const CellPlaceholder: import('styled-components').StyledComponent<"span", any, {}, never>;

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

@@ -1,6 +1,11 @@
 import { FeatureAttributeValue } from '../../../../types';
 import { DraftRow, StructuredDataAttribute } from '../../containers/StructuredDataContainer/types';
 export type SortDirection = "asc" | "desc";
+/**
+ * Состояние правки ячейки: закрыта, закрыта под фокусом (вышли из редактора по Enter/Escape),
+ * открыт редактор.
+ */
+export type CellMode = "idle" | "focused" | "editing";
 /** Сортировка представления: одна колонка за раз, `null` — исходный порядок строк. */
 export interface TableSort {
     attributeName: string;

package/dist/components/Dashboard/elements/ElementTable/utils/tableBox.d.ts

@@ -0,0 +1,20 @@
+import { CSSObject } from 'styled-components';
+import { CssSize } from '../../../types';
+/**
+ * Css собственного бокса таблицы: размер из `options` представления плюс прокрутка того,
+ * что в этот размер не влез.
+ *
+ * Размеров нет — нет и бокса: таблица занимает столько, сколько просит содержимое, а лишнее,
+ * как и раньше, уходит в прокрутку области представления контейнера.
+ *
+ * Проценты работают только по ширине. Между областью представления и таблицей стоит блочная
+ * обёртка элемента (`ElementValueWrapper`) с высотой `auto`, и `height: "100%"` в ней не
+ * разрешается — вертикальный предел задают конкретные единицы (`240`, `"20rem"`, `"50vh"`),
+ * а «занять всю выданную высоту» остаётся за `options.height` контейнера.
+ *
+ * `contain: inline-size` идёт в пару к fill-ширине: сама по себе она предком не ограничена
+ * (процент от раскладки, которая меряет себя содержимым, вырождается в `auto`), и таблица
+ * распирала бы ряд плиток или трек `auto` изнутри. С containment вклад бокса в ширину предка
+ * обнуляется: ширину он берёт снаружи, а внутрь по ней не смотрят.
+ */
+export declare const getTableBoxStyle: (width?: CssSize, height?: CssSize) => CSSObject | undefined;

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

@@ -9,6 +9,7 @@ export * from './useFetchWithAuth';
 export * from './useChartChange';
 export * from './useChartData';
 export * from './useDashboardHeader';
+export * from './useDataSourceLoading';
 export * from './useDataSources';
 export * from './useDiffPage';
 export * from './useEqualTileWidth';

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

@@ -0,0 +1,2 @@
+import { WidgetType } from '../types';
+export declare const useDataSourceLoading: (type: WidgetType) => boolean;

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

@@ -5,6 +5,8 @@ export declare const useGlobalContext: () => {
     themeName: import('../../..').ThemeName;
     api: import('@evergis/api').Api;
     ewktGeometry: string;
+    ewktExtent: string;
+    zoomLevel: number;
     notification: {
         add: (item: import('@evergis/uilib-gl').INotificationItem) => void;
         update: (patch: Partial<import('@evergis/uilib-gl').INotificationItem> & {

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

@@ -358,12 +358,6 @@ export interface ConfigCollectionOptions {
     otherItems?: number;
     orderByValue?: boolean;
     orderByTitle?: boolean;
-    /**
-     * Имена атрибутов схемы, показываемые колонками представления `table`. Подмножество
-     * `attributesDescription` родительского контейнера; порядок колонок — порядок этого массива.
-     * Не задано — показываются все атрибуты схемы.
-     */
-    columnNames?: string[];
     /** Разрешить сортировку представления кликом по заголовку колонки. Сортировка локальная — только вид. */
     sort?: boolean;
     viewMode?: ViewMode;
@@ -488,6 +482,14 @@ export interface ConfigDataSource {
     url?: string;
     type?: string;
     autoSyncLayer?: boolean;
+    /**
+     * Задержка перед запросом источника, мс. `0` или отсутствие поля — запрос сразу.
+     *
+     * Дебаунсит ЛЮБОЙ перезапрос источника: смену фильтров, движение карты (`%extent` / `%zoom`),
+     * autoSync-уведомления, правку конфига и первичную загрузку. Нужна тяжёлым источникам, чтобы
+     * серия быстрых событий схлопывалась в один запрос.
+     */
+    debounce?: number;
 }
 export interface EqlDataSource {
     items: FeatureDc[];

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

@@ -1,10 +1,12 @@
 import { ClientFeatureAttribute, ConfigFilter, SelectedFilters, WidgetDataSource } from '../types';
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-export declare const applyQueryFilters: ({ parameters: configParameters, filters: configFilters, selectedFilters, geometry, attributes, layerInfo, dataSources, projectDataSources, }: {
+export declare const applyQueryFilters: ({ parameters: configParameters, filters: configFilters, selectedFilters, geometry, extent, zoomLevel, attributes, layerInfo, dataSources, projectDataSources, }: {
     parameters: Record<string, any>;
     filters: ConfigFilter[];
     selectedFilters?: SelectedFilters;
     geometry?: string;
+    extent?: string;
+    zoomLevel?: number;
     attributes?: ClientFeatureAttribute[];
     layerInfo?: QueryLayerServiceInfoDc;
     dataSources: WidgetDataSource[];

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

@@ -9,13 +9,15 @@ export declare const applyFiltersToCondition: ({ condition, name, defaultValue,
     isSetParams?: boolean;
     configFilter?: ConfigFilter;
 }) => string | number;
-export declare const applyVarsToCondition: <T extends string | string[]>({ section, configFilters, filters, attributes, layerParams, eqlParameters, geometry, isSetParams, }: Pick<QueryLayerServiceConfigurationDc, "eqlParameters"> & {
+export declare const applyVarsToCondition: <T extends string | string[]>({ section, configFilters, filters, attributes, layerParams, eqlParameters, geometry, extent, zoomLevel, isSetParams, }: Pick<QueryLayerServiceConfigurationDc, "eqlParameters"> & {
     section: T;
     configFilters: ConfigFilter[];
     filters: SelectedFilters;
     attributes?: ClientFeatureAttribute[];
     layerParams?: Record<string, string>;
     geometry?: string;
+    extent?: string;
+    zoomLevel?: number;
     isSetParams?: boolean;
 }) => T;
 type FormatDataSourceConditionParams = {
@@ -25,6 +27,8 @@ type FormatDataSourceConditionParams = {
     eqlParameters?: QueryLayerServiceConfigurationDc["eqlParameters"];
     layerParams?: Record<string, string>;
     geometry?: string;
+    extent?: string;
+    zoomLevel?: number;
 };
 export declare const formatDataSourceCondition: ({ condition, ...rest }: FormatDataSourceConditionParams & {
     condition?: string | string[];

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

@@ -0,0 +1,7 @@
+import { ConfigDataSource } from '../types';
+/**
+ * Источники, чей запрос зависит от текущего вида карты — в `parameters` или `condition` у них
+ * есть `%extent` / `%zoom`. Перезапрашивают при движении карты только их: иначе каждый пан
+ * дёргал бы все запросы страницы.
+ */
+export declare const getMapViewDataSources: (dataSources?: ConfigDataSource[]) => ConfigDataSource[];

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

@@ -38,6 +38,7 @@ export * from './getFeatureCardHeader';
 export * from './getFilterComponent';
 export * from './getFilterSelectedItems';
 export * from './getFilterValue';
+export * from './getMapViewDataSources';
 export * from './getFormattedAttributes';
 export * from './getImageUrl';
 export * from './getLayerInfo';
@@ -69,6 +70,7 @@ export * from './pieChartTooltipFromRelatedFeatures';
 export * from './removeDataSource';
 export * from './updateDataSource';
 export * from './sliceShownOtherItems';
+export * from './toConditionsArray';
 export * from './toCssSize';
 export * from './toRenderableValue';
 export * from './tooltipNameFromAttributes';

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

@@ -0,0 +1,2 @@
+/** Условие источника задаётся строкой или массивом строк — приводим к массиву для единообразного обхода. */
+export declare const toConditionsArray: (value?: string | string[]) => string[];

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

@@ -7,6 +7,10 @@ export type GlobalContextProps = PropsWithChildren<{
     t?: i18n["t"];
     language?: string;
     ewktGeometry?: string;
+    /** Экстент видимой области карты в EWKT (`SRID=3857;POLYGON((...))`) — плейсхолдер `%extent`. */
+    ewktExtent?: string;
+    /** Целый уровень зума карты — плейсхолдер `%zoom`. */
+    zoomLevel?: number;
     themeName?: ThemeName;
     api?: Api;
     notification?: {