@evergis/react 4.0.130 → 4.0.132

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

@@ -19,6 +19,13 @@ export declare const ChartFillMeasure: import('styled-components').StyledCompone
 export declare const Tooltip: import('styled-components').StyledComponent<"div", any, {
     transform?: CSSProperties["transform"];
 }, never>;
+/**
+ * Тултипы графиков рендерятся в `body` со своим z-index (100 у Bar и Line) — ниже модального окна
+ * `Dialog` из `@evergis/uilib-gl` (110), поэтому в модалке дашборда они уходили под окно. Класс
+ * дублируем, чтобы правило перебило стили `@evergis/charts` по специфичности, а не по порядку
+ * подключения.
+ */
+export declare const ChartTooltipStyles: import('styled-components').GlobalStyleComponent<{}, import('styled-components').DefaultTheme>;
 export declare const LineChartStyles: import('styled-components').GlobalStyleComponent<{
     [x: string]: any;
     [x: number]: any;

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

@@ -1,3 +1,4 @@
+import { CSSProperties } from 'react';
 import { CSSObject } from 'styled-components';
 import { AttributeIconType, AttributeType, QueryLayerServiceInfoDc } from '@evergis/api';
 import { ConfigContainer, ConfigContainerChild, ConfigElementType } from './types';
@@ -22,6 +23,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",
@@ -46,6 +59,20 @@ export declare const DEFAULT_ID_ATTRIBUTE_NAME = "gid";
 export declare const ATTRIBUTE_ICON_ELEMENT_TYPES: Partial<Record<AttributeIconType, ConfigElementType>>;
 /** Заглушка для потребителей, ожидающих non-null layerInfo у источника без описания атрибутов. */
 export declare const EMPTY_DATA_SOURCE_LAYER_INFO: QueryLayerServiceInfoDc;
+/**
+ * z-index плавающих слоёв дашборда: тултипы графиков и выпадающие списки фильтров.
+ *
+ * Тултипы графиков (`@evergis/charts`) и поповеры дропдаунов рендерятся порталом в `body`, где
+ * их собственные z-index (100 у Bar/Line, 103 у Pie) ниже модального окна `Dialog` из
+ * `@evergis/uilib-gl` (110) — внутри модалки дашборда они уходили под окно.
+ */
+export declare const DASHBOARD_OVERLAY_Z_INDEX = 1000;
+/**
+ * Стиль контейнера тултипа `PieChart`: там z-index проставляется инлайном (103), поэтому поднять
+ * его CSS-классом нельзя — только через `tooltipStyle`. Ключ пишем в CSS-нотации: значение уходит
+ * в `d3.selection.style()` → `setProperty`, а camelCase он не понимает.
+ */
+export declare const PIE_CHART_TOOLTIP_STYLE: CSSProperties;
 export declare const DEFAULT_DROPDOWN_WIDTH = 312;
 export declare const DEFAULT_FILTER_PADDING = 12;
 /** Базовый отступ обёртки контейнера. Снимается, когда контейнер занимает ячейку целиком. */

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

@@ -482,6 +482,14 @@ export interface ConfigDataSource {
     url?: string;
     type?: string;
     autoSyncLayer?: boolean;
+    /**
+     * Задержка перед запросом источника, мс. `0` или отсутствие поля — запрос сразу.
+     *
+     * Дебаунсит ЛЮБОЙ перезапрос источника: смену фильтров, движение карты (`%extent` / `%zoom`),
+     * autoSync-уведомления, правку конфига и первичную загрузку. Нужна тяжёлым источникам, чтобы
+     * серия быстрых событий схлопывалась в один запрос.
+     */
+    debounce?: number;
 }
 export interface EqlDataSource {
     items: FeatureDc[];
@@ -500,6 +508,11 @@ export type ConfigFilterValueType = "single" | "range" | "array" | "tree" | "fea
 export interface ConfigFilter {
     name: string;
     relatedDataSource?: string;
+    /**
+     * Значение по умолчанию — подставляется, пока пользователь не выбрал своё.
+     * Для `valueType: "range"` (включая фильтр дат) — пара `[from, to]`: начальный диапазон
+     * и точка сброса; границы шкалы (`minValue` / `maxValue` элемента) при этом не меняются.
+     */
     defaultValue?: SelectedFilter["value"];
     attributeAlias?: string;
     /**

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?: {