@evergis/react 4.0.125 → 4.0.128

package/dist/components/Dashboard/elements/registry.d.ts

@@ -14,4 +14,5 @@ export declare const elementComponents: {
     readonly markdown: import('react').FC<import('../componentTypes').ElementMarkdownProps>;
     readonly uploader: import('react').FC<import('../componentTypes').ElementUploaderProps>;
     readonly modal: import('react').FC<import('../componentTypes').ElementModalProps>;
+    readonly table: import('react').FC<import('../componentTypes').ElementTableProps>;
 };

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

@@ -1,5 +1,5 @@
 import { CSSProperties, FC, ReactNode } from 'react';
-import { Geometry } from 'geojson';
+import { FeatureCollection, Geometry } from 'geojson';
 import { i18n } from 'i18next';
 import { PieChartData, BarChartMarker } from '@evergis/charts';
 import { IconTypesKeys, IOption } from '@evergis/uilib-gl';
@@ -189,13 +189,16 @@ export interface ConfigLayoutOptions {
      */
     grid?: boolean;
     /**
-     * Режим редактирования РАСКЛАДКИ сетки: перетаскивание границ, выделение ячеек,
-     * контекстное меню с объединением/разделением/удалением. Читается только у внешнего
-     * узла с `grid`; вложенные сетки наследуют режим через контекст.
+     * Разрешение править содержимое контейнера. Читают двое:
+     * - `ContainersGroup` с `grid` — режим редактирования РАСКЛАДКИ: перетаскивание границ,
+     *   выделение ячеек, контекстное меню с объединением/разделением/удалением. Берётся только
+     *   у внешнего узла сетки; вложенные наследуют режим через контекст;
+     * - `StructuredData` — режим редактирования ТАБЛИЦЫ: правка ячеек, добавление и удаление
+     *   строк, кнопки «Отменить»/«Сохранить». Не задан или `false` — таблица только на чтение.
      *
      * Не путать с `editMode` у `DashboardProvider`/`FeatureCardProvider` (в контейнерах —
-     * `isEditing`): тот переключает редактирование АТРИБУТОВ объекта и к раскладке отношения
-     * не имеет.
+     * `isEditing`): тот переключает редактирование АТРИБУТОВ объекта и к содержимому
+     * контейнеров отношения не имеет.
      */
     editMode?: boolean;
     /**
@@ -292,6 +295,13 @@ export interface ConfigExpandableOptions {
 }
 /** Связь с источником данных. */
 export interface ConfigDataSourceBindingOptions {
+    /**
+     * Схема структурированных данных контейнера {@link ContainerTemplate.StructuredData}.
+     *
+     * С источником — переопределение схемы источника: типы приходят от него, конфиг задаёт состав,
+     * `alias`, `stringFormat` и `isEditable`. Без источника — единственный источник схемы, обязателен.
+     */
+    attributesDescription?: ConfigAttributeDescription[];
     /** ⚠️ entity-ref: имя источника. */
     relatedDataSource?: string;
     relatedDataSources?: ConfigRelatedDataSource[];
@@ -348,6 +358,14 @@ export interface ConfigCollectionOptions {
     otherItems?: number;
     orderByValue?: boolean;
     orderByTitle?: boolean;
+    /**
+     * Имена атрибутов схемы, показываемые колонками представления `table`. Подмножество
+     * `attributesDescription` родительского контейнера; порядок колонок — порядок этого массива.
+     * Не задано — показываются все атрибуты схемы.
+     */
+    columnNames?: string[];
+    /** Разрешить сортировку представления кликом по заголовку колонки. Сортировка локальная — только вид. */
+    sort?: boolean;
     viewMode?: ViewMode;
     hideEmpty?: boolean;
     limit?: number;
@@ -437,6 +455,21 @@ export interface ConfigDataSourceAttribute {
     description?: string;
     stringFormat?: AttributeFormatConfiguration;
 }
+/**
+ * Описание одного атрибута структуры для {@link ConfigDataSourceBindingOptions.attributesDescription}.
+ *
+ * Повторяет форму `AttributeConfigurationDc` из `@evergis/api`, но со `stringFormat` пакета
+ * ({@link AttributeFormatConfiguration} = DC + `roundDigitGroup`) — так же, как {@link ConfigDataSourceAttribute}.
+ */
+export interface ConfigAttributeDescription {
+    attributeName: string;
+    type?: AttributeType;
+    alias?: string;
+    description?: string;
+    /** Значение атрибута правится в ячейке. `false` — только чтение, в features-API не передаётся. */
+    isEditable?: boolean;
+    stringFormat?: AttributeFormatConfiguration;
+}
 export interface ConfigDataSource {
     name: string;
     alias?: string;
@@ -460,7 +493,16 @@ export interface EqlDataSource {
     items: FeatureDc[];
     attributes?: AttributesConfigurationDc["attributes"];
 }
-export type ConfigFilterValueType = "single" | "range" | "array";
+/**
+ * Вид значения фильтра. Задаётся в конфиге и служит дискриминатором для type guard-ов
+ * (`isTreeFilterValue`, `isFeaturesFilterValue`) — угадывать вид по форме значения нельзя:
+ * `tree` и `features` оба объекты.
+ *
+ * - `single` / `range` / `array` — скалярные значения, подставляются и в `condition`, и в `parameters`;
+ * - `tree` — {@link TreeFilterValue}, объект «уровень → массив id» (плейсхолдеры `%name.lN`);
+ * - `features` — {@link FeaturesFilterValue}, подставляется ТОЛЬКО в `parameters`, в `condition` — никогда.
+ */
+export type ConfigFilterValueType = "single" | "range" | "array" | "tree" | "features";
 export interface ConfigFilter {
     name: string;
     relatedDataSource?: string;
@@ -506,13 +548,22 @@ export interface ChipOption {
  * Пример: `{ l1: [1, 2], l3: [1023] }`.
  */
 export type TreeFilterValue = Record<string, Array<string | number>>;
+/**
+ * Значение фильтра `valueType: "features"` — коллекция строк структурированных данных
+ * ({@link ContainerTemplate.StructuredData}). Геометрия не поддерживается, поэтому у всех фич
+ * `geometry: null`; данные строки лежат в `properties`.
+ *
+ * Подставляется только в `parameters` (питон-таска, url-источник). В `condition` не попадает
+ * никогда: там значение прошло бы через `formatConditionValue` и выродилось в `[object Object]`.
+ */
+export type FeaturesFilterValue = FeatureCollection<null, Record<string, FeatureAttributeValue>>;
 export interface SelectedFilter {
-    value: string | number | string[] | number[] | Date | Date[] | TreeFilterValue;
+    value: string | number | string[] | number[] | Date | Date[] | TreeFilterValue | FeaturesFilterValue;
     min?: string | number | Date;
     max?: string | number | Date;
 }
-/** Значение фильтра без объектного варианта "tree" — для скалярных/массивных фильтров. */
-export type ScalarFilterValue = Exclude<SelectedFilter["value"], TreeFilterValue>;
+/** Значение фильтра без объектных вариантов "tree"/"features" — для скалярных/массивных фильтров. */
+export type ScalarFilterValue = Exclude<SelectedFilter["value"], TreeFilterValue | FeaturesFilterValue>;
 export interface ConfigLayer {
     name: string;
     alias?: string;
@@ -585,15 +636,19 @@ export type FilterType = "checkbox" | "rangeNumber" | "rangeDate" | "text" | "dr
  *   `"attributeValue"`, `"attributeUnits"`, `"attributeDescription"`, `"layerName"`.
  * - элементы-компоненты (`elements/registry.ts`): `"control"`, `"image"`, `"slideshow"`, `"svg"`,
  *   `"icon"`, `"tooltip"`, `"tags"`, `"link"`, `"button"`, `"camera"`, `"chart"`, `"legend"`,
- *   `"markdown"`, `"uploader"`, `"modal"`.
+ *   `"markdown"`, `"uploader"`, `"modal"`, `"table"`.
  *
  * Slot-id (`"alias"`, `"value"`, `"units"`, ...) сюда **не относится** — это значения поля
  * `id`, см. parent-specific child-типы.
  */
-export type ConfigElementType = "text" | "attributeAlias" | "attributeValue" | "attributeUnits" | "attributeDescription" | "layerName" | "control" | "image" | "slideshow" | "svg" | "icon" | "tooltip" | "tags" | "link" | "button" | "camera" | "chart" | "legend" | "markdown" | "uploader" | "modal";
+export type ConfigElementType = "text" | "attributeAlias" | "attributeValue" | "attributeUnits" | "attributeDescription" | "layerName" | "control" | "image" | "slideshow" | "svg" | "icon" | "tooltip" | "tags" | "link" | "button" | "camera" | "chart" | "legend" | "markdown" | "uploader" | "modal" | "table";
 export interface ConfigContainerChild extends Partial<ConfigContainer> {
     id?: string;
-    type?: ConfigElementType;
+    /**
+     * Узел-лист. Кроме элементов сюда попадают фильтры — дети FiltersContainer тоже узлы конфига,
+     * а их `type` берётся из {@link FilterType}, а не из {@link ConfigElementType}.
+     */
+    type?: ConfigElementType | FilterType;
     templateName?: ContainerTemplate | HeaderTemplate;
     value?: string | number;
     defaultValue?: string | number;
@@ -642,7 +697,8 @@ export declare enum ContainerTemplate {
     EditDate = "EditDate",
     EditAttachment = "EditAttachment",
     Attachment = "Attachment",
-    Divider = "Divider"
+    Divider = "Divider",
+    StructuredData = "StructuredData"
 }
 export declare enum HeaderTemplate {
     Default = "Default",

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

@@ -1,9 +1,4 @@
-import { SelectedFilter, TreeFilterValue } from '../types';
-/**
- * Объектное значение иерархического фильтра "tree" («уровень → массив id»),
- * в отличие от скалярных/массивных значений остальных фильтров.
- */
-export declare const isTreeFilterValue: (value?: SelectedFilter["value"]) => value is TreeFilterValue;
+import { TreeFilterValue } from '../types';
 /**
  * Подставляет плейсхолдеры уровней `%name.l{N}` значениями id соответствующего уровня
  * (формат `[id1,id2,...]` для оператора IN). Уровни, отсутствующие в значении (или пустые),

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

@@ -0,0 +1,19 @@
+import { ConfigFilter, FeaturesFilterValue, SelectedFilter, TreeFilterValue } from '../types';
+/**
+ * Значение фильтра `valueType: "features"` — FeatureCollection со строками структурированных
+ * данных (контейнер `StructuredData`).
+ *
+ * Форма самодостаточна (`type: "FeatureCollection"`), поэтому конфиг для проверки не нужен.
+ */
+export declare const isFeaturesFilterValue: (value?: SelectedFilter["value"]) => value is FeaturesFilterValue;
+/**
+ * Объектное значение иерархического фильтра "tree" («уровень → массив id»).
+ *
+ * Вид значения определяется по конфигу фильтра: угадывать его по форме ненадёжно — `tree` и
+ * `features` оба объекты. Решают только два значения `valueType`: `"tree"` — да, `"features"` — нет.
+ * Всё остальное уходит в структурный фолбэк: у tree-фильтров в существующих конфигах `valueType`
+ * либо не проставлен, либо объявлен как `"array"` (значение при этом всё равно объектное), и
+ * трактовать такой фильтр как не-tree значило бы сломать их. Фолбэк намеренно узкий: ключи вида
+ * `l{N}`, значения — массивы. Пустой объект — это tree с пустым выбором, а не «неизвестное значение».
+ */
+export declare const isTreeFilterValue: (value?: SelectedFilter["value"], configFilter?: ConfigFilter) => value is TreeFilterValue;

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

@@ -1,12 +1,13 @@
 import { QueryLayerServiceConfigurationDc } from '@evergis/api';
 import { ClientFeatureAttribute, ConfigFilter, SelectedFilter, SelectedFilters } from '../types';
-export declare const applyFiltersToCondition: ({ condition, name, defaultValue, filters, isSingle, isSetParams, }: {
+export declare const applyFiltersToCondition: ({ condition, name, defaultValue, filters, isSingle, isSetParams, configFilter, }: {
     condition: string;
     name: string;
     defaultValue: SelectedFilter["value"];
     filters: SelectedFilters;
     isSingle?: boolean;
     isSetParams?: boolean;
+    configFilter?: ConfigFilter;
 }) => string | number;
 export declare const applyVarsToCondition: <T extends string | string[]>({ section, configFilters, filters, attributes, layerParams, eqlParameters, geometry, isSetParams, }: Pick<QueryLayerServiceConfigurationDc, "eqlParameters"> & {
     section: T;

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

@@ -1,2 +1,2 @@
 import { SelectedFilter, SelectedFilters } from '../types';
-export declare const getSelectedFilterValue: (filterName: string, selectedFilters: SelectedFilters, defaultValue: SelectedFilter["value"]) => string | number | Date | import('../types').TreeFilterValue | (string | number | Date | import('../types').TreeFilterValue)[];
+export declare const getSelectedFilterValue: (filterName: string, selectedFilters: SelectedFilters, defaultValue: SelectedFilter["value"]) => string | number | Date | import('../types').TreeFilterValue | import('../types').FeaturesFilterValue | (string | number | Date | import('../types').TreeFilterValue | import('../types').FeaturesFilterValue)[];

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

@@ -11,6 +11,7 @@ export * from './eqlParametersToPayload';
 export * from './formatChartRelatedValue';
 export * from './formatConditionValue';
 export * from './fetchQueryDescription';
+export * from './filterValueKind';
 export * from './formatDataSourceCondition';
 export * from './formatElementValue';
 export * from './getAttributeByName';

package/dist/constants/styling.d.ts

@@ -16,7 +16,7 @@ export declare const DEFAULT_SYMBOL_HALO_COLOR = "#ffffff";
 export declare const DEFAULT_SYMBOL_PLACEMENT = "point";
 export declare const DEFAULT_SYMBOL_SPACING = 250;
 export declare const DEFAULT_ICON_OVERLAP = "never";
-export declare const DEFAULT_ICON_SIZE = 1;
+export declare const DEFAULT_ICON_SIZE = 0.5;
 export declare const DEFAULT_ICON_ANCHOR = "center";
 export declare const DEFAULT_ICON_PADDING: number[];
 export declare const DEFAULT_ICON_ROTATE = 0;

package/dist/hooks/map/useIconsFromLayers.d.ts

@@ -1,4 +1,4 @@
-import { ClientStyle } from '../../types/styling';
+import { ClientStyle } from '../../types';
 export interface LayerIconConfig {
     /** Идентификатор слоя */
     layerId: string;