@evergis/react 4.0.99 → 4.0.101

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

@@ -1,5 +1,5 @@
 import { CSSObject } from 'styled-components';
-import { AttributeType } from '@evergis/api';
+import { AttributeType, QueryLayerServiceInfoDc } from '@evergis/api';
 import { ConfigContainer, ConfigContainerChild } from './types';
 export declare const CONFIG_PAGES_ID = "pages";
 export declare const CONFIG_PAGE_ID = "page";
@@ -31,6 +31,8 @@ export declare const DEFAULT_ZOOM = 10;
 export declare const NUMERIC_ATTRIBUTE_TYPES: AttributeType[];
 export declare const GEOMETRY_ATTRIBUTE = "geometry";
 export declare const DEFAULT_ID_ATTRIBUTE_NAME = "gid";
+/** Заглушка для потребителей, ожидающих non-null layerInfo у источника без описания атрибутов. */
+export declare const EMPTY_DATA_SOURCE_LAYER_INFO: QueryLayerServiceInfoDc;
 export declare const DEFAULT_DROPDOWN_WIDTH = 312;
 export declare const DEFAULT_FILTER_PADDING = 12;
 /** Базовый отступ обёртки контейнера. Снимается, когда контейнер занимает ячейку целиком. */

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

@@ -1,4 +1,4 @@
-import { FeatureDc, QueryLayerServiceInfoDc } from '@evergis/api';
+import { FeatureDc } from '@evergis/api';
 import { ConfigContainerChild, FetchedDataSource, WidgetType } from '../types';
 export declare const useRelatedDataSourceAttributes: ({ type, elementConfig, dataSources, feature, }: {
     type: WidgetType;
@@ -6,7 +6,7 @@ export declare const useRelatedDataSourceAttributes: ({ type, elementConfig, dat
     dataSources: FetchedDataSource[];
     feature?: FeatureDc;
 }) => {
-    layerInfo: QueryLayerServiceInfoDc;
+    layerInfo: import('@evergis/api').QueryLayerServiceInfoDc;
     attributes: import('../types').ClientFeatureAttribute[];
     dataSource: import('../types').WidgetDataSource;
 };

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

@@ -344,9 +344,22 @@ export interface ConfigMiscOptions {
  */
 export interface ConfigOptions extends ConfigLayoutOptions, ConfigTypographyOptions, ConfigExpandableOptions, ConfigDataSourceBindingOptions, ConfigChartOptions, ConfigVisualOptions, ConfigTextDisplayOptions, ConfigCollectionOptions, ConfigMapLayerOptions, ConfigEditOptions, ConfigMiscOptions {
 }
+/**
+ * Настройки атрибута источника данных, заданные в конфиге.
+ * Накладываются поверх атрибутов слоя/ответа EQL: `stringFormat` мержится по полям,
+ * поэтому задавать нужно только то, что переопределяется.
+ */
+export interface ConfigDataSourceAttribute {
+    attributeName: string;
+    alias?: string;
+    type?: AttributeType;
+    stringFormat?: AttributeFormatConfigurationDc;
+}
 export interface ConfigDataSource {
     name: string;
     alias?: string;
+    /** Формат и метаданные атрибутов источника. Не путать с `options.attributes` (список имён у элемента). */
+    attributes?: ConfigDataSourceAttribute[];
     condition?: string | string[];
     ds?: string;
     layerName?: string;

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

@@ -0,0 +1,8 @@
+import { AttributeConfigurationDc, AttributesConfigurationDc } from '@evergis/api';
+/**
+ * Находит конфигурацию атрибута по имени.
+ *
+ * `AttributesConfigurationDc["attributes"]` — массив, но часть источников отдаёт атрибуты
+ * объектом-мапой (см. нормализацию в `useDataSources`), поэтому поддерживаются обе формы.
+ */
+export declare const getAttributeConfigurationByName: (attributes?: AttributesConfigurationDc["attributes"], name?: string) => AttributeConfigurationDc | undefined;

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

@@ -0,0 +1,17 @@
+import { QueryLayerServiceInfoDc } from '@evergis/api';
+import { ConfigDataSource, FetchedDataSource } from '../types';
+/**
+ * Резолвит layerInfo источника данных и накладывает поверх атрибуты из его конфига.
+ *
+ * База — реальный слой по `layerName`, а если слоя нет (EQL, python) — атрибуты из ответа.
+ * Возвращает `null`, когда атрибутов нет вообще: потребители отличают по этому «источник без
+ * описания атрибутов» от загруженного, и non-null сломал бы их loading/empty-state.
+ *
+ * Синтетическому layerInfo намеренно не задаётся `name` — по нему ищут скрытые атрибуты слоя
+ * и рендерят элемент `layerName`, имя источника данных дало бы там ложные срабатывания.
+ */
+export declare const getDataSourceLayerInfo: ({ layerInfos, configDataSource, fetchedDataSource, }: {
+    layerInfos?: QueryLayerServiceInfoDc[];
+    configDataSource?: ConfigDataSource;
+    fetchedDataSource?: FetchedDataSource;
+}) => QueryLayerServiceInfoDc | null;

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

@@ -0,0 +1,3 @@
+import { AttributeConfigurationDc, QueryLayerServiceInfoDc } from '@evergis/api';
+/** Достаёт конфигурацию атрибута по имени прямо из layerInfo, снимая повторяющийся каст конфигурации. */
+export declare const getLayerInfoAttribute: (layerInfo?: QueryLayerServiceInfoDc, name?: string) => AttributeConfigurationDc | undefined;

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

@@ -13,6 +13,7 @@ export * from './formatConditionValue';
 export * from './formatDataSourceCondition';
 export * from './formatElementValue';
 export * from './getAttributeByName';
+export * from './getAttributeConfigurationByName';
 export * from './getAttributesConfiguration';
 export * from './getAttributeValue';
 export * from './getChartAxes';
@@ -25,6 +26,7 @@ export * from './getDataFromAttributes';
 export * from './getDataFromRelatedFeatures';
 export * from './getDataSource';
 export * from './getDataSourceFilterValue';
+export * from './getDataSourceLayerInfo';
 export * from './getDefaultConfig';
 export * from './getElementValue';
 export * from './getFeatureAttributes';
@@ -34,6 +36,7 @@ export * from './getFilterSelectedItems';
 export * from './getFilterValue';
 export * from './getFormattedAttributes';
 export * from './getLayerInfo';
+export * from './getLayerInfoAttribute';
 export * from './getLayerInfoFromDataSources';
 export * from './getPagesFromConfig';
 export * from './getPagesFromProjectInfo';
@@ -55,6 +58,7 @@ export * from './isEmptyValue';
 export * from './isHiddenEmptyValue';
 export * from './isNotValidSelectedTab';
 export * from './isVisibleContainer';
+export * from './mergeAttributeConfigurations';
 export * from './pieChartTooltipFromAttributes';
 export * from './pieChartTooltipFromRelatedFeatures';
 export * from './removeDataSource';

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

@@ -0,0 +1,8 @@
+import { AttributesConfigurationDc } from '@evergis/api';
+import { ConfigDataSourceAttribute } from '../types';
+/**
+ * Накладывает атрибуты из конфига источника поверх атрибутов слоя или ответа EQL.
+ * `stringFormat` мержится по полям — в конфиге задают только переопределяемое,
+ * остальное (в т.ч. критичный для форматирования `type`) наследуется от базы.
+ */
+export declare const mergeAttributeConfigurations: (base?: AttributesConfigurationDc["attributes"], overlay?: ConfigDataSourceAttribute[]) => AttributesConfigurationDc["attributes"];