@evergis/react 4.0.157 → 4.0.159

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/containers/StructuredDataContainer/constants.d.ts

@@ -1,4 +1,5 @@
 import { AttributeType } from '@evergis/api';
+import { ConfigAttributeControl } from '../../types';
 /** Слот представления: единственный ребёнок контейнера, рисующий данные (элемент `table`). */
 export declare const STRUCTURED_DATA_VIEW_SLOT = "data";
 /**
@@ -12,5 +13,7 @@ export declare const NUMBER_EDITOR_TYPES: AttributeType[];
 export declare const INTEGER_ATTRIBUTE_TYPES: AttributeType[];
 /** Тип атрибута, когда его не задали ни конфиг, ни источник. */
 export declare const DEFAULT_ATTRIBUTE_TYPE = AttributeType.String;
+/** Контрол колонки со списком значений, когда `control` в описании атрибута не задан. */
+export declare const DEFAULT_ATTRIBUTE_CONTROL: ConfigAttributeControl;
 /** Сколько миллисекунд висит нотификация об ошибке записи. */
 export declare const SAVE_ERROR_DURATION = 5000;

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

@@ -11,9 +11,13 @@ import { StructuredDataContainerConfig, WidgetType } from '../../../types';
  *
  * Берётся из конфига страницы, а не из загруженного источника: от него зависит, какие ячейки
  * редактируемы, и до окончания загрузки схема не должна меняться.
+ *
+ * `viewSchema` — та же схема со списками значений для представления. Списки зависят от
+ * загруженных источников страницы, поэтому в схему данных (черновик, запись) они не входят.
  */
 export declare const useStructuredDataSchema: (type: WidgetType, elementConfig?: StructuredDataContainerConfig) => {
     schema: import('../types').StructuredDataAttribute[];
+    viewSchema: import('../types').StructuredDataAttribute[];
     dataSource: import('../../../types').WidgetDataSource;
     layerName: string;
 };

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

@@ -1,7 +1,7 @@
 import { CSSProperties } from 'react';
 import { AttributeType, StringSubType } from '@evergis/api';
 import { FeatureAttributeValue } from '../../../../types';
-import { ConfigAttributeDescription } from '../../types';
+import { ChipOption, ConfigAttributeControl, ConfigAttributeDescription } from '../../types';
 /** Состояние строки черновика относительно последнего сохранения. */
 export type DraftRowState = "pristine" | "created" | "updated" | "deleted";
 /**
@@ -43,6 +43,13 @@ export interface StructuredDataAttribute {
     parentResourceId?: string;
     /** Что разрешено выбирать в диалоге файлов колонки вложений — значение `accept`. */
     fileExtensions?: string;
+    /** Контрол выбора из списка. Задан ровно тогда, когда задан `listOptions`. */
+    control?: ConfigAttributeControl;
+    /**
+     * Допустимые значения колонки — из `variants` либо из записей `relatedDataSource`. Есть только
+     * у схемы представления: черновику и записи список не нужен.
+     */
+    listOptions?: ChipOption[];
 }
 /**
  * Значение {@link StructuredDataContext} — всё, что нужно представлению (`ElementTable`)

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

@@ -0,0 +1,17 @@
+import { ChipOption, ConfigAttributeDescription, WidgetDataSource } from '../../../types';
+import { StructuredDataAttribute } from '../types';
+/**
+ * Список допустимых значений колонки: варианты из конфига, а без них — записи связанного
+ * источника. `undefined` — списка нет, и значение вводится вручную.
+ *
+ * Источник, ещё не загруженный или не найденный, даёт пустой список, а не его отсутствие:
+ * колонка со списком не должна на время загрузки превращаться в свободный ввод.
+ */
+export declare const getAttributeListOptions: (description: ConfigAttributeDescription | undefined, dataSources: WidgetDataSource[]) => ChipOption[] | undefined;
+/**
+ * Схема представления: схема данных плюс списки значений и их контролы.
+ *
+ * Отдельно от схемы данных потому, что зависит от загруженных источников страницы: черновик
+ * пересобирает строки при каждой смене схемы, и загрузка справочника стирала бы в нём правки.
+ */
+export declare const withListControls: (schema: StructuredDataAttribute[], attributesDescription: ConfigAttributeDescription[] | undefined, dataSources: WidgetDataSource[]) => StructuredDataAttribute[];

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

@@ -15,4 +15,10 @@ export declare const ModalTitleText: import('styled-components').StyledComponent
  * верхний угол строки заголовка, как в макете, а кликабельная площадь кнопки сохраняется.
  */
 export declare const ModalCloseButton: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;
+/**
+ * Каждого прямого ребёнка модалки `ContainerChildren` (`isMain`) оборачивает карточкой дашборда
+ * `ContainerWrapper`. `noBorders` снимает с неё тень и отступ, но не фон (90% белого) и не
+ * `backdrop-filter` — поверх шапки они легли бы белой размытой подложкой под каждым ребёнком.
+ * Селектор прямой: вложенные карточки страниц внутри содержимого остаются как есть.
+ */
 export declare const ModalContent: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -0,0 +1,13 @@
+import { FC } from 'react';
+import { TableCellProps } from '../types';
+/**
+ * Колонка со списком значений в виде ряда кнопок (`control: "chips"`).
+ *
+ * Ряд виден всегда, как галка у логической колонки: выбор — один клик, без открытия редактора.
+ * Выбранный пункт подсвечен, клик по нему снимает выбор — иначе очистить ячейку было бы нечем.
+ * Без права правки ряд остаётся на месте и показывает выбор, но на клики не отвечает.
+ *
+ * Кнопки — те же, что у фильтра-чипсов: вариант со своим `color`/`icon` выглядит одинаково и там,
+ * и здесь.
+ */
+export declare const ChipsCell: FC<TableCellProps>;

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

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

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

@@ -33,5 +33,14 @@ export declare const ATTACHMENTS_INLINE_LIMIT = 1;
  * Величина с макета и опцией не выносится: поп-ап у колонки один на все таблицы.
  */
 export declare const ATTACHMENTS_SHOWN_ITEMS = 3;
+/**
+ * Пустой пункт выпадающего списка в ячейке: выбор снимает значение. У `Dropdown` пункт с пустым
+ * значением показывается как плейсхолдер, поэтому и подпись у него — тот же прочерк, что у
+ * пустой ячейки.
+ */
+export declare const EMPTY_LIST_OPTION: {
+    text: string;
+    value: string;
+};
 /** Вид списка, с которого поп-ап вложений открывается. */
 export declare const ATTACHMENTS_VIEW_MODE: "list";

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

@@ -28,4 +28,5 @@ export declare const useCellEditing: () => {
         onBlur: ({ relatedTarget }: FocusEvent<HTMLDivElement>) => void;
         onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
     };
+    close: () => void;
 };

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

@@ -0,0 +1,9 @@
+/**
+ * Раскрывает `Dropdown` сразу, как ячейка перешла в правку.
+ *
+ * Правку открывает фокус ячейки, а своего «открыться сразу» у `Dropdown` нет: без этого список
+ * пришлось бы раскрывать вторым кликом, а с Tab-а — ещё и Enter-ом. Меню переключает клик по полю
+ * списка; поле — родитель скрытого `input`, которым `Dropdown` ловит клавиатуру (`FocusTrap`), и
+ * другого инпута внутри нет: поиск по пунктам живёт в портале.
+ */
+export declare const useDropdownAutoOpen: (editing: boolean) => import('react').MutableRefObject<HTMLDivElement>;

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

@@ -135,4 +135,15 @@ export declare const ColorCellBox: import('styled-components').StyledComponent<"
 export declare const ColorSwatch: import('styled-components').StyledComponent<"div", any, {
     $color: string;
 }, never>;
+/**
+ * Ряд кнопок колонки со списком. Не влезает в ширину колонки — переносится, и строка таблицы
+ * растёт вниз: резать выбор многоточием, как текст, нельзя.
+ *
+ * Зазор между кнопками по горизонтали даёт их собственный правый отступ, поэтому здесь задан
+ * только межстрочный. Отступы ряда — как у текстовой ячейки, чтобы значения соседних колонок
+ * стояли на одной линии.
+ */
+export declare const ChipsCellBox: import('styled-components').StyledComponent<"div", any, {
+    $interactive?: boolean;
+}, never>;
 export declare const TableEmpty: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -0,0 +1,11 @@
+import { FeatureAttributeValue } from '../../../../../types';
+import { ChipOption } from '../../../types';
+/**
+ * Значение ячейки совпадает со значением пункта списка.
+ *
+ * Сравниваем строками: у варианта из конфига значение бывает строкой, а в ячейке числового
+ * атрибута лежит число, и строгое сравнение не узнало бы собственный выбор.
+ */
+export declare const isSameListValue: (left: FeatureAttributeValue, right: FeatureAttributeValue) => boolean;
+/** Пункт списка, выбранный в ячейке. Нет — значение в ячейке не из списка либо пусто. */
+export declare const findListOption: (listOptions: ChipOption[], value: FeatureAttributeValue) => ChipOption | undefined;

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

@@ -606,7 +606,28 @@ export interface ConfigAttributeDescription {
      * (`".pdf,.jpg"` либо `"image/*"`). Не задан — ограничений нет.
      */
     fileExtensions?: string;
+    /**
+     * Контрол выбора значения из списка — `variants` либо записей `relatedDataSource`. Список задан,
+     * а контрол нет — `"dropdown"`. Без списка опция ни на что не влияет.
+     */
+    control?: ConfigAttributeControl;
+    /**
+     * Допустимые значения атрибута: в ячейку пишется `value`, показывается `text`. Заданы вместе
+     * с `relatedDataSource` — выигрывают варианты.
+     */
+    variants?: ChipOption[];
+    /** ⚠️ entity-ref: источник страницы, из записей которого собирается список значений. */
+    relatedDataSource?: string;
+    /** Атрибут записи `relatedDataSource`, чьё значение пишется в ячейку. Не задан — `attributeName`. */
+    attributeValue?: string;
+    /**
+     * Атрибут записи `relatedDataSource`, который показывается подписью значения. Не задан —
+     * `attributeValue`. Не путать с `alias` — это заголовок самой колонки.
+     */
+    attributeAlias?: string;
 }
+/** Контрол выбора значения атрибута из списка: выпадающий список либо ряд кнопок. */
+export type ConfigAttributeControl = "dropdown" | "chips";
 export interface ConfigDataSource {
     name: string;
     alias?: string;