@evergis/react 4.0.166 → 4.0.167

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

@@ -1,3 +1,4 @@
+import { ActionEventData, ConfigActionDefinition, ConfigActionInvocation } from './actions/types';
 import { CSSProperties, FC, ReactNode } from 'react';
 import { FeatureCollection, Geometry } from 'geojson';
 import { i18n } from 'i18next';
@@ -301,7 +302,9 @@ export interface ConfigLayoutOptions {
      * Игнорируется при `twoColumns` (легенда справа) и при отсутствии подписи оси X.
      */
     legendInline?: boolean;
-    /** Вписать график контейнера Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
+    /**
+     * Вписать график Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain).
+     */
     fill?: boolean;
     /**
      * Горизонтальное выравнивание: содержимого заголовка контейнера, а для плиток
@@ -760,6 +763,9 @@ export interface ConfigFilter {
     resetFilters?: string[];
 }
 export interface FilterItem {
+    eventData?: ActionEventData;
+    syntheticOther?: boolean;
+    rawName?: string;
     name: string;
     value: string | number;
     color: string;
@@ -788,7 +794,7 @@ export type TreeFilterValue = Record<string, Array<string | number>>;
  */
 export type FeaturesFilterValue = FeatureCollection<null, Record<string, FeatureAttributeValue>>;
 export interface SelectedFilter {
-    value: string | number | string[] | number[] | Date | Date[] | TreeFilterValue | FeaturesFilterValue;
+    value: string | number | boolean | string[] | number[] | Date | Date[] | TreeFilterValue | FeaturesFilterValue;
     min?: string | number | Date;
     max?: string | number | Date;
 }
@@ -800,8 +806,8 @@ export interface ConfigLayer {
     opacity?: number;
     condition?: string | string[];
     query?: string;
-    parameters?: Record<string, any>;
-    geometries?: Array<any>;
+    parameters?: Record<string, unknown>;
+    geometries?: unknown[];
     isVisible?: boolean;
     selectable?: boolean;
     filterZoomTo?: boolean;
@@ -824,7 +830,7 @@ export interface ConfigTask {
     alias?: string;
     description?: string;
     icon?: string;
-    params?: Record<string, any>;
+    params?: Record<string, unknown>;
     subType?: string;
     resourceId?: string;
     owner?: string;
@@ -870,6 +876,7 @@ export interface ConfigModal {
     id: string;
     options?: ConfigModalOptions;
     dataSources?: ConfigDataSource[];
+    actions?: ConfigActionDefinition[];
     children: ConfigModalContentItem[];
 }
 export interface ConfigContainerHeader {
@@ -880,6 +887,7 @@ export interface ConfigContainerHeader {
     options?: ConfigOptions;
 }
 export interface ConfigContainer {
+    actions?: ConfigActionDefinition[];
     layers?: ConfigLayer[];
     children: ConfigContainerChild[];
     dataSources?: ConfigDataSource[];
@@ -904,7 +912,8 @@ export type FilterType = "checkbox" | "rangeNumber" | "rangeDate" | "text" | "dr
  * `id`, см. parent-specific child-типы.
  */
 export type ConfigElementType = "text" | "attributeAlias" | "attributeValue" | "attributeUnits" | "attributeDescription" | "layerName" | "control" | "image" | "slideshow" | "svg" | "icon" | "tooltip" | "tags" | "link" | "button" | "camera" | "chart" | "legend" | "markdown" | "uploader" | "modal" | "table";
-export interface ConfigContainerChild extends Partial<ConfigContainer> {
+export interface ConfigContainerChild extends Omit<Partial<ConfigContainer>, "actions"> {
+    actions?: (ConfigActionDefinition | ConfigActionInvocation)[];
     id?: string;
     /**
      * Узел-лист. Кроме элементов сюда попадают фильтры — дети FiltersContainer тоже узлы конфига,
@@ -1021,6 +1030,9 @@ export interface ContainerProps {
 }
 export type PieChartDisplayedData = Array<Omit<PieChartData, "value"> & {
     value: string | number;
+    eventData?: ActionEventData;
+    syntheticOther?: boolean;
+    rawName?: string;
 }>;
 export type DataSourcePromise = PromiseSettledResult<EqlDataSource | PagedFeaturesListDc>;
 export interface FetchedDataSource {

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

@@ -1,8 +1,9 @@
 import { QueryLayerServiceInfoDc } from '@evergis/api';
 import { ClientFeatureAttribute, ConfigFilter, SelectedFilters, WidgetDataSource } from '../types';
-import { ConfigFilterStore } from './configString/types';
-export declare const applyQueryFilters: ({ parameters: configParameters, filters: configFilters, selectedFilters, dashboard, geometry, extent, zoomLevel, projectName, projectAlias, attributes, layerInfo, dataSources, }: {
-    parameters: Record<string, any>;
+import { ConfigFilterStore, ConfigStringSources } from './configString/types';
+export declare const applyQueryFilters: ({ contextSources, parameters: configParameters, filters: configFilters, selectedFilters, dashboard, geometry, extent, zoomLevel, projectName, projectAlias, attributes, layerInfo, dataSources, }: {
+    contextSources?: ConfigStringSources;
+    parameters: Record<string, unknown>;
     filters: ConfigFilter[];
     selectedFilters?: SelectedFilters;
     dashboard?: ConfigFilterStore;
@@ -14,4 +15,4 @@ export declare const applyQueryFilters: ({ parameters: configParameters, filters
     attributes?: ClientFeatureAttribute[];
     layerInfo?: QueryLayerServiceInfoDc;
     dataSources: WidgetDataSource[];
-}) => Record<string, Record<string, any>>;
+}) => Record<string, unknown>;

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

@@ -1 +1 @@
-export declare const checkEqualOrIncludes: <T extends string | number | Date>(arrayOrSingle: T | T[], value: T) => boolean;
+export declare const checkEqualOrIncludes: <T extends string | number | boolean | Date>(arrayOrSingle: T | T[], value: T) => boolean;

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

@@ -0,0 +1,19 @@
+export declare const FILTER_PREFIX = "%";
+export declare const PROVIDER_PREFIX = "$";
+export declare enum ProviderPrefix {
+    /** `$card:<слой>:<поле>` — атрибут объекта карточки. */
+    Card = "card",
+    /**
+     * Ближайший дашборд, в ряд к `%` своего виджета: `$dashboard:<фильтр>[.свойство]` — его фильтр,
+     * `$dashboard:<датасорс>:<поле>` — поле первой строки его датасорса.
+     */
+    Dashboard = "dashboard"
+}
+/**
+ * Все подстановки строки конфига одной грамматикой, по группам:
+ * 1–2 `$dashboard:<датасорс>:<поле>`, 3–4 `$dashboard:<фильтр>[.свойство]`, 5–6 `$card:<слой>:<поле>`,
+ * 7–8 `%<фильтр>[.свойство]`, 9 `{<атрибут>}`. Форма датасорса проверяется раньше формы фильтра:
+ * их различает второе двоеточие. Имя фильтра — `\w+` целиком, поэтому `%name` не цепляет начало
+ * `%name2`, а точка в конце предложения («за %year.») не считается свойством.
+ */
+export declare const CONFIG_TOKEN_REGEXP: RegExp;

package/dist/components/Dashboard/utils/configString/resolveActionToken.d.ts

@@ -0,0 +1,3 @@
+import { ConfigActionToken, ConfigStringSources, ResolvedConfigToken } from './types';
+/** #field берётся из первой feature ответа задачи; $event/$params — из локального контекста цепочки. */
+export declare const resolveActionToken: (token: ConfigActionToken, sources: ConfigStringSources) => ResolvedConfigToken;

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

@@ -8,6 +8,9 @@ export type ConfigFilterStore = {
 };
 /** Всё, откуда строка конфига может взять значение. Префикс токена выбирает стор. */
 export type ConfigStringSources = {
+    taskResponse?: unknown;
+    event?: Record<string, unknown>;
+    parameters?: Record<string, unknown>;
     /** `%name` — фильтры своего виджета (в карточке — фильтры карточки). */
     widget?: ConfigFilterStore;
     /**
@@ -54,7 +57,13 @@ export type ConfigAttributeToken = {
     name: string;
     raw: string;
 };
-export type ConfigToken = ConfigFilterToken | ConfigCardToken | ConfigDataSourceToken | ConfigAttributeToken;
+export type ConfigActionToken = {
+    kind: "action";
+    scope: "result" | "event" | "parameters";
+    path: string;
+    raw: string;
+};
+export type ConfigToken = ConfigActionToken | ConfigFilterToken | ConfigCardToken | ConfigDataSourceToken | ConfigAttributeToken;
 /** Строка конфига, разобранная на литералы и токены. */
 export type ConfigStringSegment = string | ConfigToken;
 /**

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

@@ -0,0 +1,3 @@
+import { ConfigContainerChild } from '../types';
+/** Обходим только ветви разметки; действия, параметры, объекты данных и прочие метаданные пропускаем. */
+export declare const findDashboardNode: (root: unknown, id: string | undefined) => ConfigContainerChild | undefined;

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

@@ -1,7 +1,8 @@
 import { QueryLayerServiceConfigurationDc } from '@evergis/api';
 import { ClientFeatureAttribute, ConfigFilter, SelectedFilters, WidgetDataSource } from '../types';
-import { ConfigFilterStore } from './configString/types';
+import { ConfigFilterStore, ConfigStringSources } from './configString/types';
 type FormatDataSourceConditionParams = {
+    contextSources?: ConfigStringSources;
     configFilters?: ConfigFilter[];
     filters: SelectedFilters;
     /** Датасорсы виджета — для `%name.prop` через `relatedDataSource` фильтра. */

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

@@ -1,4 +1,4 @@
 import { i18n } from 'i18next';
 import { PieChartData } from '@evergis/charts';
-import { ClientFeatureAttribute, ConfigContainerChild } from '../types';
-export declare const getDataFromAttributes: (t: i18n["t"], config: ConfigContainerChild, attributes?: ClientFeatureAttribute[]) => PieChartData[];
+import { ClientFeatureAttribute, ConfigContainerChild, FilterItem } from '../types';
+export declare const getDataFromAttributes: (t: i18n["t"], config: ConfigContainerChild, attributes?: ClientFeatureAttribute[]) => (PieChartData & Partial<FilterItem>)[];

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

@@ -1,2 +1,2 @@
 import { SelectedFilter, SelectedFilters } from '../types';
-export declare const getSelectedFilterValue: (filterName: string, selectedFilters: SelectedFilters, defaultValue: SelectedFilter["value"]) => string | number | Date | import('../types').TreeFilterValue | import('../types').FeaturesFilterValue | (string | number | Date | import('../types').TreeFilterValue | import('../types').FeaturesFilterValue)[];
+export declare const getSelectedFilterValue: (filterName: string, selectedFilters: SelectedFilters, defaultValue: SelectedFilter["value"]) => string | number | boolean | Date | import('../types').TreeFilterValue | import('../types').FeaturesFilterValue | (string | number | boolean | Date | import('../types').TreeFilterValue | import('../types').FeaturesFilterValue)[];

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

@@ -0,0 +1,2 @@
+import { ConfigDataSource, DataSourcePromise, FetchedDataSource } from '../types';
+export declare const getUpdatedDataSources: (responses: DataSourcePromise[], currentDataSources: ConfigDataSource[], otherDataSources: FetchedDataSource[]) => any;

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

@@ -85,3 +85,4 @@ export * from './toRenderableValue';
 export * from './tooltipNameFromAttributes';
 export * from './tooltipValueFromAttributes';
 export * from './tooltipValueFromRelatedFeatures';
+export * from './findDashboardNode';

package/dist/contexts/ActionContext/index.d.ts

@@ -0,0 +1,3 @@
+import { ActionExecutionContext } from '../../components/Dashboard/actions/types';
+import { WidgetType } from '../../components/Dashboard/types';
+export declare const ActionContext: import('react').Context<Partial<Record<WidgetType, ActionExecutionContext>>>;

package/dist/contexts/ActionNodeContext/index.d.ts

@@ -0,0 +1,2 @@
+import { ActionNodeValue } from '../../components/Dashboard/actions/context/bindingTypes';
+export declare const ActionNodeContext: import('react').Context<ActionNodeValue>;

package/dist/contexts/ActionScopeContext/index.d.ts

@@ -0,0 +1,3 @@
+import { ActionScopeValue } from '../../components/Dashboard/actions/context/bindingTypes';
+import { WidgetType } from '../../components/Dashboard/types';
+export declare const ActionScopeContext: import('react').Context<Partial<Record<WidgetType, ActionScopeValue>>>;

package/dist/contexts/ChartActionsContext/index.d.ts

@@ -0,0 +1,2 @@
+import { ConfigContainerChild } from '../../components/Dashboard/types';
+export declare const ChartActionsContext: import('react').Context<ConfigContainerChild>;

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

@@ -1,3 +1,6 @@
+import { ActionNavigationFactory } from '../../components/Dashboard/actions/context/WidgetActionsProvider/types';
+import { ConfigDataSource } from '../../components/Dashboard/types';
+import { WidgetModalSnapshot } from '../../components/Dashboard/actions/modals/types';
 import { FC, PropsWithChildren } from 'react';
 import { CatalogResourceDc, ExtendedProjectInfoDc, QueryLayerServiceInfoDc } from '@evergis/api';
 import { ConfigContainer, ConfigContainerChild, DashboardLayerPayload, DashboardState, LayerItemProps, SelectedFilters, WidgetDataSource } from '../../components';
@@ -21,13 +24,19 @@ export type DashboardContextProps = PropsWithChildren<{
      * лежит внутри — применяется как `replaceObject(config, { id }, next)`.
      */
     onContainerChange?: (config: ConfigContainerChild) => void;
-    /**
-     * Модалка `config.modals[].id` открылась или закрылась — хост грузит её `dataSources`, пока она
-     * открыта. Видимостью диалога управляет сам `ElementModal`: у одного `modalId` бывает несколько
-     * кнопок (слот `modal` в строках `DataSource`), общий флаг открыл бы все диалоги сразу.
-     */
-    onModalToggle?: (modalId: string, isOpen: boolean) => void;
+    /** События жизненного цикла модалок. Управляемые окна используют общий хост и отдельную область данных. */
+    isModalNotificationAllowed?: (senderName: string | undefined, source: ConfigDataSource, layerName: string) => boolean;
+    onModalContextChange?: (modalId: string, snapshot: WidgetModalSnapshot | null) => void;
+    onModalToggle?: (modalId: string, isOpen: boolean, metadata?: {
+        managed: boolean;
+    }) => void;
     filters?: SelectedFilters;
+    /** Синхронный снимок фильтров для последовательных действий. */
+    actionNavigation?: ActionNavigationFactory;
+    getActionFilters?: () => SelectedFilters;
+    /** Меняется при переходе на другую страницу, проект или карточку. */
+    actionContextKey?: string;
+    actionsActive?: boolean;
     dashboardLayers?: DashboardState["layers"];
     setDashboardLayer?: (props: DashboardLayerPayload) => void;
     selectedTabId?: string;

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

@@ -1,3 +1,6 @@
+import { ActionNavigationFactory } from '../../components/Dashboard/actions/context/WidgetActionsProvider/types';
+import { ConfigDataSource } from '../../components/Dashboard/types';
+import { WidgetModalSnapshot } from '../../components/Dashboard/actions/modals/types';
 import { PropsWithChildren } from 'react';
 import { QueryLayerServiceInfoDc } from '@evergis/api';
 import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, EditAttributeValue, SelectedFilters, WidgetDataSource } from '../../components';
@@ -14,7 +17,11 @@ export type FeatureCardContextSettings = PropsWithChildren<{
     /** Контейнер изменил собственный конфиг — см. одноимённый проп `DashboardProvider`. */
     onContainerChange?: (config: ConfigContainerChild) => void;
     /** Модалка открылась или закрылась — см. одноимённый проп `DashboardProvider`. */
-    onModalToggle?: (modalId: string, isOpen: boolean) => void;
+    isModalNotificationAllowed?: (senderName: string | undefined, source: ConfigDataSource, layerName: string) => boolean;
+    onModalContextChange?: (modalId: string, snapshot: WidgetModalSnapshot | null) => void;
+    onModalToggle?: (modalId: string, isOpen: boolean, metadata?: {
+        managed: boolean;
+    }) => void;
     isFeatureEditable?: boolean;
     hasCopyRights?: boolean;
     editOnly?: boolean;
@@ -23,6 +30,12 @@ export type FeatureCardContextSettings = PropsWithChildren<{
     dataSources?: WidgetDataSource[];
     loading?: boolean;
     filters?: SelectedFilters;
+    /** Синхронный снимок фильтров для последовательных действий. */
+    actionNavigation?: ActionNavigationFactory;
+    getActionFilters?: () => SelectedFilters;
+    /** Меняется при переходе на другую страницу, проект или карточку. */
+    actionContextKey?: string;
+    actionsActive?: boolean;
     changeFilters?: (filters: SelectedFilters) => void;
     controls?: Record<string, EditAttributeValue>;
     changeControls?: (controls: Record<string, EditAttributeValue>) => void;

package/dist/{components/Dashboard/grid → contexts}/GridEditContext/index.d.ts

@@ -1,4 +1,4 @@
-import { GridEditSessionValue } from '../types';
+import { GridEditSessionValue } from '../../components/Dashboard/grid/types';
 /**
  * Сессия редактирования раскладки. Создаётся ВНЕШНИМ grid-узлом с `options.editMode`;
  * вложенные сетки её только читают, собственный `editMode` у них игнорируется.

package/dist/contexts/ModalDataContext/index.d.ts

@@ -0,0 +1,2 @@
+import { ModalDataOverlay } from '../../components/Dashboard/actions/modals/types';
+export declare const ModalDataContext: import('react').Context<ModalDataOverlay>;

package/dist/{components/Dashboard/containers/StructuredDataContainer/StructuredDataContext.d.ts → contexts/StructuredDataContext/index.d.ts}

@@ -1,4 +1,4 @@
-import { StructuredDataContextValue } from './types';
+import { StructuredDataContextValue } from '../../components/Dashboard/containers/StructuredDataContainer/types';
 /**
  * Канал «контейнер → представление». Схему, строки и колбэки правки держит
  * `StructuredDataContainer`, а рендерит их элемент-представление (`ElementTable`),

package/dist/contexts/TaskExecutionContext/TaskExecutionProvider.d.ts

@@ -0,0 +1,2 @@
+import { FC, PropsWithChildren } from 'react';
+export declare const TaskExecutionProvider: FC<PropsWithChildren>;

package/dist/contexts/TaskExecutionContext/context.d.ts

@@ -0,0 +1,2 @@
+import { TaskExecutionContextValue } from './types';
+export declare const TaskExecutionContext: import('react').Context<TaskExecutionContextValue>;

package/dist/contexts/TaskExecutionContext/hooks/useTaskExecution.d.ts

@@ -0,0 +1,17 @@
+import { PythonExecutionRequest } from '../../../hooks/task/runtime/types';
+export declare const useOptionalTaskExecution: () => {
+    runTask: (request: PythonExecutionRequest) => import('../../../hooks/task/runtime/types').PythonExecutionHandle;
+    entries: import('..').TaskExecutionEntry[];
+    openLog: (runId: string) => void;
+    closeLog: () => void;
+    dismissTask: (runId: string) => void;
+    logRunId: string | null;
+};
+export declare const useTaskExecution: () => {
+    runTask: (request: PythonExecutionRequest) => import('../../../hooks/task/runtime/types').PythonExecutionHandle;
+    entries: import('..').TaskExecutionEntry[];
+    openLog: (runId: string) => void;
+    closeLog: () => void;
+    dismissTask: (runId: string) => void;
+    logRunId: string | null;
+};

package/dist/contexts/TaskExecutionContext/index.d.ts

@@ -0,0 +1,4 @@
+export * from './TaskExecutionProvider';
+export * from './hooks/useTaskExecution';
+export * from './types';
+export * from './context';

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

@@ -0,0 +1,14 @@
+import { PythonExecutionHandle, PythonExecutionRequest } from '../../hooks/task/runtime/types';
+import { ServerNotificationsContextProps } from '../ServerNotificationsContext/types';
+export interface TaskExecutionEntry {
+    handle: PythonExecutionHandle;
+    request: PythonExecutionRequest;
+}
+export interface TaskExecutionContextValue {
+    runTask: (request: PythonExecutionRequest, transport?: ServerNotificationsContextProps) => PythonExecutionHandle;
+    entries: TaskExecutionEntry[];
+    openLog: (runId: string) => void;
+    closeLog: () => void;
+    dismissTask: (runId: string) => void;
+    logRunId: string | null;
+}

package/dist/contexts/TaskExecutionContext/utils/createTaskNotification.d.ts

@@ -0,0 +1,4 @@
+import { INotificationItem } from '@evergis/uilib-gl';
+import { TaskExecutionEntry } from '../types';
+import { GlobalContextProps } from '../../GlobalContext/types';
+export declare const createTaskNotification: ({ handle, request }: TaskExecutionEntry, translate: GlobalContextProps["t"], open: () => void, dismiss: () => void) => INotificationItem;

package/dist/contexts/WidgetActionsContext/index.d.ts

@@ -0,0 +1,4 @@
+import { WidgetActionsValue } from '../../components/Dashboard/actions/context/bindingTypes';
+import { WidgetType } from '../../components/Dashboard/types';
+export declare const WidgetActionsContext: import('react').Context<Partial<Record<WidgetType, WidgetActionsValue>>>;
+export declare const useWidgetActions: (type: WidgetType) => WidgetActionsValue;

package/dist/contexts/WidgetModalsContext/index.d.ts

@@ -0,0 +1,3 @@
+import { WidgetModalManager } from '../../components/Dashboard/actions/modals/types';
+import { WidgetType } from '../../components/Dashboard/types';
+export declare const WidgetModalsContext: import('react').Context<Partial<Record<WidgetType, WidgetModalManager>>>;

package/dist/contexts/index.d.ts

@@ -3,3 +3,15 @@ export * from './FeatureCardContext';
 export * from './GlobalContext';
 export * from './MapContext';
 export * from './ServerNotificationsContext';
+export * from './TaskExecutionContext';
+export * from './WidgetModalsContext';
+export * from './ModalDataContext';
+export * from './ChartActionsContext';
+export * from './WidgetActionsContext';
+export * from './FillContext';
+export * from './ChartPlotContext';
+export * from './StructuredDataContext';
+export * from './GridEditContext';
+export * from './ActionContext';
+export * from './ActionNodeContext';
+export * from './ActionScopeContext';