@evergis/react 4.0.100 → 4.0.101

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Everpoint
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Everpoint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
-# @evergis/react
-
-В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
-но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
-
-***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
-от системы поддержки мультиязычности `Evergis Online`!
+# @evergis/react
+
+В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
+но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
+
+***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
+от системы поддержки мультиязычности `Evergis Online`!

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"];