@evergis/react 4.0.129 → 4.0.130

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

@@ -109,7 +109,7 @@ export interface ElementSvgProps extends Omit<ContainerProps, "elementConfig"> {
     layerInfo?: QueryLayerServiceInfoDc;
     attributes?: ClientFeatureAttribute[];
 }
-export type ElementTableOptions = Pick<ConfigOptions, "columnNames" | "sort">;
+export type ElementTableOptions = Pick<ConfigOptions, "sort" | "width" | "height">;
 export interface ElementTableConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "table";
     options?: ElementTableOptions;

package/dist/components/Dashboard/components/AddButton/styled.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Кнопка «добавить»: серая скруглённая, со значком и подписью. Общая на весь дашборд — вложения
+ * и таблица структурированных данных добавляют одинаковой кнопкой, разница только в значке.
+ *
+ * Размеры сняты с макета (все — в половину его пикселей, макет снят на удвоенной плотности):
+ * высота 24, поля 10, просвет между значком и подписью 6, значок 14, подпись 14.
+ *
+ * Скругление и ширина по содержимому — от самого `IconButton`: он скруглён по умолчанию, а с
+ * подписью в детях перестаёт держать фиксированную ширину. Значок ужат до 0.875rem: свой 1rem
+ * он заполняет краями, и на макете кружок мельче подписи, а не вровень с ней.
+ *
+ * Подпись темнее значка: `IconButton` красит и то и другое цветом иконки, но в макете подпись —
+ * обычный текст (`textPrimary`), а приглушён только значок.
+ */
+export declare const AddButtonRow: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;

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

@@ -1,3 +1,4 @@
+export * from './AddButton/styled';
 export * from './AddFeatureButton';
 export * from './Chart';
 export * from './ChartLegend';

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

@@ -34,6 +34,5 @@ export declare const ListActions: import('styled-components').StyledComponent<"d
 export declare const ListItemContainer: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ShowMoreButton: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const AddButtonContainer: import('styled-components').StyledComponent<"div", any, {}, never>;
-export declare const AddButtonRow: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;
 export declare const HiddenFileInput: import('styled-components').StyledComponent<"input", any, {}, never>;
 export declare const LinkDialogContent: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -1,4 +1,6 @@
 import { AttributeType } from '@evergis/api';
+/** Слот представления: единственный ребёнок контейнера, рисующий данные (элемент `table`). */
+export declare const STRUCTURED_DATA_VIEW_SLOT = "data";
 /**
  * Типы атрибутов с редактором ячейки. Атрибут любого другого типа показывается только на чтение,
  * даже если помечен `isEditable: true` — редактора для него нет.

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

@@ -9,6 +9,10 @@ import { StructuredDataContextValue } from '../types';
  * Вид источника на права правки не влияет — от него зависит только адресат «Сохранить». Слой
  * принимает запись через features-API, источник без `layerName` (EQL, python-скрипт, внешний
  * url) не принимает ничего, и правка такой таблицы уходит только в фильтр.
+ *
+ * Значение фильтра читается так же, как его читают остальные потребители дашборда: выбор
+ * пользователя, а пока его нет — `defaultValue` из конфига фильтра. Общего стейта, залитого
+ * дефолтами, в дашборде нет, поэтому фолбэк делает каждый потребитель сам.
  */
 export declare const useStructuredData: (type: WidgetType, elementConfig?: StructuredDataContainerConfig) => {
     contextValue: StructuredDataContextValue;

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

@@ -14,5 +14,8 @@ export declare const StructuredDataActions: import('styled-components').StyledCo
 /**
  * Область представления. Прокручивается внутри себя, чтобы длинная таблица не растягивала
  * контейнер за пределы отведённой ему ячейки; `min-height: 0` разрешает flex-ребёнку сжиматься.
+ *
+ * Собственный бокс таблицы (`options.width`/`height` представления) живёт внутри и на эту
+ * прокрутку не влияет: он ограничивает саму таблицу, а не отведённое контейнером место.
  */
 export declare const StructuredDataView: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;

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

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

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

@@ -0,0 +1,17 @@
+import { StructuredDataContainerConfig } from '../../../types';
+/** Режимы прокрутки представления таблицы. */
+export interface ViewScroll {
+    /** Горизонтальная: колонки по содержимому, лишнее — в прокрутку, обёртка не растягивается. */
+    scrollH: boolean;
+    /** Вертикальная: таблица заперта в отведённую высоту и прокручивается внутри себя. */
+    scrollV: boolean;
+}
+/**
+ * Режимы прокрутки, объявленные у ребёнка-представления (`data`).
+ *
+ * Опции принадлежат виду и лежат там же, где `columnNames` и `sort`, но применяет их контейнер:
+ * бокс прокрутки — его узел, единственный в этой цепочке, который умеет быть меньше своего
+ * содержимого. Сама таблица ниже своих ширины и высоты не сжимается, а обёртка элемента между
+ * ними контейнеру не принадлежит — задать ей размер изнутри элемента нечем.
+ */
+export declare const getViewScroll: (elementConfig?: StructuredDataContainerConfig) => ViewScroll;

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

@@ -3,7 +3,7 @@ import { TableCellProps } from '../types';
 /**
  * Ячейка таблицы.
  *
- * Вне фокуса значение всегда показано через `stringFormat` — редактор подставляется по клику.
+ * Вне фокуса значение всегда показано через `stringFormat`, редактор подставляется на фокус.
  * Иначе форматирование (округление, разряды, единицы) пришлось бы дублировать внутри инпута,
  * а вводить в отформатированное поле нельзя.
  */

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

@@ -1,3 +1,8 @@
+/**
+ * Насколько тело таблицы заехало под липкую шапку. Пишется на таблицу при прокрутке, читается
+ * стилем тела: ровно на эту величину тело и отсекается.
+ */
+export declare const HEAD_OVERLAP_VARIABLE = "--table-head-overlap";
 /**
  * Признак времени в шаблоне `stringFormat.format`.
  *

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

@@ -1,15 +1,31 @@
-import { KeyboardEvent } from 'react';
+import { FocusEvent, KeyboardEvent } from 'react';
 /**
- * Режим правки одной ячейки: открывается кликом по значению, закрывается кликом снаружи.
+ * Правка одной ячейки.
  *
- * Закрывать по `blur` нельзя: `DatePicker` уводит фокус из поля уже на клике по иконке
- * календаря — редактор исчезал бы раньше, чем календарь успевал открыться. Поэтому слушаем
- * `mousedown` на документе, а клики внутри портала (`#portal-root`) считаем «своими»:
- * выпадающие слои контролов uilib живут именно там, вне DOM-поддерева ячейки.
+ * Открывает её фокус, а не клик: по таблице ходят Tab-ом, и на каждой ячейке сразу нужно поле
+ * с курсором — кнопка, требующая ещё и Enter, ломала бы весь проход.
+ *
+ * Поэтому состояний три. `focused` — ячейка под фокусом с закрытым редактором, состояние после
+ * Enter/Escape: фокус возвращается на кнопку, но правку заново не открывает (иначе выйти из неё
+ * было бы нечем), а Tab с неё идёт дальше по таблице.
+ *
+ * Закрывать правку по любому уходу фокуса нельзя: DatePicker уводит его из поля уже на клике по
+ * иконке календаря — редактор исчезал бы раньше, чем календарь успевал открыться. Клавиатурный
+ * уход видно по `relatedTarget` (фокус ушёл на соседнюю ячейку), мышиный ловит `mousedown`
+ * снаружи. Клики внутри портала (`#portal-root`) считаем «своими»: выпадающие слои контролов
+ * uilib живут именно там, вне DOM-поддерева ячейки.
  */
 export declare const useCellEditing: () => {
     editing: boolean;
-    editorRef: import('react').MutableRefObject<HTMLDivElement>;
-    startEditing: () => void;
-    onKeyDown: ({ key }: KeyboardEvent<HTMLDivElement>) => void;
+    buttonProps: {
+        ref: import('react').MutableRefObject<HTMLButtonElement>;
+        onFocus: () => void;
+        onBlur: () => void;
+        onClick: () => void;
+    };
+    editorProps: {
+        ref: import('react').MutableRefObject<HTMLDivElement>;
+        onBlur: ({ relatedTarget }: FocusEvent<HTMLDivElement>) => void;
+        onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
+    };
 };

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

@@ -0,0 +1,15 @@
+/**
+ * Отсечка тела таблицы по нижней кромке липкой шапки.
+ *
+ * Шапка прозрачная — фон контейнера виден сквозь неё, и красить её нечем: цвет контейнера задаётся
+ * конфигом и меняется. Значит, строки не должны под неё заезжать в принципе. Тело для этого
+ * отсекается (`clip-path`) ровно на то, на сколько шапка его накрыла: низ шапки минус верх тела.
+ *
+ * Разница считается по факту, а не по величине прокрутки: она одинаково верна и когда прокручивает
+ * собственный бокс таблицы, и когда её прокручивает область представления контейнера. Пока
+ * не прокручено, низ шапки совпадает с верхом тела — отсекать нечего.
+ *
+ * Прокрутка не всплывает, но проходит фазу перехвата, поэтому слушаем документ: какой именно
+ * предок прокручивается, знать не нужно.
+ */
+export declare const useHeadOverlap: (table: HTMLTableElement | null) => void;

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

@@ -0,0 +1,16 @@
+/**
+ * Цвет подложки под узлом — для липкой шапки таблицы.
+ *
+ * Шапке нужен собственный непрозрачный фон, иначе строки просвечивают сквозь заголовки. Взять его
+ * из палитры нельзя: контейнер дашборда красится цветом из конфига, и фиксированный токен остался
+ * бы прямоугольником чужого цвета, как только фон контейнера поменяли. Поэтому цвет не назначается,
+ * а измеряется — тем же, что видно вокруг таблицы.
+ *
+ * Пересчёт — на смену темы и на правку класса или стиля у любого предка: цвет контейнера меняют
+ * в редакторе, и таблица о таком не узнаёт (своих пропов она не меняет и не перерисовывается).
+ * Поэтому слушаются все предки до корня, а не только те, где нашёлся цвет: подложкой может стать
+ * тот, что был прозрачным.
+ *
+ * Замер до отрисовки (`useLayoutEffect`) — иначе первый кадр шапка рисовалась бы цветом темы.
+ */
+export declare const useSurfaceColor: (node: HTMLElement | null) => string;

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

@@ -1,10 +1,17 @@
 import { ElementTableConfig } from '../../../types';
 import { TableSort } from '../types';
 /**
- * Вид таблицы: набор и порядок колонок из `columnNames` плюс локальная сортировка.
+ * Вид таблицы: колонки плюс локальная сортировка.
+ *
+ * Набор и порядок колонок — это схема контейнера (`attributesDescription`) как есть: показываем
+ * ровно то, что описано, и в том же порядке. Своего отбора у представления нет — иначе описанный
+ * атрибут и видимая колонка расходились бы, а в фильтр всё равно уходят все атрибуты схемы.
  *
  * Сортировка живёт здесь, а не в контейнере: она ничего не меняет в данных и не должна
  * влиять на порядок строк, уходящих в фильтр.
+ *
+ * `width`/`height` — размер собственного бокса таблицы: он ограничивает её саму и прокручивает
+ * то, что не влезло. Место, отведённое контейнеру, задаётся его же опциями и живёт отдельно.
  */
 export declare const useTableView: (elementConfig?: ElementTableConfig) => {
     context: import('../../../containers/StructuredDataContainer/types').StructuredDataContextValue;
@@ -12,5 +19,7 @@ export declare const useTableView: (elementConfig?: ElementTableConfig) => {
     rows: import('../../../containers/StructuredDataContainer/types').DraftRow[];
     sort: TableSort;
     sortEnabled: boolean;
+    sizeCss: import('styled-components').CSSObject;
+    contentWidth: boolean;
     onSortToggle: (attributeName: string) => void;
 };

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

@@ -1,15 +1,59 @@
-export declare const TableWrapper: import('styled-components').StyledComponent<"table", any, {}, never>;
+import { ContainerRootProps } from '../../styled';
+/**
+ * Собственный бокс таблицы. Без размеров в `options` представления узел ничего не меняет:
+ * таблица растёт под содержимое, а прокручивает лишнее область представления контейнера.
+ *
+ * С размерами бокс становится её скролл-контейнером — и липкая шапка липнет уже к нему.
+ */
+export declare const TableBox: import('styled-components').StyledComponent<"div", any, ContainerRootProps, never>;
+/**
+ * Таблица. По умолчанию втискивается в ширину, которую ей дали: колонкам достаётся то, что есть,
+ * а длинные значения режутся многоточием внутри ячейки.
+ *
+ * `$contentWidth` (ширина бокса задана в `options`) переводит её на ширину по содержимому:
+ * колонки встают по своим значениям, предел ячейки снимается, и всё, что не влезло, уходит
+ * в горизонтальную прокрутку бокса. Иначе вышла бы бессмыслица — бокс с прокруткой, а значения
+ * всё равно с многоточием. `min-width` оставляет таблицу растянутой на весь бокс, когда
+ * содержимого на его ширину не набирается.
+ *
+ * Снятый предел ширины ячейки едет вниз css-переменной, а не правилом по `TableCellWrapper`:
+ * ячейка объявлена ниже по файлу, и селектор по ней отсюда попал бы в TDZ.
+ */
+export declare const TableWrapper: import('styled-components').StyledComponent<"table", any, {
+    $contentWidth?: boolean;
+}, never>;
 /**
  * Шапка липнет к верху области прокрутки — при длинной таблице заголовки остаются видны.
  *
- * Собственного фона у шапки нет: цвет из палитры не следовал за подложкой контейнера
- * и выделялся белым прямоугольником на любом фоне, отличном от базового.
+ * Своего фона у неё нет и не должно быть: контейнер дашборда красится цветом из конфига, и любой
+ * назначенный шапке цвет остался бы прямоугольником чужого цвета, как только фон контейнера
+ * поменяли. Под шапкой виден фон контейнера, а строки под неё не заезжают — тело отсечено
+ * (см. TableBody и useHeadOverlap).
  */
 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>;
+/**
+ * Место под значок сортировки. Занято всегда, пока сортировка включена, а сам значок только
+ * прячется: появляясь и исчезая, он менял бы ширину колонки — и таблицу дёргало бы на каждый
+ * клик по заголовку, вместе с телом. Оба направления рисуются значком в 1rem, поэтому
+ * переключение asc/des ширину тоже не трогает.
+ */
+export declare const TableSortSlot: import('styled-components').StyledComponent<"span", any, {
+    $active?: boolean;
+}, never>;
+/**
+ * Тело таблицы. Отсекается ровно на то, на сколько его накрыла липкая шапка: строки уходят под
+ * её нижнюю кромку и сквозь прозрачную шапку не проступают. Величину пишет {@link useHeadOverlap},
+ * без неё отсечка нулевая и разметка не меняется.
+ */
+export declare const TableBody: import('styled-components').StyledComponent<"tbody", any, {}, never>;
+/**
+ * Строка. Разделитель рисуют её ячейки: собственная рамка строки при раздельных рамках не
+ * рисуется вовсе, а при схлопнутых её рисовала бы таблица — и отсечка тела её бы не резала.
+ */
 export declare const TableRow: import('styled-components').StyledComponent<"tr", any, {}, never>;
 export declare const TableCellWrapper: import('styled-components').StyledComponent<"td", any, {}, never>;
 /** Колонка действий: узкая, не растягивается содержимым. */
@@ -17,7 +61,10 @@ export declare const TableActionsCell: import('styled-components').StyledCompone
 export declare const CellText: import('styled-components').StyledComponent<"div", any, {}, never>;
 /**
  * Редактируемая ячейка вне фокуса. Показывает значение по `stringFormat`, а редактор
- * подставляется по клику — иначе форматирование пришлось бы дублировать внутри инпута.
+ * подставляется на фокус — иначе форматирование пришлось бы дублировать внутри инпута.
+ *
+ * Кнопка, а не просто текст, именно ради фокуса: она — таб-стоп ячейки, и Tab по таблице
+ * открывает редактор с курсором внутри.
  */
 export declare const CellButton: import('styled-components').StyledComponent<"button", any, {}, never>;
 export declare const CellPlaceholder: import('styled-components').StyledComponent<"span", any, {}, never>;

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

@@ -1,6 +1,11 @@
 import { FeatureAttributeValue } from '../../../../types';
 import { DraftRow, StructuredDataAttribute } from '../../containers/StructuredDataContainer/types';
 export type SortDirection = "asc" | "desc";
+/**
+ * Состояние правки ячейки: закрыта, закрыта под фокусом (вышли из редактора по Enter/Escape),
+ * открыт редактор.
+ */
+export type CellMode = "idle" | "focused" | "editing";
 /** Сортировка представления: одна колонка за раз, `null` — исходный порядок строк. */
 export interface TableSort {
     attributeName: string;

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

@@ -0,0 +1,13 @@
+/** Предки узла снизу вверх: по ним ищется подложка, за ними же следят на предмет смены цвета. */
+export declare const getAncestors: (node: HTMLElement | null) => HTMLElement[];
+/**
+ * Непрозрачный цвет подложки под узлом — то, что видно вокруг него.
+ *
+ * Фоны предков складываются снизу вверх, пока не наберётся непрозрачность: полупрозрачный тон
+ * (плитка красится белым 6%) сам по себе цвета не даёт, а поверх фона под ним даёт ровно то, что
+ * видит глаз. Дошли до верха, а непрозрачность не набралась — цвета нет, пусть решает тема.
+ *
+ * Считается только `background-color`: картинки и градиенты предков замер не видит и берёт цвет
+ * из-под них. Для дашборда это безопасно — контейнеры красятся цветом из конфига.
+ */
+export declare const getSurfaceColor: (node: HTMLElement | null) => string | undefined;

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

@@ -0,0 +1,20 @@
+import { CSSObject } from 'styled-components';
+import { CssSize } from '../../../types';
+/**
+ * Css собственного бокса таблицы: размер из `options` представления плюс прокрутка того,
+ * что в этот размер не влез.
+ *
+ * Размеров нет — нет и бокса: таблица занимает столько, сколько просит содержимое, а лишнее,
+ * как и раньше, уходит в прокрутку области представления контейнера.
+ *
+ * Проценты работают только по ширине. Между областью представления и таблицей стоит блочная
+ * обёртка элемента (`ElementValueWrapper`) с высотой `auto`, и `height: "100%"` в ней не
+ * разрешается — вертикальный предел задают конкретные единицы (`240`, `"20rem"`, `"50vh"`),
+ * а «занять всю выданную высоту» остаётся за `options.height` контейнера.
+ *
+ * `contain: inline-size` идёт в пару к fill-ширине: сама по себе она предком не ограничена
+ * (процент от раскладки, которая меряет себя содержимым, вырождается в `auto`), и таблица
+ * распирала бы ряд плиток или трек `auto` изнутри. С containment вклад бокса в ширину предка
+ * обнуляется: ширину он берёт снаружи, а внутрь по ней не смотрят.
+ */
+export declare const getTableBoxStyle: (width?: CssSize, height?: CssSize) => CSSObject | undefined;

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

@@ -358,12 +358,6 @@ export interface ConfigCollectionOptions {
     otherItems?: number;
     orderByValue?: boolean;
     orderByTitle?: boolean;
-    /**
-     * Имена атрибутов схемы, показываемые колонками представления `table`. Подмножество
-     * `attributesDescription` родительского контейнера; порядок колонок — порядок этого массива.
-     * Не задано — показываются все атрибуты схемы.
-     */
-    columnNames?: string[];
     /** Разрешить сортировку представления кликом по заголовку колонки. Сортировка локальная — только вид. */
     sort?: boolean;
     viewMode?: ViewMode;