@evergis/react 4.0.142 → 4.0.144

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

@@ -1,4 +1,5 @@
-import { AttributeType } from '@evergis/api';
+import { CSSProperties } from 'react';
+import { AttributeType, StringSubType } from '@evergis/api';
 import { FeatureAttributeValue } from '../../../../types';
 import { ConfigAttributeDescription } from '../../types';
 /** Состояние строки черновика относительно последнего сохранения. */
@@ -22,10 +23,20 @@ export interface DraftRow {
 export interface StructuredDataAttribute {
     attributeName: string;
     type: AttributeType;
+    /** Уточнение строкового типа из конфига: у источника такого поля нет. */
+    subType?: StringSubType;
     alias: string;
     description?: string;
     isEditable: boolean;
     stringFormat?: ConfigAttributeDescription["stringFormat"];
+    /** Ширина колонки в пикселах из конфига. Ниже её колонку не ужимает и раскладка таблицы. */
+    width?: number;
+    /** Ширину колонки разрешено тянуть мышью. */
+    resizable?: boolean;
+    /** Значение переносится по словам, а не режется многоточием. */
+    multiline?: boolean;
+    /** Стиль значений колонки из конфига. */
+    style?: CSSProperties;
 }
 /**
  * Значение {@link StructuredDataContext} — всё, что нужно представлению (`ElementTable`)

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

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { TableCellProps } from '../types';
+/**
+ * Колонка со вложениями: список файлов прямо в ячейке.
+ *
+ * Тип у атрибута строковый, вложениями его делает `subType: "Attachments"` в схеме контейнера —
+ * поэтому ветка стоит раньше разбора типа и обычных редакторов ячейки.
+ */
+export declare const AttachmentsCell: FC<TableCellProps>;

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

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { TableHeadRowProps } from '../types';
+/**
+ * Шапка таблицы: заголовки колонок, сортировка кликом и захват границы для ручной ширины.
+ *
+ * Захват рисуется по разрешению атрибута (`resizable`) и не смотрит на режим правки контейнера:
+ * ширина колонки — это вид, а не данные.
+ */
+export declare const TableHeadRow: FC<TableHeadRowProps>;

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

@@ -16,3 +16,5 @@ export declare const TIME_FORMAT: RegExp;
  * закрытие редактора по клику снаружи обязано этот контейнер пропускать.
  */
 export declare const PORTAL_ROOT_SELECTOR = "#portal-root";
+/** Ниже этой ширины колонку не ужать мышью: уже неё в ячейке не остаётся места под значение. */
+export declare const MIN_COLUMN_WIDTH = 48;

package/dist/components/Dashboard/elements/ElementTable/hooks/useAttachmentsCell.d.ts

@@ -0,0 +1,26 @@
+import { IPreviewImage } from '@evergis/uilib-gl';
+import { Attachment } from '../../../containers/AttachmentContainer/types';
+import { TableCellProps } from '../types';
+/**
+ * Ячейка с вложениями: разбор значения, просмотр, скачивание и правка списка.
+ *
+ * Значение атрибута — строка: файлы приезжают в ней списком JSON, поэтому и обратно в черновик
+ * кладём строку, а не массив — иначе тип ячейки менялся бы от самой правки.
+ *
+ * Добавление здесь только по ссылке. Загрузка с диска требует ресурса-родителя и файлового
+ * api контейнера вложений, а у колонки таблицы ни того, ни другого нет.
+ */
+export declare const useAttachmentsCell: ({ attribute, row, canEdit, onChange }: TableCellProps) => {
+    items: Attachment[];
+    editable: boolean;
+    previewIndex: number;
+    previewImages: IPreviewImage[];
+    isLinkDialogOpen: boolean;
+    onPreview: (link: string) => void;
+    onClosePreview: () => void;
+    onDownload: (_image: IPreviewImage, index: number) => void;
+    onDelete: (link: string) => void;
+    onOpenLinkDialog: () => void;
+    onCloseLinkDialog: () => void;
+    onAddByLink: (url: string) => void;
+};

package/dist/components/Dashboard/elements/ElementTable/hooks/useColumnResize.d.ts

@@ -0,0 +1,20 @@
+import { PointerEvent } from 'react';
+import { StructuredDataAttribute } from '../../../containers/StructuredDataContainer/types';
+/**
+ * Ручное изменение ширины колонок.
+ *
+ * Растянутые ширины живут только здесь: тянут их в рантайме, а `width` атрибута в конфиге задаёт
+ * лишь стартовое значение — записывать растянутое обратно в конфиг незачем.
+ *
+ * Разрешение (`resizable`) от `options.editMode` не зависит: ширина колонки — это вид таблицы,
+ * а не правка данных, и тянуть её должно быть можно и на таблице только для чтения.
+ *
+ * Стартовую ширину берём с самой ячейки, а не из конфига: у колонки без `width` её выбрала
+ * раскладка таблицы, и тянуть надо ровно от того, что видно.
+ */
+export declare const useColumnResize: (columns: StructuredDataAttribute[]) => {
+    columnWidths: Record<string, number>;
+    onResizeStart: (attributeName: string, event: PointerEvent<HTMLElement>) => void;
+    onResizeMove: (event: PointerEvent<HTMLElement>) => void;
+    onResizeEnd: (event: PointerEvent<HTMLElement>) => void;
+};

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

@@ -12,6 +12,9 @@ import { TableSort } from '../types';
  *
  * `width`/`height` — размер собственного бокса таблицы: он ограничивает её саму и прокручивает
  * то, что не влезло. Место, отведённое контейнеру, задаётся его же опциями и живёт отдельно.
+ *
+ * Ширины колонок — тоже вид: конфиг задаёт стартовую, растянутая мышью живёт в
+ * {@link useColumnResize} и в конфиг не возвращается.
  */
 export declare const useTableView: (elementConfig?: ElementTableConfig) => {
     context: import('../../../containers/StructuredDataContainer/types').StructuredDataContextValue;
@@ -21,5 +24,9 @@ export declare const useTableView: (elementConfig?: ElementTableConfig) => {
     sortEnabled: boolean;
     sizeCss: import('styled-components').CSSObject;
     contentWidth: boolean;
+    columnWidths: Record<string, number>;
     onSortToggle: (attributeName: string) => void;
+    onResizeStart: (attributeName: string, event: import('react').PointerEvent<HTMLElement>) => void;
+    onResizeMove: (event: import('react').PointerEvent<HTMLElement>) => void;
+    onResizeEnd: (event: import('react').PointerEvent<HTMLElement>) => void;
 };

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

@@ -34,7 +34,18 @@ export declare const TableHead: import('styled-components').StyledComponent<"the
 export declare const TableHeadCell: import('styled-components').StyledComponent<"th", any, {
     $sortable?: boolean;
 }, never>;
+/**
+ * Содержимое заголовка. Псевдоним обрезается многоточием, значок сортировки не сжимается:
+ * у колонки с заданной шириной длинный псевдоним иначе выдавил бы значок за край ячейки.
+ */
 export declare const TableHeadContent: import('styled-components').StyledComponent<"span", any, {}, never>;
+/**
+ * Захват правой границы колонки. Лежит поверх края ячейки и ловит указатель сам, поэтому
+ * перетаскивание не доходит до заголовка и не переключает сортировку.
+ *
+ * Ширина в пикселах, а не в rem: это зона попадания курсора, и от размера шрифта она не зависит.
+ */
+export declare const TableResizeHandle: import('styled-components').StyledComponent<"span", any, {}, never>;
 /**
  * Место под значок сортировки. Занято всегда, пока сортировка включена, а сам значок только
  * прячется: появляясь и исчезая, он менял бы ширину колонки — и таблицу дёргало бы на каждый
@@ -58,7 +69,19 @@ export declare const TableRow: import('styled-components').StyledComponent<"tr",
 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>;
+/**
+ * Как значение ведёт себя, когда не помещается в колонку: режется многоточием в одну строку
+ * или переносится по словам, растягивая строку таблицы вниз (`multiline` атрибута).
+ *
+ * Перенос разрешаем и посреди слова: колонка бывает уже одного длинного слова (ссылка, артикул),
+ * и без этого оно вылезло бы за заданную ширину, сделав её бессмысленной.
+ */
+export declare const cellWrapMixin: import('styled-components').FlattenInterpolation<import('styled-components').ThemedStyledProps<{
+    $multiline?: boolean;
+}, any>>;
+export declare const CellText: import('styled-components').StyledComponent<"div", any, {
+    $multiline?: boolean;
+}, never>;
 /**
  * Редактируемая ячейка вне фокуса. Показывает значение по `stringFormat`, а редактор
  * подставляется на фокус — иначе форматирование пришлось бы дублировать внутри инпута.
@@ -66,7 +89,9 @@ export declare const CellText: import('styled-components').StyledComponent<"div"
  * Кнопка, а не просто текст, именно ради фокуса: она — таб-стоп ячейки, и Tab по таблице
  * открывает редактор с курсором внутри.
  */
-export declare const CellButton: import('styled-components').StyledComponent<"button", any, {}, never>;
+export declare const CellButton: import('styled-components').StyledComponent<"button", any, {
+    $multiline?: boolean;
+}, never>;
 export declare const CellPlaceholder: import('styled-components').StyledComponent<"span", any, {}, never>;
 /**
  * Ячейка в режиме правки: редактор лежит поверх невидимой копии значения.
@@ -75,6 +100,16 @@ export declare const CellPlaceholder: import('styled-components').StyledComponen
  * иначе таблица дёргалась бы на каждый вход в правку и выход из неё.
  */
 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 CellGhost: import('styled-components').StyledComponent<"span", any, {
+    $multiline?: boolean;
+}, never>;
 export declare const CellField: import('styled-components').StyledComponent<"div", any, {}, never>;
+/**
+ * Ячейка со вложениями. Список идёт колонкой, кнопка добавления — под ним, поэтому строка растёт
+ * ровно на столько, сколько файлов в ней лежит.
+ *
+ * Отступы те же, что у текстовой ячейки (`CellText`): в одном ряду с обычными колонками значения
+ * обязаны стоять на одной линии.
+ */
+export declare const AttachmentsCellBox: 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

@@ -1,3 +1,4 @@
+import { PointerEvent } from 'react';
 import { FeatureAttributeValue } from '../../../../types';
 import { DraftRow, StructuredDataAttribute } from '../../containers/StructuredDataContainer/types';
 export type SortDirection = "asc" | "desc";
@@ -18,3 +19,16 @@ export interface TableCellProps {
     canEdit: boolean;
     onChange: (key: string, attributeName: string, value: FeatureAttributeValue) => void;
 }
+export interface TableHeadRowProps {
+    columns: StructuredDataAttribute[];
+    sort: TableSort | null;
+    sortEnabled: boolean;
+    /** Ширина каждой колонки: растянутая мышью, иначе из конфига. `undefined` — на усмотрение раскладки. */
+    columnWidths: Record<string, number | undefined>;
+    /** У таблицы есть колонка действий — шапке нужна пустая ячейка над ней. */
+    withActionsColumn: boolean;
+    onSortToggle: (attributeName: string) => void;
+    onResizeStart: (attributeName: string, event: PointerEvent<HTMLElement>) => void;
+    onResizeMove: (event: PointerEvent<HTMLElement>) => void;
+    onResizeEnd: (event: PointerEvent<HTMLElement>) => void;
+}

package/dist/components/Dashboard/elements/ElementTable/utils/columnStyle.d.ts

@@ -0,0 +1,11 @@
+import { CSSProperties } from 'react';
+/**
+ * Инлайн-размер ячейки колонки с заданной шириной.
+ *
+ * Раскладка таблицы автоматическая (ширину колонок выбирает содержимое), и одной `width` ей мало —
+ * она для неё лишь пожелание. Жёстко колонку держат все три предела сразу, поэтому и ставим их
+ * втроём, на каждую ячейку колонки.
+ *
+ * Ширины нет — стиля нет: колонка остаётся на попечении раскладки, как и была.
+ */
+export declare const getColumnStyle: (width?: number) => CSSProperties | undefined;

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

@@ -11,9 +11,4 @@ export declare const useDataSources: ({ type: widgetType, config, attributes, fi
     getDataSourcePromises: ({ ds, query, parameters, layerName, limit, condition, url, resourceId, fileName, methodName, }: ConfigDataSource, newFilters?: SelectedFilters, offset?: number) => Promise<EqlDataSource | PagedFeaturesListDc>;
     getUpdatingDataSources: () => ConfigDataSource[];
     getUpdatedDataSources: (responses: DataSourcePromise[], currentDataSources: ConfigDataSource[], otherDataSources: FetchedDataSource[]) => any;
-    zoomToLayersExtent: (layers: Array<{
-        layerName: string;
-        conditions: string[];
-        parameters?: Record<string, any>;
-    }>) => Promise<void>;
 };

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

@@ -499,11 +499,30 @@ export interface ConfigDataSourceAttribute {
 export interface ConfigAttributeDescription {
     attributeName: string;
     type?: AttributeType;
+    /**
+     * Уточнение строкового типа. Отдельного `AttributeType` под вложения нет: файлы приходят
+     * строкой, и разбирать её как список вложений велит именно `subType: "Attachments"`.
+     */
+    subType?: StringSubType;
     alias?: string;
     description?: string;
     /** Значение атрибута правится в ячейке. `false` — только чтение, в features-API не передаётся. */
     isEditable?: boolean;
     stringFormat?: AttributeFormatConfiguration;
+    /**
+     * Ширина колонки в пикселах. Задана — колонка её и занимает; не задана — ширину выбирает
+     * раскладка таблицы по содержимому.
+     */
+    width?: number;
+    /** Ширину колонки можно тянуть мышью. Не зависит от `options.editMode` контейнера. */
+    resizable?: boolean;
+    /** Значение переносится на следующую строку вместо обрезки многоточием, высота строки растёт. */
+    multiline?: boolean;
+    /**
+     * Стиль значений колонки: семейство, размер, цвет и начертание шрифта. Своего узла-элемента
+     * у колонки нет, поэтому стиль живёт прямо у описания атрибута.
+     */
+    style?: CSSProperties;
 }
 export interface ConfigDataSource {
     name: string;
@@ -522,7 +541,22 @@ export interface ConfigDataSource {
     methodName?: string;
     url?: string;
     type?: string;
+    /**
+     * Перезапрашивать источник, когда сервер сообщает об изменении объектов ЕГО слоя
+     * ({@link ConfigDataSource.layerName}). Только для источников со слоем; источникам
+     * query / python слушать нечего — им нужен {@link ConfigDataSource.autoSyncLayers}.
+     */
     autoSyncLayer?: boolean;
+    /**
+     * Имена слоёв, за изменением объектов которых следит источник: пришло серверное
+     * уведомление по любому из них — источник перезапрашивается.
+     *
+     * Только для источников БЕЗ {@link ConfigDataSource.layerName} — query (`ds` + `query`),
+     * внешних (`url`) и python (`resourceId`). У них нет собственного слоя, а данные они
+     * считают по чужим, поэтому связь задаётся явно. Если `layerName` задан, поле
+     * игнорируется и работает {@link ConfigDataSource.autoSyncLayer}.
+     */
+    autoSyncLayers?: string[];
     /**
      * Задержка перед запросом источника, мс. `0` или отсутствие поля — запрос сразу.
      *