@evergis/react 4.0.100 → 4.0.102

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/componentTypes.d.ts

@@ -154,7 +154,7 @@ export interface CameraContainerConfig extends Omit<ConfigContainerChild, "optio
 export interface CameraContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: CameraContainerConfig;
 }
-export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "width" | "height" | "chartFill">;
+export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "width" | "height" | "fill">;
 export interface ChartAliasChild extends Omit<ConfigContainerChild, "id"> {
     id: "alias";
 }

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

@@ -0,0 +1,15 @@
+/** Значение контекста вписывания тела графика в контейнер (`options.fill` контейнера Chart). */
+export interface FillContextValue {
+    /** Вписать тело графика в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
+    fill: boolean;
+    /** У контейнера ограниченная высота ⇒ можно фитить по высоте (иначе только по ширине). */
+    fitHeight: boolean;
+}
+/**
+ * Контекст вписывания графика (`options.fill` контейнера Chart).
+ *
+ * Компонент `Chart` рендерится через `renderElement({ id: "chart" })` и получает только дочерний
+ * узел `{ id: "chart" }` — опции контейнера до него не доходят. `ChartContainer` оборачивает
+ * график в провайдер этого контекста, а `Chart` читает значение через `useContext`.
+ */
+export declare const FillContext: import('react').Context<FillContextValue>;

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

@@ -15,6 +15,7 @@ export declare const PieChartCenter: import('styled-components').StyledComponent
 export declare const ChartWrapperContainer: import('styled-components').StyledComponent<"div", any, {
     column: boolean;
 }, never>;
+export declare const ChartFillMeasure: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const Tooltip: import('styled-components').StyledComponent<"div", any, {
     transform?: CSSProperties["transform"];
 }, never>;

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/containers/EditContainer/styled.d.ts

@@ -2,9 +2,11 @@ export declare const CheckboxWrapper: import('styled-components').StyledComponen
     fontColor?: string;
     big?: boolean;
     column?: boolean;
+    $fill?: boolean;
 }, never>;
 export declare const ChipsWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     fontColor?: string;
     big?: boolean;
     column?: boolean;
+    $fill?: boolean;
 }, never>;

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

@@ -2,13 +2,16 @@ export declare const ContainerAlias: import('styled-components').StyledComponent
     hasBottomMargin?: boolean;
 }, never>;
 export declare const ContainerAliasIcon: import('styled-components').StyledComponent<"div", any, {}, never>;
-export declare const ContainerChart: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const ContainerChart: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+    $fill?: boolean;
+}, never>;
 export declare const ContainerLegend: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
 export declare const ContainerUnits: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ContainerValue: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     fontColor?: string;
     big?: boolean;
     column?: boolean;
+    $fill?: boolean;
 }, never>;
 export declare const ContainerIcon: import('styled-components').StyledComponent<"span", any, import('@evergis/uilib-gl').IIconProps & {
     $fontColor?: string;

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

@@ -25,7 +25,7 @@ export * from './useHideIfEmptyDataSource';
 export * from './useProjectDashboardInit';
 export * from './useRelatedDataSourceAttributes';
 export * from './useRenderElement';
-export * from './useResizeWidth';
+export * from './useResizeBox';
 export * from './useShownOtherItems';
 export * from './useUpdateDataSource';
 export * from './useWidgetConfig';

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/hooks/useResizeBox.d.ts

@@ -0,0 +1,17 @@
+import { RefObject } from 'react';
+/** Измеренный content-box наблюдаемого элемента: обе оси в пикселях либо `undefined` до первого замера. */
+export interface ResizeBox {
+    width?: number;
+    height?: number;
+}
+/**
+ * Измеряет фактические ширину и высоту DOM-элемента и обновляет их на любой ресайз (ResizeObserver).
+ *
+ * Возвращает `[ref, box]`, где `box` — `{ width, height }` в пикселях (content-box) либо пустой объект,
+ * пока элемент ещё не измерен. Используется для «резинового» графика: d3-графикам нужны конкретные
+ * пиксельные размеры, а не CSS `100%`, а для вписывания (fit) нужны обе оси.
+ *
+ * `enabled: false` полностью отключает наблюдение — обычные (не fill) графики не измеряются
+ * и не вызывают лишних ре-рендеров.
+ */
+export declare const useResizeBox: (enabled: boolean) => [RefObject<HTMLDivElement>, ResizeBox];

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

@@ -162,8 +162,8 @@ export interface ConfigLayoutOptions {
     cornerRadius?: number;
     column?: boolean;
     twoColumns?: boolean;
-    /** Растянуть график контейнера Chart на всю ширину контейнера (график любого типа). */
-    chartFill?: boolean;
+    /** Вписать график контейнера Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
+    fill?: boolean;
     /** Горизонтальное выравнивание содержимого заголовка контейнера. */
     align?: Alignment;
     /** Выравнивание детей контейнера по поперечной оси. В ряду по умолчанию `center`. */
@@ -187,6 +187,10 @@ export interface MarkdownTagTypography {
     fontSize?: FontSizeToken | string;
     lineHeight?: string;
     fontWeight?: number | string;
+    /** Отступ снизу — задаёт расстояние до следующего блока (между тегами). */
+    marginBottom?: string;
+    /** Отступ сверху — задаёт расстояние до предыдущего блока (между тегами). */
+    marginTop?: string;
 }
 /**
  * Пер-тег типографика markdown-виджета. Отсутствующий тег или свойство —
@@ -344,9 +348,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"];