@evergis/react 4.0.111 → 4.0.112

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

@@ -47,8 +47,9 @@ export interface ElementIconConfig extends Omit<ConfigContainerChild, "options"
 }
 export interface ElementIconProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementIconConfig;
+    attributes?: ClientFeatureAttribute[];
 }
-export type ElementImageOptions = Pick<ConfigOptions, "width" | "height" | "fit">;
+export type ElementImageOptions = Pick<ConfigOptions, "width" | "height" | "fit" | "resourceId" | "url">;
 export interface ElementImageConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "image";
     options?: ElementImageOptions;
@@ -199,7 +200,7 @@ export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChil
 export interface ContainersGroupContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ContainersGroupContainerConfig;
 }
-export type DataSourceContainerOptions = Pick<ConfigOptions, "column" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "columns" | "gap" | "align" | "shownItems" | "otherItems"> & ContainerBoxOptions;
+export type DataSourceContainerOptions = Pick<ConfigOptions, "column" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "columns" | "gap" | "innerGap" | "align" | "shownItems" | "otherItems"> & ContainerBoxOptions;
 export interface DataSourceContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.DataSource;
     options?: DataSourceContainerOptions;
@@ -398,7 +399,7 @@ export interface ProgressContainerConfig extends Omit<ConfigContainerChild, "opt
 export interface ProgressContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ProgressContainerConfig;
 }
-export type RoundedBackgroundContainerOptions = Pick<ConfigOptions, "maxLength" | "maxLines" | "wordBreak" | "center" | "fontColor" | "innerTemplateStyle" | "inlineUnits" | "big" | "bigIcon" | "hideEmpty" | "colorAttribute" | "align" | "columns" | "gap">;
+export type RoundedBackgroundContainerOptions = Pick<ConfigOptions, "maxLength" | "maxLines" | "wordBreak" | "center" | "fontColor" | "bgColor" | "innerTemplateStyle" | "inlineUnits" | "big" | "bigIcon" | "hideEmpty" | "colorAttribute" | "align" | "columns" | "gap" | "innerGap">;
 export interface RoundedBackgroundContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.RoundedBackground;
     options?: RoundedBackgroundContainerOptions;

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

@@ -1,6 +1,6 @@
 import { CSSObject } from 'styled-components';
-import { AttributeType, QueryLayerServiceInfoDc } from '@evergis/api';
-import { ConfigContainer, ConfigContainerChild } from './types';
+import { AttributeIconType, AttributeType, QueryLayerServiceInfoDc } from '@evergis/api';
+import { ConfigContainer, ConfigContainerChild, ConfigElementType } from './types';
 export declare const CONFIG_PAGES_ID = "pages";
 export declare const CONFIG_PAGE_ID = "page";
 export declare const DEFAULT_PAGES_CONFIG: ConfigContainerChild;
@@ -31,6 +31,11 @@ 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";
+/**
+ * Каким элементом рендерится иконка атрибута из настроек слоя (`AttributeConfigurationDc.icon`).
+ * `Unknown` не отображается — по нему не понять, что лежит в значении.
+ */
+export declare const ATTRIBUTE_ICON_ELEMENT_TYPES: Partial<Record<AttributeIconType, ConfigElementType>>;
 /** Заглушка для потребителей, ожидающих non-null layerInfo у источника без описания атрибутов. */
 export declare const EMPTY_DATA_SOURCE_LAYER_INFO: QueryLayerServiceInfoDc;
 export declare const DEFAULT_DROPDOWN_WIDTH = 312;

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

@@ -1,9 +1,17 @@
 export declare const ContainerIconValue: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+/**
+ * Обёртка иконки плитки. Собственный styled нужен, чтобы до иконки можно было дотянуться стилями:
+ * сам элемент рисуют ElementIcon/ElementSvg своими компонентами, а обёртка принадлежит контейнеру.
+ */
+export declare const ContainerIconWrapper: import('styled-components').StyledComponent<"span", any, import('@evergis/uilib-gl').FlexSpanProps, never>;
 export declare const RoundedBackgroundContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     $center?: boolean;
     $color?: string;
+    $bgColor?: string;
+    $iconColor?: string;
     $inlineUnits?: boolean;
     $big?: boolean;
     $bigIcon?: boolean;
     $fillWidth?: boolean;
+    $innerGap?: number;
 }, never>;

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

@@ -1,4 +1,13 @@
 import { RefObject } from 'react';
+interface UseEqualTileWidthParams {
+    /** `false` — режим «Растянуть», «В столбец» или старые конфиги без `columns`. */
+    enabled: boolean;
+    itemsCount: number;
+    /** Число плиток в ряду: по нему считается ширина ячейки, шире которой плитка быть не может. */
+    columns: number;
+    /** Отступ между плитками, px — вычитается из ширины ряда вместе с остальными зазорами. */
+    gap: number;
+}
 /**
  * Уравнивает ширину всех плиток контейнера по самой широкой.
  *
@@ -7,7 +16,12 @@ import { RefObject } from 'react';
  * зацикливает ResizeObserver — итоговый максимум совпадает с уже применённым). Возвращаемое число
  * контейнер прокидывает в CSS-переменную `--tile-width`, которую читает каждая плитка.
  *
- * `enabled: false` (режим «Растянуть», «В столбец» или старые конфиги без `columns`) полностью
- * отключает измерение — ширина берётся из grid-ячейки.
+ * Результат ограничен шириной ячейки ряда: плитка задаёт свою ширину в пикселях и в grid не
+ * сжимается вместе с треком (`flex-shrink` там не действует, а `min-width: 0` базового
+ * контейнера позволяет треку ужаться), поэтому натуральная ширина шире ячейки означала бы
+ * наложение соседних плиток друг на друга.
+ *
+ * `enabled: false` полностью отключает измерение — ширина берётся из grid-ячейки.
  */
-export declare const useEqualTileWidth: (enabled: boolean, itemsCount: number) => [RefObject<HTMLDivElement>, number | undefined];
+export declare const useEqualTileWidth: ({ enabled, itemsCount, columns, gap, }: UseEqualTileWidthParams) => [RefObject<HTMLDivElement>, number | undefined];
+export {};

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

@@ -188,8 +188,10 @@ export interface ConfigLayoutOptions {
     align?: TileAlignment;
     /** Число плиток в строке ряда плиточного контейнера */
     columns?: number;
-    /** Внутренний отступ между плитками, px */
+    /** Отступ между плитками, px */
     gap?: number;
+    /** Отступ между элементами внутри плитки (иконка, значение, единицы измерения, подпись), px */
+    innerGap?: number;
     /** Выравнивание детей контейнера по поперечной оси. В ряду по умолчанию `center`. */
     alignItems?: AlignItems;
     /** Масштабирование изображения элемента `image`. */
@@ -271,6 +273,8 @@ export interface ConfigVisualOptions {
     icon?: IconTypesKeys;
     iconAttribute?: string;
     image?: string;
+    /** Id файлового ресурса с картинкой — разворачивается в `/sp/resources/file/<id>`. */
+    resourceId?: string;
     overlay?: string;
     onlyIcon?: boolean;
     bigIcon?: boolean;

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

@@ -1,2 +1,2 @@
 import { ClientFeatureAttribute } from '../types';
-export declare const getAttributeByName: (name: string | string[], attributes: ClientFeatureAttribute[]) => ClientFeatureAttribute;
+export declare const getAttributeByName: (name: string | string[], attributes?: ClientFeatureAttribute[]) => ClientFeatureAttribute;

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

@@ -0,0 +1,10 @@
+import { AttributeIconDc } from '@evergis/api';
+import { ConfigContainerChild } from '../types';
+/**
+ * Собирает тип и значение элемента для иконки атрибута из настроек слоя
+ * (`attributesConfiguration.attributes[].icon`).
+ *
+ * `Icon` — иконка из библиотеки EverGIS, задаётся именем; `PNG` и `SVG` — файлы,
+ * задаются id ресурса или адресом.
+ */
+export declare const getAttributeIconElement: (icon?: AttributeIconDc) => Pick<ConfigContainerChild, "type" | "value">;

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

@@ -0,0 +1,12 @@
+import { QueryLayerServiceInfoDc } from '@evergis/api';
+/**
+ * Достаёт ссылку на картинку из настроек атрибута слоя (`attributesConfiguration.attributes[].icon`).
+ *
+ * Источник элемента `svg` (поле `attributeIcon`): в настройках атрибута картинка задаётся
+ * либо id ресурса, либо готовым url. Форма `icon.iconName` (иконка из библиотеки EverGIS)
+ * здесь не поддерживается — это не файл.
+ */
+export declare const getAttributeIconUrl: ({ attributeName, layerInfo, }: {
+    attributeName?: string;
+    layerInfo?: QueryLayerServiceInfoDc;
+}) => string | null;

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

@@ -0,0 +1,14 @@
+import { ClientFeatureAttribute, ConfigContainerChild } from '../types';
+/**
+ * Резолвит адрес картинки элемента `image` из всех источников конфига, кроме вложений.
+ *
+ * Порядок — первый непустой источник выигрывает:
+ * `options.resourceId` → `options.url` → `value` → `attributeName`.
+ *
+ * Атрибут-вложение даёт `null`: такие картинки грузятся отдельным каналом
+ * (`useAttachmentItems` + `useAttachmentPreviewImages`), см. `useElementImage`.
+ */
+export declare const getImageUrl: ({ elementConfig, attributes, }: {
+    elementConfig?: ConfigContainerChild;
+    attributes?: ClientFeatureAttribute[];
+}) => string | null;

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

@@ -1,8 +1,7 @@
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-import { ConfigContainerChild } from '../types';
-import { FeatureAttribute } from '../../../types';
+import { ClientFeatureAttribute, ConfigContainerChild } from '../types';
 export declare const getSvgUrl: ({ elementConfig, layerInfo, attributes, }: {
-    elementConfig: ConfigContainerChild;
-    layerInfo: QueryLayerServiceInfoDc;
-    attributes: FeatureAttribute[];
+    elementConfig?: ConfigContainerChild;
+    layerInfo?: QueryLayerServiceInfoDc;
+    attributes?: ClientFeatureAttribute[];
 }) => string;

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

@@ -14,6 +14,8 @@ export * from './formatDataSourceCondition';
 export * from './formatElementValue';
 export * from './getAttributeByName';
 export * from './getAttributeConfigurationByName';
+export * from './getAttributeIconElement';
+export * from './getAttributeIconUrl';
 export * from './getAttributesConfiguration';
 export * from './getAttributeValue';
 export * from './getChartAxes';
@@ -35,6 +37,7 @@ export * from './getFilterComponent';
 export * from './getFilterSelectedItems';
 export * from './getFilterValue';
 export * from './getFormattedAttributes';
+export * from './getImageUrl';
 export * from './getLayerInfo';
 export * from './getLayerInfoAttribute';
 export * from './getLayerInfoFromDataSources';