@evergis/react 4.0.159 → 4.0.162

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

@@ -537,16 +537,16 @@ export interface FeatureCardSlideshowHeaderConfig extends Omit<ConfigContainerHe
  * Каждая ветвь — `<Name>Config` с литеральным дискриминатором. При наличии `templateName` или `type`
  * у конкретного значения TS сразу сужает union до соответствующей ветви и проверяет поля `options`.
  *
- * Поскольку оба поля помечены как опциональные (`?`), значения **без** дискриминатора по-прежнему
- * приемлемы для любой ветви — это переходная мягкая совместимость с legacy-конфигами.
+ * Поскольку оба поля помечены как опциональные (`?`), значения **без** дискриминатора приемлемы
+ * для любой ветви — так тип принимает и конфиги, где дискриминатор не указан.
  */
 export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTableConfig | 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 | StructuredDataContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig | VoteContainerConfig;
 /**
  * Строгий authoring-тип узла конфига. В отличие от мягкого {@link ConfigContainerChild}
- * (`id?` — опционален ради legacy-совместимости), здесь `id` **обязателен** и рекурсивно
- * требуется у всех потомков в `children`. Предназначен для авторинга НОВЫХ конфигов и примеров
+ * (`id?` опционален, чтобы рантайм принимал любые конфиги), здесь `id` **обязателен** и рекурсивно
+ * требуется у всех потомков в `children`. Предназначен для авторинга конфигов и примеров
  * в документации: `ts-check` ловит пропуск `id` на любой глубине. Базовый
- * {@link ConfigContainerChild} остаётся мягким — на нём держится рантайм/legacy-парсер.
+ * {@link ConfigContainerChild} остаётся мягким — на нём держится рантайм-парсер.
  *
  * @example
  * const child: StrictConfigContainerChild = {
@@ -581,7 +581,7 @@ export type DashboardHeaderConfig = DashboardDefaultHeaderConfig | FeatureCardBa
  * Карта `ContainerTemplate` → `<Name>ContainerProps`. Используется для типобезопасного
  * `containers/registry.ts`, фабрики `getContainerComponent` и Code Connect Figma.
  *
- * `Progress` и `RoundedBackground` исторически используют `InnerContainerProps` (см.
+ * `Progress` и `RoundedBackground` принимают `InnerContainerProps` (см.
  * `containers/DataSourceInnerContainer/types.ts`). В сигнатуре регистрации это переживёт
  * благодаря contravariance `FC<P>`: `FC<InnerContainerProps>` совместим с `FC<<Name>Props>`,
  * пока `<Name>Props` ⊆ `InnerContainerProps`.

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

@@ -101,9 +101,31 @@ export declare const PROJECT_ALIAS_PROP = "alias";
 export declare const PROJECT_PROPS: string[];
 export declare const PROVIDER_PREFIX = "$";
 export declare enum ProviderPrefix {
+    /** `$card:<слой>:<поле>` — атрибут объекта карточки. */
     Card = "card",
-    Left = "left"
+    /**
+     * Ближайший дашборд, в ряд к `%` своего виджета: `$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;
+/** Свойства границ диапазона: `%name.min` / `%name.max`. */
+export declare const RANGE_PROPS: readonly ["min", "max"];
+/** Разделитель элементов массива, подставленного в текст UI. */
+export declare const CONFIG_TEXT_ARRAY_SEPARATOR = ", ";
+/**
+ * Подписи в `options` элемента, которые проходят через подстановки строк конфига. Список явный:
+ * служебные строки (`attributeName`, `chartId`, `relatedDataSource`, ...) подстановкам не подлежат.
+ */
+export declare const CONFIG_STRING_OPTION_KEYS: readonly ["label", "placeholder", "title"];
 export declare const FILTERED_VALUE_OPACITY = 28;
 export declare const DEFAULT_ATTRIBUTE_NAME = "name";
 export declare const DEFAULT_DATA_SOURCE_LIMIT = 100;
@@ -144,8 +166,8 @@ export declare const BASE_CONTAINER_STYLE: CSSObject;
 /**
  * Маркер тела контейнера внутри `ContainerRoot` — содержимое без заголовка.
  *
- * Нужен, чтобы находить тело по DOM снаружи: `#<id контейнера>` теперь указывает на корень,
- * то есть на пару «заголовок + тело».
+ * Нужен, чтобы находить тело по DOM снаружи: `#<id контейнера>` указывает на корень, то есть на
+ * пару «заголовок + тело».
  */
 export declare const CONTAINER_BODY_ATTRIBUTE = "data-container-body";
 /**

package/dist/components/Dashboard/containers/FiltersContainer/utils/getFilterWidth.d.ts

@@ -2,8 +2,7 @@ import { CssSize } from '../../../types';
 /**
  * Ширина фильтра из конфига. Без явного значения фильтр занимает всю ширину контейнера.
  *
- * Раньше у каждого фильтра был свой пиксельный фолбэк, подогнанный под левую панель приложения
- * (288px у Dropdown, 17.25rem у Text, 17rem у RangeNumber, ничего у Tree), из-за чего в одной
- * панели фильтры вставали «лесенкой» — и тем заметнее, чем шире контейнер.
+ * Фолбэк общий для всех типов фильтров: свои пиксельные фолбэки у разных типов выстраивали бы
+ * фильтры одной панели «лесенкой» — и тем заметнее, чем шире контейнер.
  */
 export declare const getFilterWidth: (width?: CssSize) => string;

package/dist/components/Dashboard/elements/ElementControl/hooks/useFirstNonEmptyValue.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Первое непустое значение за жизнь компонента. Дефолт контрола с подстановкой
+ * (`$dashboard:scenario`) фиксируется при открытии карточки: пока фильтры дашборда грузятся, он ещё
+ * пуст, а после — смена фильтра дашборда не должна затирать выбор.
+ */
+export declare const useFirstNonEmptyValue: <T>(value: T) => T;

package/dist/components/Dashboard/elements/ElementModal/hooks/useModalContent.d.ts

@@ -1,4 +1,4 @@
-import { ConfigContainerChild, WidgetType } from '../../../types';
+import { ConfigContainerChild, ConfigModal, WidgetType } from '../../../types';
 /**
  * Конфиг модалки `modalId` и рендер её детей.
  *
@@ -7,7 +7,7 @@ import { ConfigContainerChild, WidgetType } from '../../../types';
  * контейнера всплыл бы в заголовок или шапку модалки; `renderSlot` видит только её прямых детей.
  */
 export declare const useModalContent: (type: WidgetType, modalId?: string) => {
-    modalConfig: any;
+    modalConfig: ConfigModal;
     modalContent: ConfigContainerChild[];
     renderElement: import('../../../types').RenderElementFunction;
     renderSlot: import('../../../types').RenderElementFunction;

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

@@ -4,8 +4,8 @@ import { CssSize } from '../../../types';
  * Css собственного бокса таблицы: размер из `options` представления плюс прокрутка того,
  * что в этот размер не влез.
  *
- * Размеров нет — нет и бокса: таблица занимает столько, сколько просит содержимое, а лишнее,
- * как и раньше, уходит в прокрутку области представления контейнера.
+ * Размеров нет — нет и бокса: таблица занимает столько, сколько просит содержимое, а лишнее
+ * уходит в прокрутку области представления контейнера.
  *
  * Проценты работают только по ширине. Между областью представления и таблицей стоит блочная
  * обёртка элемента (`ElementValueWrapper`) с высотой `auto`, и `height: "100%"` в ней не

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

@@ -15,6 +15,8 @@ export * from './useChartAxisTitles';
 export * from './useChartChange';
 export * from './useChartData';
 export * from './useConfigDataSources';
+export * from './useConfigStringSources';
+export * from './useDashboardFilterStore';
 export * from './useDashboardHeader';
 export * from './useDataSourceLoading';
 export * from './useDataSources';

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

@@ -0,0 +1,8 @@
+import { ConfigStringSources } from '../utils/configString/types';
+import { WidgetType } from '../types';
+/**
+ * Все источники подстановок строк конфига для виджета `type`: его фильтры (`%`), фильтры и
+ * датасорсы дашборда (`$dashboard:`), атрибуты объекта, вид карты и проект.
+ * Атрибуты — объекта виджета; строки `DataSource` подменяют их своими при рендере.
+ */
+export declare const useConfigStringSources: (type: WidgetType) => ConfigStringSources;

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

@@ -0,0 +1,9 @@
+import { ConfigFilterStore } from '../utils/configString/types';
+import { WidgetType } from '../types';
+/**
+ * Фильтры ближайшего дашборда для `$dashboard:` в строках конфига виджета `type`. На самом
+ * дашборде стор не нужен (`undefined`): `$dashboard:name` там равен `%name`.
+ *
+ * Страница дашборда собирается напрямую из конфига, а не через `useWidgetPage`: тот сам зовёт этот хук.
+ */
+export declare const useDashboardFilterStore: (type: WidgetType) => ConfigFilterStore | undefined;

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

@@ -1,6 +1,6 @@
 import { RefObject } from 'react';
 interface UseEqualTileWidthParams {
-    /** `false` — режим «Растянуть», «В столбец» или старые конфиги без `columns`. */
+    /** `false` — режим «Растянуть», «В столбец» или конфиг без `columns`. */
     enabled: boolean;
     itemsCount: number;
     /** Число плиток в ряду: по нему считается ширина ячейки, шире которой плитка быть не может. */

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

@@ -1,6 +1,9 @@
 import { ConfigContainerChild, ConfigLayer, WidgetType } from '../types';
 /**
  * Generic-параметр `T` — намерение под виджет. Дальнейшая параметризация — отдельная задача.
+ *
+ * Дефолты фильтров не-дашборда (карточки) с `$dashboard:` приходят уже разрезолвленными из фильтров
+ * дашборда. Страница дашборда отдаётся как есть: её `currentPage` редактор пишет обратно в конфиг.
  */
 export declare const useWidgetPage: <T extends WidgetType = WidgetType.Dashboard>(type?: T) => {
     pageIndex: number;

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

@@ -9,7 +9,7 @@ interface UseWrapperSizeParams {
 }
 export interface WrapperRootProps extends BgImageHostProps {
     id?: string;
-    /** Дубль `id` для внешних селекторов: раньше его нёс `ElementValueWrapper` вокруг контейнера. */
+    /** Дубль `id` для внешних селекторов (`[data-id=…]`). */
     "data-id"?: string;
     "data-templatename"?: string;
     style?: CSSProperties;
@@ -23,8 +23,8 @@ export interface WrapperRootProps extends BgImageHostProps {
  * Размеры уходят styled-пропом (класс), а не inline-стилем, поэтому перебиваются снаружи
  * без `!important`. Авторский `style` остаётся inline — у него приоритет по замыслу автора конфига.
  *
- * `data-id` и `$noMargin` раньше жили на внешней обёртке `ElementValueWrapper`; она вешала их
- * на второй узел поверх этого корня, дублируя стили, и для таких контейнеров больше не создаётся
+ * `data-id` и `$noMargin` живут на самом корне: внешняя обёртка `ElementValueWrapper` повесила бы
+ * их на второй узел поверх него, дублируя стили, поэтому для таких контейнеров она не создаётся
  * (см. `ROOT_OWNING_TEMPLATES`).
  *
  * Пропсы хоста фонового слоя (`$hasBgImage`, `$innerPadding`) подмешиваются здесь, а не в каждом

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

@@ -28,10 +28,9 @@ export declare const noMarginMixin: import('styled-components').FlattenInterpola
 /**
  * Обёртка значения элемента.
  *
- * Контейнеры, владеющие своим корнем (`ROOT_OWNING_TEMPLATES`), сюда больше не попадают —
- * обёртка дублировала их `data-id`, `data-templatename` и `style` вторым узлом DOM.
- * `$sizeTransparent` поэтому работает только на контейнерах, которые ещё не переведены
- * на `useContainerRoot`.
+ * Контейнеры, владеющие своим корнем (`ROOT_OWNING_TEMPLATES`), сюда не попадают — обёртка
+ * продублировала бы их `data-id`, `data-templatename` и `style` вторым узлом DOM.
+ * `$sizeTransparent` поэтому работает только на контейнерах без `useContainerRoot`.
  */
 export declare const ElementValueWrapper: import('styled-components').StyledComponent<"div", any, {
     noMargin?: boolean;
@@ -45,8 +44,8 @@ export declare const ElementValueWrapper: import('styled-components').StyledComp
  * а доля из `options.width` достаётся только телу. Поэтому `id`, `data-templatename`, авторский
  * `style` и `$sizeCss` живут здесь, а не на теле — см. `useContainerRoot`.
  *
- * Всегда flex-колонка: заголовок и тело раньше были flex-элементами родительского `Container`,
- * и блочная обёртка вернула бы схлопывание вертикальных отступов между ними.
+ * Всегда flex-колонка: в блочной обёртке вертикальные отступы между заголовком и телом
+ * схлопывались бы.
  */
 export declare const ContainerRoot: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps, never>;
 export declare const Container: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps & {

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

@@ -1,7 +1,6 @@
 /**
- * Стили дашборда. Раньше это был один `Dashboard/styled.ts`; путь импорта (`./styled`) не
- * изменился — файл стал папкой, чтобы каждый раздел жил отдельным модулем и укладывался в
- * `max-lines`.
+ * Стили дашборда. Импортируются одним путём (`./styled`), а внутри разбиты на разделы, чтобы
+ * каждый жил отдельным модулем и укладывался в `max-lines`.
  *
  * Подмодули импортируют друг друга НАПРЯМУЮ, а не через этот баррель: он реэкспортирует их
  * всех, и обращение к нему изнутри замкнуло бы цикл — модуль ждал бы сам себя и попал в TDZ.

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

@@ -8,6 +8,7 @@ import { AttributeType, EqlRequestDc, FeatureDc, OgcGeometryType, PagedFeaturesL
 import { FeatureAttributeValue, EditGeometryType, ThemeName } from '../../types';
 import { AttributeFormatConfiguration } from '../../utils/format';
 import { InnerContainerProps } from './containers/DataSourceInnerContainer/types';
+import { ConfigStringSources } from './utils/configString/types';
 export * from './componentTypes';
 export * from './branded';
 /** Список допустимых типов диаграммы. `as const` даёт runtime-доступ для dropdown-ов. */
@@ -52,8 +53,8 @@ export type ViewMode = (typeof VIEW_MODES)[number];
  * CSS-длина для `fontSize`/etc. Template literal type ловит грубые ошибки вроде
  * `fontSize: "fourteen"`, при этом пропускает корректные `"1rem"`, `"14px"`, `"100%"`, ...
  *
- * Применяется как **opt-in** для нового кода; ConfigOptions.fontSize пока остаётся `string`
- * ради совместимости с legacy-конфигами.
+ * Применяется как **opt-in**; `ConfigOptions.fontSize` остаётся `string`, чтобы принимать
+ * конфиги с произвольной строкой размера.
  */
 export type CssLength = `${number}rem` | `${number}px` | `${number}em` | `${number}%`;
 export type DesignToken = `var(--${string})`;
@@ -538,7 +539,23 @@ export interface ConfigMiscOptions {
     downloadById?: string;
     parentResourceId?: string;
     useNotifications?: boolean;
+    /**
+     * Чьи изменения применяются по серверным уведомлениям. Задаётся в `options` корня
+     * конфигурации дашборда: действует на изменения проекта и служит значением по умолчанию
+     * для {@link ConfigLayer.notifications} и {@link ConfigDataSource.notifications}.
+     */
+    notifications?: ConfigNotifications;
 }
+/**
+ * Фильтр серверных уведомлений по автору изменения (`senderName` уведомления):
+ * - `"all"` — любые изменения (по умолчанию);
+ * - `"my"` — только изменения текущего пользователя;
+ * - массив — только изменения перечисленных пользователей. Текущий пользователь неявно
+ *   не добавляется, `"my"` внутри массива — обычное имя.
+ *
+ * Уведомление без автора (изменение системной задачи) применяется при любом значении.
+ */
+export type ConfigNotifications = "all" | "my" | string[];
 /**
  * Flat-объединение всех доменных миксинов. Существующие места, использующие
  * `Pick<ConfigOptions, ...>`, продолжают работать. Для нового кода предпочтительно делать
@@ -661,6 +678,12 @@ export interface ConfigDataSource {
      * игнорируется и работает {@link ConfigDataSource.autoSyncLayer}.
      */
     autoSyncLayers?: string[];
+    /**
+     * Чьи изменения перезапрашивают источник по autoSync-уведомлениям. Не задано — берётся
+     * {@link ConfigLayer.notifications} слоя из уведомления, затем `options.notifications`
+     * корня дашборда. См. {@link ConfigNotifications}.
+     */
+    notifications?: ConfigNotifications;
     /**
      * Задержка перед запросом источника, мс. `0` или отсутствие поля — запрос сразу.
      *
@@ -768,6 +791,12 @@ export interface ConfigLayer {
     hiddenAttributes?: string[];
     customFeatureSelect?: CustomFeatureSelect;
     disableDrag?: boolean;
+    /**
+     * Чьи изменения слоя применяются по серверным уведомлениям: конфигурация слоя и его
+     * объекты на карте, в таблице и карточке. Не задано — `options.notifications` корня
+     * дашборда. См. {@link ConfigNotifications}.
+     */
+    notifications?: ConfigNotifications;
 }
 export interface ConfigTask {
     name: string;
@@ -926,6 +955,8 @@ export interface GetRenderElementProps extends Omit<ContainerProps, "renderEleme
     selectedTabId?: string;
     setSelectedTabId?: (id: string) => void;
     t?: i18n["t"];
+    /** Источники подстановок строк конфига (`useConfigStringSources`). Не заданы — строки выводятся как есть. */
+    configStringSources?: ConfigStringSources;
 }
 export interface RenderElementProps {
     id?: string;

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

@@ -1,9 +1,11 @@
-import { ClientFeatureAttribute, ConfigFilter, SelectedFilters, WidgetDataSource } from '../types';
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-export declare const applyQueryFilters: ({ parameters: configParameters, filters: configFilters, selectedFilters, geometry, extent, zoomLevel, projectName, projectAlias, attributes, layerInfo, dataSources, projectDataSources, }: {
+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>;
     filters: ConfigFilter[];
     selectedFilters?: SelectedFilters;
+    dashboard?: ConfigFilterStore;
     geometry?: string;
     extent?: string;
     zoomLevel?: number;
@@ -12,5 +14,4 @@ export declare const applyQueryFilters: ({ parameters: configParameters, filters
     attributes?: ClientFeatureAttribute[];
     layerInfo?: QueryLayerServiceInfoDc;
     dataSources: WidgetDataSource[];
-    projectDataSources?: WidgetDataSource[];
 }) => Record<string, Record<string, any>>;

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

@@ -12,7 +12,7 @@ export declare const resolveAxis: (source?: AxisSource) => ConfigAxis;
  * Источник питает ось значений.
  *
  * Отсутствие `axis.type` означает `"y"`: конфиг без явного типа — самый частый случай,
- * и раньше такой источник молча выпадал из графика.
+ * и такой источник не должен выпадать из графика.
  */
 export declare const isValueAxis: (source: AxisSource) => boolean;
 /** Сторона оси; отсутствие `axis.side` означает `"left"`. */

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

@@ -0,0 +1,18 @@
+import { QueryLayerServiceConfigurationDc } from '@evergis/api';
+import { ConfigStringSources } from './types';
+export type ConditionEqlParams = {
+    eqlParameters?: QueryLayerServiceConfigurationDc["eqlParameters"];
+    layerParams?: Record<string, string>;
+};
+/**
+ * Одна секция условия: все токены в формате условия. Пустое значение фильтра оставляет токен как
+ * есть; пустой атрибут объекта (`{name}`) заменяется пустой строкой.
+ */
+export declare const formatConditionSection: (section: string, sources: ConfigStringSources, { isSetParams, ...eql }?: ConditionEqlParams & {
+    isSetParams?: boolean;
+}) => string;
+/**
+ * Условие слоя: ведущие set-параметры `$(имя=…)` форматируются отдельно (даты без `#'…'`),
+ * остаток — по секциям `AND`.
+ */
+export declare const formatConditionString: (condition: string, sources: ConfigStringSources, eql?: ConditionEqlParams) => string;

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

@@ -0,0 +1,16 @@
+import { ConfigStringSegment, ConfigStringSources, ConfigToken } from './types';
+type TokenFormatter = (token: ConfigToken) => string;
+/** Склейка сегментов: токен заменяется своим форматом, незнакомый — остаётся как написан. */
+export declare const joinConfigSegments: (segments: ConfigStringSegment[], formatToken: TokenFormatter) => string;
+/**
+ * Значение параметра запроса. Строка-токен целиком уходит сырым значением с типом, а пустой или
+ * незнакомый фильтр не уходит вовсе (`undefined`). Токены внутри строки интерполируются текстом.
+ */
+export declare const resolveQueryParameter: (value: unknown, sources: ConfigStringSources) => unknown;
+/**
+ * Строка конфига для UI (значение элемента, дефолт, подпись). Строка-токен целиком отдаёт сырое
+ * значение (число, массив — например, дефолт мультиселекта); пустое — пустая строка. Внутри текста
+ * массив склеивается через `", "`. Незнакомый токен (опечатка, литерал `50%off`) остаётся как написан.
+ */
+export declare const resolveConfigString: (value: unknown, sources: ConfigStringSources) => unknown;
+export {};

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

@@ -0,0 +1,13 @@
+import { ConfigFilterStore, ConfigTokenMode, ResolvedConfigToken } from './types';
+type FilterTokenParams = {
+    name: string;
+    prop?: string;
+    store: ConfigFilterStore;
+    mode: ConfigTokenMode;
+};
+/**
+ * Значение токена фильтра (`%name[.prop]`, `$dashboard:name[.prop]`) из переданного стора.
+ * Фильтр, о котором стор ничего не знает, — `known: false`: токен остаётся в строке как есть.
+ */
+export declare const getFilterTokenValue: (params: FilterTokenParams) => ResolvedConfigToken;
+export {};

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

@@ -0,0 +1,10 @@
+export * from './formatConditionString';
+export * from './formatters';
+export * from './getFilterTokenValue';
+export * from './isDashboardReference';
+export * from './referencesFilters';
+export * from './resolveConfigToken';
+export * from './resolveElementStrings';
+export * from './resolveFilterDefaults';
+export * from './tokenizeConfigString';
+export * from './types';

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

@@ -0,0 +1,2 @@
+/** Строка ссылается на фильтр дашборда (`$dashboard:`). */
+export declare const isDashboardReference: (value: unknown) => value is string;

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

@@ -0,0 +1,11 @@
+/**
+ * Строка конфига ссылается на один из фильтров: `%name[.prop]` — на фильтр виджета,
+ * `$dashboard:name[.prop]` — на фильтр дашборда. На самом дашборде (`hasDashboardStore = false`)
+ * `$dashboard:` — те же фильтры виджета.
+ */
+export declare const referencesFilters: ({ value, widgetNames, dashboardNames, hasDashboardStore, }: {
+    value: unknown;
+    widgetNames: string[];
+    dashboardNames: string[];
+    hasDashboardStore: boolean;
+}) => boolean;

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

@@ -0,0 +1,3 @@
+import { ConfigStringSources, ConfigToken, ConfigTokenMode, ResolvedConfigToken } from './types';
+/** Сырое значение токена строки конфига — без форматирования под параметр, условие или текст. */
+export declare const resolveConfigToken: (token: ConfigToken, sources: ConfigStringSources, mode: ConfigTokenMode) => ResolvedConfigToken;

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

@@ -0,0 +1,8 @@
+import { ConfigContainerChild } from '../../types';
+import { ConfigStringSources } from './types';
+/**
+ * Узел конфига с подставленными строками: `value`, `defaultValue` и подписи из
+ * {@link CONFIG_STRING_OPTION_KEYS}. Без подстановок узел возвращается тем же объектом —
+ * мемоизированные контейнеры не перерисовываются зря.
+ */
+export declare const resolveElementStrings: (element: ConfigContainerChild | undefined, sources?: ConfigStringSources) => ConfigContainerChild | undefined;

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

@@ -0,0 +1,8 @@
+import { ConfigFilter } from '../../types';
+import { ConfigFilterStore } from './types';
+/**
+ * Дефолты фильтров виджета из фильтров дашборда: `defaultValue: "$dashboard:year"`. Резолвится
+ * только `$dashboard:` — ссылки на собственные фильтры (`%name`) дали бы цикл и остаются как есть.
+ * Дефолт живой: пока фильтр виджета не выбран, он следует за дашбордом, ручной выбор его перекрывает.
+ */
+export declare const resolveFilterDefaults: (configFilters: ConfigFilter[], dashboard?: ConfigFilterStore) => ConfigFilter[];

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

@@ -0,0 +1,5 @@
+import { ConfigStringSegment, ConfigToken } from './types';
+/** Разбирает строку конфига на литералы и токены подстановок — в исходном порядке. */
+export declare const tokenizeConfigString: (value: string) => ConfigStringSegment[];
+/** Строка целиком — один токен: тогда значение уходит как есть, с типом (число, массив). */
+export declare const getSingleToken: (segments: ConfigStringSegment[]) => ConfigToken | null;

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

@@ -0,0 +1,78 @@
+import { AttributeType, QueryLayerServiceInfoDc } from '@evergis/api';
+import { ClientFeatureAttribute, ConfigFilter, SelectedFilters, WidgetDataSource } from '../../types';
+/** Фильтры одного виджета: выбранные значения, их конфиг (дефолты, `relatedDataSource`) и датасорсы. */
+export type ConfigFilterStore = {
+    selectedFilters?: SelectedFilters;
+    configFilters?: ConfigFilter[];
+    dataSources?: WidgetDataSource[];
+};
+/** Всё, откуда строка конфига может взять значение. Префикс токена выбирает стор. */
+export type ConfigStringSources = {
+    /** `%name` — фильтры своего виджета (в карточке — фильтры карточки). */
+    widget?: ConfigFilterStore;
+    /**
+     * `$dashboard:` — фильтры и датасорсы ближайшего дашборда. Не задан — берётся `widget` (строка живёт
+     * на самом дашборде).
+     */
+    dashboard?: ConfigFilterStore;
+    /** `{name}` и `$card:<слой>:<поле>` — атрибуты текущего объекта. */
+    attributes?: ClientFeatureAttribute[];
+    layerInfo?: QueryLayerServiceInfoDc;
+    geometry?: string;
+    extent?: string;
+    zoomLevel?: number;
+    projectName?: string;
+    projectAlias?: string;
+};
+export type ConfigFilterScope = "widget" | "dashboard";
+export type ConfigFilterToken = {
+    kind: "filter";
+    scope: ConfigFilterScope;
+    name: string;
+    prop?: string;
+    raw: string;
+};
+/** `$card:<слой>:<поле>` — атрибут объекта карточки, если карточка открыта на этом слое. */
+export type ConfigCardToken = {
+    kind: "card";
+    layerName: string;
+    fieldName: string;
+    raw: string;
+};
+/**
+ * `$dashboard:<датасорс>:<поле>` — поле первой строки датасорса дашборда. Датасорс ищется по имени,
+ * затем по `layerName`.
+ */
+export type ConfigDataSourceToken = {
+    kind: "dataSource";
+    dataSourceName: string;
+    fieldName: string;
+    raw: string;
+};
+export type ConfigAttributeToken = {
+    kind: "attribute";
+    name: string;
+    raw: string;
+};
+export type ConfigToken = ConfigFilterToken | ConfigCardToken | ConfigDataSourceToken | ConfigAttributeToken;
+/** Строка конфига, разобранная на литералы и токены. */
+export type ConfigStringSegment = string | ConfigToken;
+/**
+ * Правила значения фильтра:
+ * - `value` — параметры запроса и текст UI: `null`/`undefined` падают в дефолт, фильтр может не иметь конфига;
+ * - `condition` — условие слоя: пустое значение не подставляется, фильтр обязан быть в конфиге.
+ */
+export type ConfigTokenMode = "value" | "condition";
+/** Как системное значение вставляется в условие: строкой в кавычках или числом. */
+export type ConfigSystemFormat = "quoted" | "number";
+export type ResolvedConfigToken = {
+    known: false;
+} | {
+    known: true;
+    value: unknown;
+    /** Тип атрибута — решает, нужны ли кавычки в условии. */
+    attributeType?: AttributeType;
+    /** Дефолт фильтра — скаляр при массивном дефолте уходит в условие списком. */
+    defaultValue?: unknown;
+    system?: ConfigSystemFormat;
+};

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

@@ -1,30 +1,13 @@
 import { QueryLayerServiceConfigurationDc } from '@evergis/api';
-import { ClientFeatureAttribute, ConfigFilter, SelectedFilter, SelectedFilters } from '../types';
-export declare const applyFiltersToCondition: ({ condition, name, defaultValue, filters, isSingle, isSetParams, configFilter, }: {
-    condition: string;
-    name: string;
-    defaultValue: SelectedFilter["value"];
-    filters: SelectedFilters;
-    isSingle?: boolean;
-    isSetParams?: boolean;
-    configFilter?: ConfigFilter;
-}) => string | number;
-export declare const applyVarsToCondition: <T extends string | string[]>({ section, configFilters, filters, attributes, layerParams, eqlParameters, geometry, extent, zoomLevel, projectName, projectAlias, isSetParams, }: Pick<QueryLayerServiceConfigurationDc, "eqlParameters"> & {
-    section: T;
-    configFilters: ConfigFilter[];
-    filters: SelectedFilters;
-    attributes?: ClientFeatureAttribute[];
-    layerParams?: Record<string, string>;
-    geometry?: string;
-    extent?: string;
-    zoomLevel?: number;
-    projectName?: string;
-    projectAlias?: string;
-    isSetParams?: boolean;
-}) => T;
+import { ClientFeatureAttribute, ConfigFilter, SelectedFilters, WidgetDataSource } from '../types';
+import { ConfigFilterStore } from './configString/types';
 type FormatDataSourceConditionParams = {
     configFilters?: ConfigFilter[];
     filters: SelectedFilters;
+    /** Датасорсы виджета — для `%name.prop` через `relatedDataSource` фильтра. */
+    dataSources?: WidgetDataSource[];
+    /** Фильтры дашборда для `$dashboard:` — когда условие принадлежит карточке. */
+    dashboard?: ConfigFilterStore;
     attributes?: ClientFeatureAttribute[];
     eqlParameters?: QueryLayerServiceConfigurationDc["eqlParameters"];
     layerParams?: Record<string, string>;
@@ -34,6 +17,16 @@ type FormatDataSourceConditionParams = {
     projectName?: string;
     projectAlias?: string;
 };
+/** Подстановки в секции условия (строке или массиве секций) — без разбора set-параметров. */
+export declare const applyVarsToCondition: <T extends string | string[]>({ section, isSetParams, ...params }: FormatDataSourceConditionParams & {
+    section: T;
+    isSetParams?: boolean;
+}) => T;
+/**
+ * Условие слоя с подстановками строк конфига: фильтры (`%filter`, `$dashboard:filter`), атрибуты
+ * объекта, системные значения карты и проекта, eql-параметры слоя. Пустое значение фильтра
+ * оставляет плейсхолдер нетронутым.
+ */
 export declare const formatDataSourceCondition: ({ condition, ...rest }: FormatDataSourceConditionParams & {
     condition?: string | string[];
 }) => string | string[];

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

@@ -0,0 +1,8 @@
+import { ConfigFilter, SelectedFilters } from '../types';
+/** Имена фильтров, чьё выбранное значение изменилось с прошлого снимка. */
+export declare const getChangedFilterNames: (filters: SelectedFilters | undefined, prevFilters: SelectedFilters, configFilters?: ConfigFilter[]) => string[];
+/**
+ * Имена фильтров, чей дефолт изменился (`defaultValue: "$dashboard:year"` при смене фильтра дашборда),
+ * пока пользователь не выбрал своё значение, — для потребителей это то же, что смена значения.
+ */
+export declare const getChangedDefaultNames: (configFilters: ConfigFilter[] | undefined, prevConfigFilters: ConfigFilter[] | undefined, filters: SelectedFilters | undefined) => string[];

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

@@ -0,0 +1,3 @@
+import { ConfigContainer, ConfigFilter } from '../types';
+/** Фильтры страницы `pageIndex` (с 1) вместе с общими фильтрами конфига; общие перекрывают одноимённые. */
+export declare const getPageFilters: (config: ConfigContainer, pageIndex: number) => ConfigFilter[];