@evergis/react 4.0.165 → 4.0.166

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

@@ -1,11 +1,23 @@
+import { ReactNode } from 'react';
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, ConfigContainerHeader, ConfigOptions, ContainerProps, ContainerTemplate, FilterType, HeaderTemplate, NumericSizeOptions } from './types';
-export type ElementButtonOptions = Record<string, never>;
+import { ClientFeatureAttribute, ConfigButtonOptions, ConfigContainer, ConfigContainerChild, ConfigContainerHeader, ConfigOptions, ContainerProps, ContainerTemplate, FilterType, HeaderTemplate, NumericSizeOptions } from './types';
+export type ElementButtonOptions = ConfigButtonOptions & Pick<ConfigOptions, "icon" | "radius">;
 export interface ElementButtonConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "button";
     options?: ElementButtonOptions;
 }
-export interface ElementButtonProps extends Omit<ContainerProps, "elementConfig"> {
+/**
+ * Поведение, которое передаёт контейнер-хозяин слота `button` (например, Task).
+ * С `onClick` кнопка рисуется и без ссылки в атрибуте.
+ */
+export interface ElementButtonOverrides {
+    title?: string;
+    icon?: ReactNode;
+    color?: string;
+    disabled?: boolean;
+    onClick?: VoidFunction;
+}
+export interface ElementButtonProps extends Omit<ContainerProps, "elementConfig" | "onClick">, ElementButtonOverrides {
     elementConfig?: ElementButtonConfig;
 }
 export type ElementCameraOptions = Pick<ConfigOptions, "expandable" | "expanded">;
@@ -472,9 +484,22 @@ export interface TabsContainerProps extends Omit<ContainerProps, "elementConfig"
     elementConfig?: TabsContainerConfig;
 }
 export type TaskContainerOptions = Pick<ConfigOptions, "title" | "relatedResources" | "center" | "icon" | "statusColors" | "responseFilters" | "useNotifications"> & ContainerBoxOptions;
-export interface TaskContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
+export interface TaskButtonChild extends Omit<ElementButtonConfig, "id"> {
+    id: "button";
+}
+export interface TaskTitleChild extends Omit<ConfigContainerChild, "id" | "type"> {
+    id: "title";
+    type?: "text";
+}
+export interface TaskTitleIconChild extends Omit<ConfigContainerChild, "id" | "type"> {
+    id: "titleIcon";
+    type?: "icon";
+}
+export type TaskContainerChild = TaskButtonChild | TaskTitleChild | TaskTitleIconChild;
+export interface TaskContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName" | "children"> {
     templateName?: ContainerTemplate.Task;
     options?: TaskContainerOptions;
+    children?: TaskContainerChild[];
 }
 export interface TaskContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: TaskContainerConfig;

package/dist/components/Dashboard/containers/TaskContainer/components/StatusWaitingButton/index.d.ts

@@ -1,12 +1,3 @@
 import { FC } from 'react';
-import { RemoteTaskStatus } from '@evergis/api';
-import { IconTypesKeys } from '@evergis/uilib-gl';
-export declare const StatusWaitingButton: FC<{
-    title: string;
-    icon: IconTypesKeys;
-    status: RemoteTaskStatus;
-    statusColors: Record<RemoteTaskStatus, string>;
-    isWaiting: boolean;
-    isDisabled: boolean;
-    onClick: VoidFunction;
-}>;
+import { TaskButtonProps } from '../../types';
+export declare const StatusWaitingButton: FC<TaskButtonProps>;

package/dist/components/Dashboard/containers/TaskContainer/components/TaskButton/index.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { TaskSlotButtonProps } from '../../types';
+/** Кнопка запуска из слота `button`: вид — из слота, поведение и статусы — от контейнера. */
+export declare const TaskButton: FC<TaskSlotButtonProps>;

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

@@ -0,0 +1,2 @@
+/** Спиннер ожидания в цвете текста кнопки: круг-подложка приглушён, дуга — сплошная. */
+export declare const TaskButtonSpinner: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;

package/dist/components/Dashboard/containers/TaskContainer/hooks/useTaskButtonState.d.ts

@@ -0,0 +1,13 @@
+import { RemoteTaskStatus } from '@evergis/api';
+import { IconTypesKeys } from '@evergis/uilib-gl';
+interface UseTaskButtonStateProps {
+    status: RemoteTaskStatus;
+    title?: string;
+    icon?: IconTypesKeys;
+}
+/** Текст и иконка кнопки запуска: в исходном состоянии — заданные, иначе — по статусу задачи. */
+export declare const useTaskButtonState: ({ status, title, icon }: UseTaskButtonStateProps) => {
+    title: string;
+    iconKind: "symbol" | "function" | "auto" | "button" | "data" | "label" | "legend" | "link" | "map" | "menu" | "param" | "search" | "section" | "time" | "ellipse" | "filter" | "image" | "stop" | "text" | "id" | "cursor" | "points" | "restart" | "scale" | "key" | "download" | "list" | "error" | "next" | "alert" | "grid" | "heading" | "log" | "tree" | "bold" | "paint" | "layers" | "delete" | "save" | "menu_vertical" | "menu_horizontal" | "edit" | "tools" | "filter_apply" | "date" | "zoom_to" | "geom_raster" | "geom_point" | "geom_polygon" | "geom_multipolygon" | "geom_polyline" | "share" | "refresh" | "basemap" | "plus" | "minus" | "select_rect" | "select_circle" | "select_polygon" | "clear" | "measure_length" | "measure_area" | "home" | "bookmark" | "arrow_forward" | "arrow_back" | "message" | "location_pointer" | "close" | "maximize" | "minimize" | "maximize_solid" | "minimize_solid" | "to_last" | "play" | "prev" | "to_first" | "pause" | "upload" | "hide" | "expand" | "reduce" | "input_resizer" | "input_dropdown" | "classification" | "copy" | "phone" | "like" | "export_excel" | "location_coordinate" | "sorting_asc" | "sorting_des" | "password_show" | "password_hide" | "success" | "warning" | "star" | "social_vk" | "social_fb" | "social_google" | "social_github" | "social_vk_simple" | "social_fb_simple" | "social_google_simple" | "social_medium" | "geoprocessing" | "info" | "feedback" | "panel_hide" | "panel_show" | "feature_add" | "logo" | "lock" | "unlock" | "users" | "displayfield" | "textfile" | "image_paste" | "step_back" | "step_forward" | "pipette" | "calculation" | "geom_move" | "geom_poly_vertex" | "geom_poly_hole" | "geom_poly_slice" | "geom_poly_reshape" | "geom_poly_ungroup" | "geom_poly_autocomplete" | "geom_line_vertex" | "geom_line_addpart" | "geom_line_slice" | "geom_line_reshape" | "geom_line_ungroup" | "geom_undefined" | "icon_undefined" | "inverse" | "location_current" | "tools_buffer" | "tools_zones" | "tools_print" | "tools_spatial_selection" | "tools_aggregation" | "zip" | "catalog" | "catalog_variant" | "question" | "alpha" | "betta" | "dragdrop" | "equals" | "not_equals" | "contains" | "not_contains" | "greater_than" | "greater_or_equal" | "less_than" | "less_or_equal" | "starts_with" | "not_starts_with" | "ends_with" | "not_ends_with" | "empty" | "filled" | "raster_visible" | "raster_invisible" | "editgeom_point_addpart" | "divide" | "filter_layer" | "filter_table" | "img_generate" | "finish" | "transparentize" | "textLeft" | "textRight" | "textCenter" | "textJustify" | "externalway" | "evergis" | "geometryUnite" | "geometryCrop" | "roles" | "icon_block" | "configurations" | "settings_table" | "set_edit" | "set_read" | "set_configure" | "set_time" | "snapping" | "snap_1" | "snap_2" | "snap_3" | "slide" | "tags" | "statistics" | "alphabet_sort_za" | "alphabet_sort_az" | "inside_range" | "outside_range" | "tms" | "arc_gis" | "date_outside" | "wms_link" | "object_size" | "stroke_width" | "point_select" | "select_line" | "apply_selection" | "report" | "refresh_circle" | "date_filter" | "layer_filter_applied" | "attribute_filter_applied" | "geometry_selection_applied" | "attribute_filter" | "layer_filter" | "layers_add" | "geo_location" | "geom_types" | "date_aggregation" | "public_group" | "social_tg" | "rounded_triangle" | "zoom_in" | "zoom_out" | "checkboxes" | "sum" | "datetime" | "double" | "int" | "local_tile_service" | "arcgis_service" | "wms_service" | "text_format" | "coordinates_actions" | "xy" | "group_features" | "ungroup_features" | "preview" | "triangle" | "rectangle" | "themed_symbol" | "selection" | "table_link" | "cell_size" | "symbol_library" | "globe" | "tree_folder_closed" | "tree_folder_opened" | "add_group" | "ungroup" | "feature_card" | "moon" | "sun" | "logout" | "search_selection" | "suggestions" | "social_dzen" | "social_youtube" | "query" | "table_empty" | "shared_group" | "text_frame" | "file_catalog" | "attachment" | "stats" | "loading_circle" | "layer_option" | "change_geom" | "settings_horizontal" | "text_editor" | "dashboard_loading" | "dashboard_placeholder" | "sort" | "postgresql" | "bigquery" | "amazon_s3" | "databricks" | "redshift" | "server_connection" | "service_connection" | "column_increment" | "column_unique" | "column_nullable" | "projection" | "card" | "zones_selection" | "walking" | "selection_route" | "pulse" | "tree_vertical" | "tool_settings" | "folder_outline" | "percent" | "run" | "table_view" | "text_view" | "in_map" | "tables" | "collapse" | "expand_all" | "quote" | "list_ordered" | "list_unordered" | "italic" | "filter_switcher" | "arrow_down" | "arrow_up" | "new_window" | "line_numbers" | "python" | "config" | "pc" | "social_yandex" | "tab_icon" | "disk" | "ram" | "cpu" | "select_point" | "page_add" | "page_menu" | "stack" | "calc_attribute" | "calc_attribute_attribute" | "calc_attribute_value" | "calc_geometry" | "camera" | "pdf" | "slideshow" | "edit_container" | "default_attributes" | "progress_bar" | "section_add" | "section_remove" | "connections" | "pie_chart" | "line_chart" | "stack_chart" | "datasource" | "tabs" | "check_toggle" | "cadastr" | "office" | "layer_eye" | "ai" | "bool" | "json" | "rollup" | "no_geom" | "symbol_text" | "text_circle" | "heatmap" | "cube" | "extrude" | "transition" | "stop_circle" | "token" | "star_symbol" | "text_plain" | "geom_shapes";
+};
+export {};

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

@@ -0,0 +1,16 @@
+import { RemoteTaskStatus } from '@evergis/api';
+import { IconTypesKeys } from '@evergis/uilib-gl';
+import { TaskButtonChild, WidgetType } from '../../types';
+export interface TaskButtonProps {
+    title: string;
+    icon?: IconTypesKeys;
+    status: RemoteTaskStatus;
+    statusColors?: Record<RemoteTaskStatus, string>;
+    isWaiting: boolean;
+    isDisabled: boolean;
+    onClick: VoidFunction;
+}
+export interface TaskSlotButtonProps extends TaskButtonProps {
+    type?: WidgetType;
+    buttonConfig: TaskButtonChild;
+}

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

@@ -0,0 +1,6 @@
+import { IconButtonVariant } from '@evergis/uilib-gl';
+import { ElementButtonOptions } from '../../types';
+/** Опции внешнего вида: хотя бы одна из них переводит кнопку-ссылку на IconButton. */
+export declare const ELEMENT_BUTTON_APPEARANCE_KEYS: (keyof ElementButtonOptions)[];
+export declare const ELEMENT_BUTTON_COLOR_FLAGS: readonly ["primary", "secondary", "error", "violet"];
+export declare const DEFAULT_ELEMENT_BUTTON_VARIANT: IconButtonVariant;

package/dist/components/Dashboard/elements/ElementButton/utils/getElementButtonProps.d.ts

@@ -0,0 +1,8 @@
+import { IIconButtonProps } from '@evergis/uilib-gl';
+import { ElementButtonOptions } from '../../../types';
+export declare const hasButtonAppearance: (options?: ElementButtonOptions) => boolean;
+/**
+ * Пропсы IconButton из опций элемента. Без цвета и флагов цвета кнопка — primary;
+ * нейтральная задаётся явным `primary: false`. `color` контейнера перекрывает цвет из опций.
+ */
+export declare const getElementButtonProps: (options?: ElementButtonOptions, color?: string) => IIconButtonProps;

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

@@ -2,7 +2,7 @@ import { CSSProperties, FC, ReactNode } from 'react';
 import { FeatureCollection, Geometry } from 'geojson';
 import { i18n } from 'i18next';
 import { PieChartData, BarChartMarker } from '@evergis/charts';
-import { IconTypesKeys, IOption } from '@evergis/uilib-gl';
+import { IconButtonShape, IconButtonSize, IconButtonVariant, IconTypesKeys, IOption } from '@evergis/uilib-gl';
 import { CircleLayerSpecification, FillLayerSpecification, LineLayerSpecification } from 'maplibre-gl';
 import { AttributeType, EqlRequestDc, FeatureDc, OgcGeometryType, PagedFeaturesListDc, PositionDc, QueryLayerServiceInfoDc, RemoteTaskStatus, StringSubType, AttributesConfigurationDc } from '@evergis/api';
 import { FeatureAttributeValue, EditGeometryType, ThemeName } from '../../types';
@@ -413,6 +413,27 @@ export interface ConfigChartOptions {
     /** Подписи осей и подпись оси X. Работает только у линейного графика. */
     axis?: ConfigChartAxisOptions;
 }
+/**
+ * Внешний вид кнопки (`IconButton` из uilib-gl). Скругление вручную — `radius` (px)
+ * из {@link ConfigLayoutOptions}, иконка — `icon` из {@link ConfigVisualOptions}.
+ */
+export interface ConfigButtonOptions {
+    /** Заливка и обводка: `solid` | `soft` | `outline` | `ghost`. */
+    variant?: IconButtonVariant;
+    /** Произвольный CSS-цвет; перекрывает флаги цвета. Оттенки наведения и нажатия вычисляются. */
+    color?: string;
+    /** Флаги цвета, приоритет: primary → secondary → error → violet. Без флагов и `color` — нейтральный. */
+    primary?: boolean;
+    secondary?: boolean;
+    error?: boolean;
+    violet?: boolean;
+    /** Высота 24 / 32 / 40 / 48. */
+    size?: IconButtonSize;
+    /** `square` — скругление по размеру, `round` — пилюля/круг. */
+    shape?: IconButtonShape;
+    /** Иконка справа от текста. */
+    iconRight?: boolean;
+}
 /** Иконки/изображения. */
 export interface ConfigVisualOptions {
     icon?: IconTypesKeys;
@@ -561,7 +582,7 @@ export type ConfigNotifications = "all" | "my" | string[];
  * `Pick<ConfigOptions, ...>`, продолжают работать. Для нового кода предпочтительно делать
  * `Pick<Config<Domain>Options, ...>` — это лучше документирует, к какому домену относится опция.
  */
-export interface ConfigOptions extends ConfigLayoutOptions, ConfigTypographyOptions, ConfigExpandableOptions, ConfigDataSourceBindingOptions, ConfigChartOptions, ConfigVisualOptions, ConfigTextDisplayOptions, ConfigCollectionOptions, ConfigMapLayerOptions, ConfigEditOptions, ConfigVoteOptions, ConfigMiscOptions {
+export interface ConfigOptions extends ConfigLayoutOptions, ConfigTypographyOptions, ConfigExpandableOptions, ConfigDataSourceBindingOptions, ConfigChartOptions, ConfigButtonOptions, ConfigVisualOptions, ConfigTextDisplayOptions, ConfigCollectionOptions, ConfigMapLayerOptions, ConfigEditOptions, ConfigVoteOptions, ConfigMiscOptions {
 }
 /**
  * Настройки атрибута источника данных, заданные в конфиге.