@evergis/react 4.0.124 → 4.0.127

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,5 +1,5 @@
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, ConfigContainerHeader, ConfigOptions, ContainerProps, ContainerTemplate, HeaderTemplate, NumericSizeOptions } from './types';
+import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, ConfigContainerHeader, ConfigOptions, ContainerProps, ContainerTemplate, FilterType, HeaderTemplate, NumericSizeOptions } from './types';
 export type ElementButtonOptions = Record<string, never>;
 export interface ElementButtonConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "button";
@@ -109,6 +109,14 @@ export interface ElementSvgProps extends Omit<ContainerProps, "elementConfig"> {
     layerInfo?: QueryLayerServiceInfoDc;
     attributes?: ClientFeatureAttribute[];
 }
+export type ElementTableOptions = Pick<ConfigOptions, "columnNames" | "sort">;
+export interface ElementTableConfig extends Omit<ConfigContainerChild, "options" | "type"> {
+    type?: "table";
+    options?: ElementTableOptions;
+}
+export interface ElementTableProps extends Omit<ContainerProps, "elementConfig"> {
+    elementConfig?: ElementTableConfig;
+}
 export type ElementTooltipOptions = Pick<ConfigOptions, "icon">;
 export interface ElementTooltipConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "tooltip";
@@ -192,7 +200,7 @@ export interface ChartContainerConfig extends Omit<ConfigContainerChild, "option
 export interface ChartContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ChartContainerConfig;
 }
-export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "alignItems" | "grid" | "editMode" | "fixedHeight" | "gap"> & ContainerBoxOptions;
+export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "alignItems" | "grid" | "editMode" | "fixedHeight" | "autoHeight" | "gap"> & ContainerBoxOptions;
 export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.ContainersGroup;
     options?: ContainersGroupContainerOptions;
@@ -332,12 +340,13 @@ export type FiltersContainerOptions = Pick<ConfigOptions, "padding" | "bgColor"
 /**
  * Опции ребёнка FiltersContainer. Набор — объединение того, что реально читают все восемь
  * реализаций фильтра: dropdown берёт `variants`/`noEmptyOption`, text — `searchFilterName`
- * и `multiSelect`, chips — цвета и иконку, rangeNumber — `step` и границы, rangeDate — `withTime`.
+ * и `multiSelect`, chips — цвета и иконку, rangeNumber — `step` и границы, rangeDate — `withTime`,
+ * barChart — геометрию столбцов (`barWidth`/`padding`/`barHeight`/`radius`) и палитру.
  */
-export type FilterChildOptions = Pick<ConfigOptions, "filterName" | "searchFilterName" | "label" | "placeholder" | "control" | "controls" | "relatedDataSource" | "minValue" | "maxValue" | "step" | "withTime" | "multiSelect" | "variants" | "noEmptyOption" | "width" | "height" | "align" | "shownItems" | "icon" | "iconAttribute" | "colorAttribute" | "fontColor" | "backgroundColor" | "maxTextWidth">;
+export type FilterChildOptions = Pick<ConfigOptions, "filterName" | "searchFilterName" | "label" | "placeholder" | "control" | "controls" | "relatedDataSource" | "minValue" | "maxValue" | "step" | "withTime" | "multiSelect" | "variants" | "noEmptyOption" | "width" | "height" | "align" | "shownItems" | "icon" | "iconAttribute" | "colorAttribute" | "fontColor" | "backgroundColor" | "maxTextWidth" | "barWidth" | "barHeight" | "padding" | "radius" | "markers" | "colors" | "defaultColor" | "primaryColor" | "drawMinMax">;
 export interface FilterChild extends Omit<ConfigContainerChild, "options" | "type"> {
-    /** {@link FilterType} оставляем строкой, чтобы не плодить два почти одинаковых union-а в `type`. */
-    type?: ConfigContainerChild["type"];
+    /** Тип фильтра — по нему FiltersContainer выбирает реализацию. */
+    type?: FilterType;
     options?: FilterChildOptions;
 }
 export interface FiltersContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName" | "children"> {
@@ -348,7 +357,7 @@ export interface FiltersContainerConfig extends Omit<ConfigContainerChild, "opti
 export interface FiltersContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: FiltersContainerConfig;
 }
-export type GridRowContainerOptions = Pick<ConfigOptions, "gap" | "alignItems"> & ContainerBoxOptions;
+export type GridRowContainerOptions = Pick<ConfigOptions, "gap" | "alignItems" | "autoHeight"> & ContainerBoxOptions;
 export interface GridRowContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.GridRow;
     options?: GridRowContainerOptions;
@@ -423,6 +432,32 @@ export interface SlideshowContainerConfig extends Omit<ConfigContainerChild, "op
 export interface SlideshowContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: SlideshowContainerConfig;
 }
+export type StructuredDataContainerOptions = Pick<ConfigOptions, "attributesDescription" | "relatedDataSource" | "filterName" | "editMode" | "expandable" | "expanded"> & ContainerBoxOptions;
+export interface StructuredDataTableChild extends Omit<ConfigContainerChild, "id" | "type" | "options"> {
+    id: "data";
+    type?: "table";
+    options?: ElementTableOptions;
+}
+export interface StructuredDataAliasChild extends Omit<ConfigContainerChild, "id"> {
+    id: "alias";
+}
+export interface StructuredDataTitleChild extends Omit<ConfigContainerChild, "id" | "type"> {
+    id: "title";
+    type?: "text";
+}
+export interface StructuredDataTitleIconChild extends Omit<ConfigContainerChild, "id" | "type"> {
+    id: "titleIcon";
+    type?: "icon";
+}
+export type StructuredDataContainerChild = StructuredDataTableChild | StructuredDataAliasChild | StructuredDataTitleChild | StructuredDataTitleIconChild;
+export interface StructuredDataContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName" | "children"> {
+    templateName?: ContainerTemplate.StructuredData;
+    options?: StructuredDataContainerOptions;
+    children?: StructuredDataContainerChild[];
+}
+export interface StructuredDataContainerProps extends Omit<ContainerProps, "elementConfig"> {
+    elementConfig?: StructuredDataContainerConfig;
+}
 export type TabsContainerOptions = Pick<ConfigOptions, "radius" | "column" | "bgColor" | "noBg" | "onlyIcon" | "shownItems" | "maxLength" | "wordBreak">;
 export type TabOptions = Pick<ConfigOptions, "icon">;
 export interface TabChild extends Omit<ConfigContainerChild, "options" | "type" | "children"> {
@@ -497,7 +532,7 @@ export interface FeatureCardSlideshowHeaderConfig extends Omit<ConfigContainerHe
  * Поскольку оба поля помечены как опциональные (`?`), значения **без** дискриминатора по-прежнему
  * приемлемы для любой ветви — это переходная мягкая совместимость с legacy-конфигами.
  */
-export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTooltipConfig | ElementUploaderConfig | AddFeatureContainerConfig | AttachmentContainerConfig | CameraContainerConfig | ChartContainerConfig | ContainersGroupContainerConfig | DataSourceContainerConfig | DataSourceProgressContainerConfig | DefaultAttributesContainerConfig | DividerContainerElementConfig | EditContainerConfig | EditGroupContainerConfig | EditBooleanContainerConfig | EditStringContainerConfig | EditNumberContainerConfig | EditDropdownContainerConfig | EditChipsContainerConfig | EditCheckboxContainerConfig | EditDateContainerConfig | EditAttachmentContainerConfig | ExportPdfContainerConfig | FiltersContainerConfig | GridRowContainerConfig | IconContainerConfig | ImageContainerConfig | LayersContainerConfig | OneColumnContainerConfig | ProgressContainerConfig | RoundedBackgroundContainerConfig | SlideshowContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig;
+export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTableConfig | ElementTooltipConfig | ElementUploaderConfig | AddFeatureContainerConfig | AttachmentContainerConfig | CameraContainerConfig | ChartContainerConfig | ContainersGroupContainerConfig | DataSourceContainerConfig | DataSourceProgressContainerConfig | DefaultAttributesContainerConfig | DividerContainerElementConfig | EditContainerConfig | EditGroupContainerConfig | EditBooleanContainerConfig | EditStringContainerConfig | EditNumberContainerConfig | EditDropdownContainerConfig | EditChipsContainerConfig | EditCheckboxContainerConfig | EditDateContainerConfig | EditAttachmentContainerConfig | ExportPdfContainerConfig | FiltersContainerConfig | GridRowContainerConfig | IconContainerConfig | ImageContainerConfig | LayersContainerConfig | OneColumnContainerConfig | ProgressContainerConfig | RoundedBackgroundContainerConfig | SlideshowContainerConfig | StructuredDataContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig;
 /**
  * Строгий authoring-тип узла конфига. В отличие от мягкого {@link ConfigContainerChild}
  * (`id?` — опционален ради legacy-совместимости), здесь `id` **обязателен** и рекурсивно
@@ -574,6 +609,7 @@ export type ContainerTemplateToProps = {
     [ContainerTemplate.Progress]: ProgressContainerProps;
     [ContainerTemplate.RoundedBackground]: RoundedBackgroundContainerProps;
     [ContainerTemplate.Slideshow]: SlideshowContainerProps;
+    [ContainerTemplate.StructuredData]: StructuredDataContainerProps;
     [ContainerTemplate.Tabs]: TabsContainerProps;
     [ContainerTemplate.Task]: TaskContainerProps;
     [ContainerTemplate.Title]: TitleContainerProps;
@@ -603,6 +639,7 @@ export type ElementTypeToProps = {
     markdown: ElementMarkdownProps;
     uploader: ElementUploaderProps;
     modal: ElementModalProps;
+    table: ElementTableProps;
 };
 /**
  * Типобезопасный реестр контейнеров. Ключ `default` указывает FC для случая, когда `templateName`

package/dist/components/Dashboard/containers/GridRowContainer/index.d.ts

@@ -7,5 +7,9 @@ import { GridRowContainerProps } from '../../types';
  * доля строки (`options.height`) читается РОДИТЕЛЬСКОЙ сеткой при сборке `grid-template-rows`,
  * а сама строка получает от неё готовую высоту трека — и занимает её целиком
  * ({@link GRID_FILL_DEFAULTS}), иначе колонки внутри строки схлопнулись бы до содержимого.
+ *
+ * Собственный `options.autoHeight` строки заменяет это «целиком» на минимум и разрешает ЯЧЕЙКАМ
+ * растить строку своим содержимым. Родительская сетка увидит рост, только если включила
+ * `autoHeight` у себя: опция читается у каждого узла и вверх сама не поднимается.
  */
 export declare const GridRowContainer: FC<GridRowContainerProps>;

package/dist/components/Dashboard/containers/StructuredDataContainer/StructuredDataContext.d.ts

@@ -0,0 +1,9 @@
+import { StructuredDataContextValue } from './types';
+/**
+ * Канал «контейнер → представление». Схему, строки и колбэки правки держит
+ * `StructuredDataContainer`, а рендерит их элемент-представление (`ElementTable`),
+ * который контейнер получает слотом `data` через `renderElement`.
+ *
+ * Значение `null` означает, что представление отрендерили вне контейнера — рендерить нечего.
+ */
+export declare const StructuredDataContext: import('react').Context<StructuredDataContextValue>;

package/dist/components/Dashboard/containers/StructuredDataContainer/components/DeleteRowDialog.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+export interface DeleteRowDialogProps {
+    isOpen: boolean;
+    /** Удаление реальных объектов источника необратимо — предупреждаем об этом отдельно. */
+    isSourceRow: boolean;
+    onConfirm: VoidFunction;
+    onCancel: VoidFunction;
+}
+export declare const DeleteRowDialog: FC<DeleteRowDialogProps>;

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

@@ -0,0 +1,14 @@
+import { AttributeType } from '@evergis/api';
+/**
+ * Типы атрибутов с редактором ячейки. Атрибут любого другого типа показывается только на чтение,
+ * даже если помечен `isEditable: true` — редактора для него нет.
+ */
+export declare const EDITABLE_ATTRIBUTE_TYPES: AttributeType[];
+/** Типы, для которых ячейка редактируется числовым инпутом. */
+export declare const NUMBER_EDITOR_TYPES: AttributeType[];
+/** Типы, значение которых хранится целым числом — дробную часть в них не пускаем. */
+export declare const INTEGER_ATTRIBUTE_TYPES: AttributeType[];
+/** Тип атрибута, когда его не задали ни конфиг, ни источник. */
+export declare const DEFAULT_ATTRIBUTE_TYPE = AttributeType.String;
+/** Сколько миллисекунд висит нотификация об ошибке записи. */
+export declare const SAVE_ERROR_DURATION = 5000;

package/dist/components/Dashboard/containers/StructuredDataContainer/index.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { StructuredDataContainerProps } from '../../types';
+/**
+ * Таблица структурированных данных со схемой в конфиге.
+ *
+ * Контейнер владеет схемой, черновиком и записью, а рисует данные ребёнок-представление
+ * (слот `data`, элемент `table`) — он получает всё через {@link StructuredDataContext}.
+ * Правки копятся в черновике: источник и потребители фильтра узнают о них только по «Сохранить».
+ */
+export declare const StructuredDataContainer: FC<StructuredDataContainerProps>;

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

@@ -0,0 +1,18 @@
+/**
+ * Панель действий: добавление строки слева, запись и откат — справа.
+ *
+ * Вторая группа прижимается к краю собственным `margin-left: auto`, а не раскладкой панели:
+ * родительский `Container` в режиме колонки перебивает выравнивание своих детей
+ * (`&&& > * { justify-content: flex-start }`), и `justify-content` здесь не сработал бы.
+ */
+export declare const StructuredDataToolbar: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+/**
+ * Группа кнопок панели. `width: auto` обязателен: базовый `Flex` растянут на 100%, и две
+ * такие группы делили бы панель пополам — правая начиналась бы из середины вместо края.
+ */
+export declare const StructuredDataActions: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+/**
+ * Область представления. Прокручивается внутри себя, чтобы длинная таблица не растягивала
+ * контейнер за пределы отведённой ему ячейки; `min-height: 0` разрешает flex-ребёнку сжиматься.
+ */
+export declare const StructuredDataView: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;

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

@@ -0,0 +1,48 @@
+import { AttributeType } from '@evergis/api';
+import { FeatureAttributeValue } from '../../../../types';
+import { ConfigAttributeDescription } from '../../types';
+/** Состояние строки черновика относительно последнего сохранения. */
+export type DraftRowState = "pristine" | "created" | "updated" | "deleted";
+/**
+ * Строка черновика. Правки копятся здесь и уходят в источник и потребителям фильтра
+ * только по «Сохранить» — прецедент staging'а взят у tree-фильтра (`useTreeFilterSelection`).
+ */
+export interface DraftRow {
+    /**
+     * Стабильный локальный ключ строки. Живёт независимо от `featureId`: у добавленной вручную
+     * строки id источника появляется только после успешного создания.
+     */
+    key: string;
+    /** Id объекта источника. Нет — строка в источнике ещё не создана. */
+    featureId?: string;
+    properties: Record<string, FeatureAttributeValue>;
+    state: DraftRowState;
+}
+/** Атрибут схемы после слияния `attributesDescription` с атрибутами источника. */
+export interface StructuredDataAttribute {
+    attributeName: string;
+    type: AttributeType;
+    alias: string;
+    description?: string;
+    isEditable: boolean;
+    stringFormat?: ConfigAttributeDescription["stringFormat"];
+}
+/**
+ * Значение {@link StructuredDataContext} — всё, что нужно представлению (`ElementTable`)
+ * для рендера и правки. Сортировка сюда не входит: она чисто вид и живёт в представлении.
+ */
+export interface StructuredDataContextValue {
+    schema: StructuredDataAttribute[];
+    /** Видимые строки в исходном порядке — тот же порядок уходит в фильтр. */
+    rows: DraftRow[];
+    loading: boolean;
+    /**
+     * Правка разрешена конфигом (`options.editMode`). Без неё представление показывает значения
+     * только на чтение: редакторов в ячейках нет, как и удаления строк.
+     */
+    canEdit: boolean;
+    /** Строки можно удалять: правка разрешена И источник поддерживает запись (либо его нет вовсе). */
+    canDeleteRows: boolean;
+    onCellChange: (key: string, attributeName: string, value: FeatureAttributeValue) => void;
+    onRowDelete: (key: string) => void;
+}

package/dist/components/Dashboard/containers/StructuredDataContainer/useStructuredData.d.ts

@@ -0,0 +1,28 @@
+import { StructuredDataContainerConfig, WidgetType } from '../../types';
+import { StructuredDataContextValue } from './types';
+/**
+ * Оркестратор контейнера: собирает схему, черновик и запись в одно состояние экрана.
+ *
+ * Правку открывает `options.editMode`: не задан или `false` — таблица целиком на чтение, без
+ * редакторов ячеек, добавления, удаления и кнопок сохранения.
+ *
+ * Источник без `layerName` (EQL, python-скрипт, внешний url) записи не поддерживает — контейнер
+ * деградирует в «ручную структуру поверх данных источника»: строки правятся и уезжают в фильтр,
+ * но добавление и удаление строк недоступны.
+ */
+export declare const useStructuredData: (type: WidgetType, elementConfig?: StructuredDataContainerConfig) => {
+    contextValue: StructuredDataContextValue;
+    dirty: boolean;
+    saving: boolean;
+    loading: boolean;
+    hasError: boolean;
+    canEdit: boolean;
+    canAddRows: boolean;
+    isDeleteConfirmOpen: boolean;
+    isDeletingSourceRow: boolean;
+    onAddRow: () => void;
+    onCancel: () => void;
+    onSave: () => Promise<void>;
+    onDeleteConfirm: () => void;
+    onDeleteCancel: () => void;
+};

package/dist/components/Dashboard/containers/StructuredDataContainer/useStructuredDataDraft.d.ts

@@ -0,0 +1,25 @@
+import { FeatureAttributeValue } from '../../../../types';
+import { SelectedFilter, WidgetDataSource } from '../../types';
+import { DraftRow, StructuredDataAttribute } from './types';
+/**
+ * Черновик строк: правки копятся локально и никого не трогают до «Сохранить».
+ *
+ * База (`baseline`) — последнее сохранённое состояние; «Отменить» возвращает к нему.
+ * Пока черновик грязный, приходящие обновления источника его НЕ затирают — иначе фоновая
+ * перезагрузка данных стирала бы набранное пользователем.
+ */
+export declare const useStructuredDataDraft: ({ schema, dataSource, hasDataSource, filterValue, }: {
+    schema: StructuredDataAttribute[];
+    dataSource?: WidgetDataSource;
+    hasDataSource: boolean;
+    filterValue?: SelectedFilter["value"];
+}) => {
+    rows: DraftRow[];
+    visibleRows: DraftRow[];
+    dirty: boolean;
+    changeCell: (key: string, attributeName: string, value: FeatureAttributeValue) => void;
+    addRow: () => void;
+    deleteRow: (key: string) => void;
+    reset: () => void;
+    commitSaved: (next: DraftRow[]) => void;
+};

package/dist/components/Dashboard/containers/StructuredDataContainer/useStructuredDataSave.d.ts

@@ -0,0 +1,17 @@
+import { WidgetType } from '../../types';
+import { DraftRow, StructuredDataAttribute } from './types';
+/**
+ * Запись черновика: сперва в источник (если он поддерживает запись), затем в фильтр.
+ *
+ * Порядок не случаен: потребители фильтра не должны увидеть данные, которых источник не принял.
+ * При ошибке черновик остаётся нетронутым — пользователь может исправить значения и повторить.
+ */
+export declare const useStructuredDataSave: ({ type, schema, layerName, filterName, }: {
+    type: WidgetType;
+    schema: StructuredDataAttribute[];
+    layerName?: string;
+    filterName?: string;
+}) => {
+    save: (rows: DraftRow[]) => Promise<DraftRow[] | null>;
+    saving: boolean;
+};

package/dist/components/Dashboard/containers/StructuredDataContainer/useStructuredDataSchema.d.ts

@@ -0,0 +1,11 @@
+import { StructuredDataContainerConfig, WidgetType } from '../../types';
+/**
+ * Схема структурированных данных и источник, к которому она привязана.
+ *
+ * Источник резолвится через общий `useRelatedDataSourceAttributes`: он собирает layerInfo
+ * реального слоя, а для EQL/python-источников — синтетический из атрибутов ответа.
+ */
+export declare const useStructuredDataSchema: (type: WidgetType, elementConfig?: StructuredDataContainerConfig) => {
+    schema: import('./types').StructuredDataAttribute[];
+    dataSource: import('../../types').WidgetDataSource;
+};

package/dist/components/Dashboard/containers/StructuredDataContainer/utils/buildSchema.d.ts

@@ -0,0 +1,14 @@
+import { AttributesConfigurationDc } from '@evergis/api';
+import { ConfigAttributeDescription } from '../../../types';
+import { StructuredDataAttribute } from '../types';
+/**
+ * Схема структурированных данных.
+ *
+ * С источником `attributesDescription` — переопределение его схемы: задаёт состав, порядок,
+ * `alias`, `stringFormat` и `isEditable`, тогда как типы приходят от источника. Без описания
+ * берутся все атрибуты источника. Без источника описание — единственная схема, и оно обязательно.
+ */
+export declare const buildStructuredDataSchema: ({ attributesDescription, attributesConfiguration, }: {
+    attributesDescription?: ConfigAttributeDescription[];
+    attributesConfiguration?: AttributesConfigurationDc;
+}) => StructuredDataAttribute[];

package/dist/components/Dashboard/containers/StructuredDataContainer/utils/draftRows.d.ts

@@ -0,0 +1,23 @@
+import { FeatureDc } from '@evergis/api';
+import { FeatureAttributeValue } from '../../../../../types';
+import { DraftRow, StructuredDataAttribute } from '../types';
+/**
+ * Оставляет от произвольного набора свойств только атрибуты схемы. Отсутствующие добавляет
+ * как `null`: строка всегда имеет одинаковый набор ключей, иначе представление и
+ * FeatureCollection получали бы «рваные» строки.
+ */
+export declare const pickSchemaProperties: (properties: Record<string, FeatureAttributeValue>, schema: StructuredDataAttribute[]) => Record<string, FeatureAttributeValue>;
+/** Объекты источника → строки черновика. `featureId` нужен для последующих update/delete. */
+export declare const featuresToDraftRows: (features: FeatureDc[], schema: StructuredDataAttribute[]) => DraftRow[];
+/** Пустая строка: все атрибуты схемы объявлены, значения — `null`. */
+export declare const createEmptyRow: (schema: StructuredDataAttribute[]) => DraftRow;
+/**
+ * Черновик после успешной записи: удалённые строки уходят, созданные получают id из ответа
+ * источника, все остальные становятся базой для следующего «Отменить».
+ */
+export declare const toSavedRows: (rows: DraftRow[], createdIds: Record<string, string>) => DraftRow[];
+/**
+ * Свойства строки для features-API — только редактируемые атрибуты. Нередактируемые не
+ * передаются вовсе: их значение принадлежит источнику, а у новой строки его попросту нет.
+ */
+export declare const getEditableProperties: (row: DraftRow, schema: StructuredDataAttribute[]) => Record<string, FeatureAttributeValue>;

package/dist/components/Dashboard/containers/StructuredDataContainer/utils/filterValue.d.ts

@@ -0,0 +1,14 @@
+import { FeaturesFilterValue } from '../../../types';
+import { DraftRow, StructuredDataAttribute } from '../types';
+/**
+ * Строки черновика → значение фильтра `valueType: "features"`.
+ *
+ * В `properties` попадают ВСЕ атрибуты схемы, а не только показанные колонками: схема и вид
+ * разделены, и вид не должен резать данные. Геометрия не поддерживается — `geometry: null`.
+ */
+export declare const toFeaturesFilterValue: (rows: DraftRow[], schema: StructuredDataAttribute[]) => FeaturesFilterValue;
+/**
+ * Значение фильтра → строки черновика. Нужно режиму без источника: вернувшись на страницу,
+ * пользователь видит набранную ранее структуру, а не пустую таблицу.
+ */
+export declare const fromFeaturesFilterValue: (value: FeaturesFilterValue, schema: StructuredDataAttribute[]) => DraftRow[];

package/dist/components/Dashboard/containers/StructuredDataContainer/utils/saveToSource.d.ts

@@ -0,0 +1,18 @@
+import { Api } from '@evergis/api';
+import { DraftRow, StructuredDataAttribute } from '../types';
+/**
+ * Применяет черновик к слою источника: удаление → обновление → создание.
+ *
+ * Порядок важен: удаление первым освобождает уникальные значения, которые могут быть заняты
+ * создаваемыми строками. В features-API уходят только редактируемые атрибуты — значение
+ * нередактируемого принадлежит источнику, а у новой строки его попросту нет.
+ *
+ * Возвращает соответствие «ключ строки → id созданного объекта»: без него повторное сохранение
+ * создало бы дубли вместо обновления только что добавленных строк.
+ */
+export declare const saveToSource: ({ api, layerName, rows, schema, }: {
+    api: Api;
+    layerName: string;
+    rows: DraftRow[];
+    schema: StructuredDataAttribute[];
+}) => Promise<Record<string, string>>;

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

@@ -18,6 +18,7 @@ export * from './PagesContainer';
 export * from './ProgressContainer';
 export * from './RoundedBackgroundContainer';
 export * from './SlideshowContainer';
+export * from './StructuredDataContainer';
 export * from './TabsContainer';
 export * from './TitleContainer';
 export * from './TwoColumnContainer';

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

@@ -59,5 +59,6 @@ export declare const getContainerComponents: () => {
     readonly EditGroup: FC<import('../componentTypes').EditGroupContainerProps>;
     readonly ContainersGroup: FC<import('../componentTypes').ContainersGroupContainerProps>;
     readonly GridRow: FC<import('../componentTypes').GridRowContainerProps>;
+    readonly StructuredData: FC<import('../componentTypes').StructuredDataContainerProps>;
     readonly default: FC<import('../componentTypes').ContainersGroupContainerProps>;
 };

package/dist/components/Dashboard/elements/ElementTable/components/TableCell.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { TableCellProps } from '../types';
+/**
+ * Ячейка таблицы.
+ *
+ * Вне фокуса значение всегда показано через `stringFormat` — редактор подставляется по клику.
+ * Иначе форматирование (округление, разряды, единицы) пришлось бы дублировать внутри инпута,
+ * а вводить в отформатированное поле нельзя.
+ */
+export declare const TableCell: FC<TableCellProps>;

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

@@ -0,0 +1,13 @@
+/**
+ * Признак времени в шаблоне `stringFormat.format`.
+ *
+ * Варианты времени в конфигурации атрибута — `hh:mm`, `hh:mm tt`, `hh:mm:ss`, `hh:mm:ss tt`
+ * (см. `timeOptions` в `utils/format`), поэтому достаточно найти часы с минутами.
+ */
+export declare const TIME_FORMAT: RegExp;
+/**
+ * Контейнер порталов `@evergis/uilib-gl` — в него попадают выпадающие слои контролов,
+ * в том числе календарь `DatePicker`. Клик по ним DOM-деревом лежит вне ячейки, поэтому
+ * закрытие редактора по клику снаружи обязано этот контейнер пропускать.
+ */
+export declare const PORTAL_ROOT_SELECTOR = "#portal-root";

package/dist/components/Dashboard/elements/ElementTable/index.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { ElementTableProps } from '../../types';
+/**
+ * Представление структурированных данных в виде таблицы.
+ *
+ * Данные, схему и колбэки правки берёт из `StructuredDataContext` родительского
+ * `StructuredDataContainer` — вне контейнера показывать нечего.
+ */
+export declare const ElementTable: FC<ElementTableProps>;

package/dist/components/Dashboard/elements/ElementTable/styled.d.ts

@@ -0,0 +1,28 @@
+export declare const TableWrapper: import('styled-components').StyledComponent<"table", any, {}, never>;
+/** Шапка липнет к верху области прокрутки — при длинной таблице заголовки остаются видны. */
+export declare const TableHead: import('styled-components').StyledComponent<"thead", any, {}, never>;
+export declare const TableHeadCell: import('styled-components').StyledComponent<"th", any, {
+    $sortable?: boolean;
+}, never>;
+export declare const TableHeadContent: import('styled-components').StyledComponent<"span", any, {}, never>;
+export declare const TableRow: import('styled-components').StyledComponent<"tr", any, {}, never>;
+export declare const TableCellWrapper: import('styled-components').StyledComponent<"td", any, {}, never>;
+/** Колонка действий: узкая, не растягивается содержимым. */
+export declare const TableActionsCell: import('styled-components').StyledComponent<"td", any, {}, never>;
+export declare const CellText: import('styled-components').StyledComponent<"div", any, {}, never>;
+/**
+ * Редактируемая ячейка вне фокуса. Показывает значение по `stringFormat`, а редактор
+ * подставляется по клику — иначе форматирование пришлось бы дублировать внутри инпута.
+ */
+export declare const CellButton: import('styled-components').StyledComponent<"button", any, {}, never>;
+export declare const CellPlaceholder: import('styled-components').StyledComponent<"span", any, {}, never>;
+/**
+ * Ячейка в режиме правки: редактор лежит поверх невидимой копии значения.
+ *
+ * Копия остаётся в потоке и держит ширину колонки ровно такой, какой она была до клика, —
+ * иначе таблица дёргалась бы на каждый вход в правку и выход из неё.
+ */
+export declare const CellEditor: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const CellGhost: import('styled-components').StyledComponent<"span", any, {}, never>;
+export declare const CellField: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const TableEmpty: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -0,0 +1,15 @@
+import { FeatureAttributeValue } from '../../../../types';
+import { DraftRow, StructuredDataAttribute } from '../../containers/StructuredDataContainer/types';
+export type SortDirection = "asc" | "desc";
+/** Сортировка представления: одна колонка за раз, `null` — исходный порядок строк. */
+export interface TableSort {
+    attributeName: string;
+    direction: SortDirection;
+}
+export interface TableCellProps {
+    attribute: StructuredDataAttribute;
+    row: DraftRow;
+    /** Правка разрешена контейнером (`options.editMode`). Иначе ячейка — только текст. */
+    canEdit: boolean;
+    onChange: (key: string, attributeName: string, value: FeatureAttributeValue) => void;
+}

package/dist/components/Dashboard/elements/ElementTable/useCellEditing.d.ts

@@ -0,0 +1,15 @@
+import { KeyboardEvent } from 'react';
+/**
+ * Режим правки одной ячейки: открывается кликом по значению, закрывается кликом снаружи.
+ *
+ * Закрывать по `blur` нельзя: `DatePicker` уводит фокус из поля уже на клике по иконке
+ * календаря — редактор исчезал бы раньше, чем календарь успевал открыться. Поэтому слушаем
+ * `mousedown` на документе, а клики внутри портала (`#portal-root`) считаем «своими»:
+ * выпадающие слои контролов uilib живут именно там, вне DOM-поддерева ячейки.
+ */
+export declare const useCellEditing: () => {
+    editing: boolean;
+    editorRef: import('react').MutableRefObject<HTMLDivElement>;
+    startEditing: () => void;
+    onKeyDown: ({ key }: KeyboardEvent<HTMLDivElement>) => void;
+};

package/dist/components/Dashboard/elements/ElementTable/useTableView.d.ts

@@ -0,0 +1,16 @@
+import { ElementTableConfig } from '../../types';
+import { TableSort } from './types';
+/**
+ * Вид таблицы: набор и порядок колонок из `columnNames` плюс локальная сортировка.
+ *
+ * Сортировка живёт здесь, а не в контейнере: она ничего не меняет в данных и не должна
+ * влиять на порядок строк, уходящих в фильтр.
+ */
+export declare const useTableView: (elementConfig?: ElementTableConfig) => {
+    context: import('../../containers/StructuredDataContainer/types').StructuredDataContextValue;
+    columns: import('../../containers/StructuredDataContainer/types').StructuredDataAttribute[];
+    rows: import('../../containers/StructuredDataContainer/types').DraftRow[];
+    sort: TableSort;
+    sortEnabled: boolean;
+    onSortToggle: (attributeName: string) => void;
+};