@evergis/react 4.0.155 → 4.0.157

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/LayersContainer/styled.d.ts

@@ -4,6 +4,4 @@ export declare const LayersContainerWrapper: import('styled-components').StyledC
     isMain?: boolean;
     noBorders?: boolean;
     $alignItems?: import('../..').AlignItems;
-} & {
-    isPresentationMode?: boolean;
 }, never>;

package/dist/components/Dashboard/elements/ElementModal/components/ModalHeaderBackground/index.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+import { ModalHeaderBackgroundProps } from './types';
+/**
+ * Фон шапки модалки (`modal.options.header`): градиент, картинка слота `bgImage` и `overlay` —
+ * снизу вверх. Нечего рисовать — в DOM не появляется ничего.
+ */
+export declare const ModalHeaderBackground: FC<ModalHeaderBackgroundProps>;

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

@@ -0,0 +1,20 @@
+import { ModalHeaderBgPosition } from '../../../../types';
+import { HeaderBackgroundLayerProps } from './types';
+/**
+ * Слой шапки модалки: лежит под заголовком и содержимым (`z-index: -1` внутри изолированного окна),
+ * клики пропускает. Без отступа повторяет верхние скругления окна — на мобильной ширине окно
+ * квадратное, и слой вслед за ним тоже.
+ */
+export declare const HeaderBackgroundLayer: import('styled-components').StyledComponent<"div", any, HeaderBackgroundLayerProps, never>;
+/** Рисунок из шапки карточки: растянут по ширине окна, видна его верхняя, самая насыщенная часть. */
+export declare const HeaderGradient: import('styled-components').StyledComponent<"div", any, {}, never>;
+/**
+ * Картинка слота `bgImage`. По умолчанию заполняет шапку (`cover`); авторский `fit` у слота
+ * перебивает его (`&&` у `ElementImg`). Якорь задаёт только `header.bgPosition`.
+ */
+export declare const HeaderImage: import('styled-components').StyledComponent<"div", any, {
+    $bgPosition?: ModalHeaderBgPosition;
+}, never>;
+export declare const HeaderOverlay: import('styled-components').StyledComponent<"div", any, {
+    $overlay: string;
+}, never>;

package/dist/components/Dashboard/elements/ElementModal/components/ModalHeaderBackground/types.d.ts

@@ -0,0 +1,13 @@
+import { ConfigModalHeaderOptions, RenderElementFunction } from '../../../../types';
+export interface ModalHeaderBackgroundProps {
+    header?: ConfigModalHeaderOptions;
+    /** Среди прямых детей модалки есть слот `bgImage`. */
+    hasBgImage?: boolean;
+    /** Рендер слотов модалки — видит только её прямых детей. */
+    renderElement: RenderElementFunction;
+}
+export interface HeaderBackgroundLayerProps {
+    $height: string;
+    $withPadding?: boolean;
+    $bottomBlur?: boolean;
+}

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

@@ -0,0 +1,29 @@
+import { ModalHeaderBgPosition } from '../../types';
+/** Slot-id иконки перед заголовком модалки — тот же, что у заголовка контейнера. */
+export declare const MODAL_TITLE_ICON_SLOT_ID = "titleIcon";
+/**
+ * Слоты, которые модалка рисует сама: иконка заголовка и фон шапки. Берутся только из ПРЯМЫХ детей
+ * модалки — `renderElement` ищет `id` по всему поддереву, и слот вложенного контейнера иначе всплыл бы
+ * в заголовок модалки.
+ */
+export declare const MODAL_SLOT_IDS: string[];
+/** Отступ диалога сверху, по бокам и снизу — по макету. */
+export declare const MODAL_PADDING = "3rem";
+/** Зазор между заголовком и содержимым — по макету. */
+export declare const MODAL_TITLE_GAP = "2rem";
+/**
+ * Ширина скроллбара хоста (глобальный `::-webkit-scrollbar` client-new). Место под него
+ * зарезервировано всегда (`scrollbar-gutter: stable`), поэтому на эту ширину уменьшается правый
+ * отступ содержимого: правый край контента остаётся на одной линии с крестиком.
+ */
+export declare const MODAL_SCROLLBAR_WIDTH = "0.75rem";
+/** Тень диалога — по макету. */
+export declare const MODAL_SHADOW = "0 0.1875rem 0.3125rem rgba(0, 0, 0, 0.15)";
+/** Высота шапки по умолчанию (82px) — по макету. */
+export declare const MODAL_HEADER_HEIGHT = "5.125rem";
+/** Отступ шапки от краёв диалога при `header.withPadding` — по макету. */
+export declare const MODAL_HEADER_PADDING = "0.5rem";
+/** Растворение шапки книзу: непрозрачно сверху, полностью прозрачно к 95% высоты — по макету. */
+export declare const MODAL_HEADER_BLUR_MASK = "linear-gradient(to bottom, #000 0%, transparent 95%)";
+/** `header.bgPosition` → `object-position` картинки шапки. */
+export declare const MODAL_HEADER_BG_POSITION: Record<ModalHeaderBgPosition, string>;

package/dist/components/Dashboard/elements/ElementModal/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './useModalContent';
+export * from './useModalOpen';

package/dist/components/Dashboard/elements/ElementModal/hooks/useModalContent.d.ts

@@ -0,0 +1,16 @@
+import { ConfigContainerChild, WidgetType } from '../../../types';
+/**
+ * Конфиг модалки `modalId` и рендер её детей.
+ *
+ * Рендеров два: `renderElement` — для тела, `renderSlot` — для слотов, которые модалка рисует сама
+ * (`titleIcon`, `bgImage`). `renderElement` ищет `id` по всему поддереву, поэтому слот вложенного
+ * контейнера всплыл бы в заголовок или шапку модалки; `renderSlot` видит только её прямых детей.
+ */
+export declare const useModalContent: (type: WidgetType, modalId?: string) => {
+    modalConfig: any;
+    modalContent: ConfigContainerChild[];
+    renderElement: import('../../../types').RenderElementFunction;
+    renderSlot: import('../../../types').RenderElementFunction;
+    hasTitleIcon: boolean;
+    hasBgImage: boolean;
+};

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

@@ -1 +1,18 @@
 export declare const ModalIcon: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;
+/**
+ * Окно диалога. `className` у `Dialog` уходит на его бланк, поэтому стили ложатся на само окно.
+ *
+ * `position: relative` + `isolation: isolate` делают окно хостом слоя шапки: слой с `z-index: -1`
+ * ложится поверх фона окна, но под заголовком и содержимым. `&&` перебивает стили бланка uilib-gl.
+ */
+export declare const ModalDialog: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IDialogProps>, any, {}, never>;
+/** Прозрачный фон — иначе заливка заголовка uilib-gl перекрыла бы шапку. */
+export declare const ModalTitle: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').IDialogTitleProps, never>;
+export declare const ModalTitleRow: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const ModalTitleText: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+/**
+ * Глиф крестика 1rem по центру кнопки 3rem × 2.25rem. Отрицательные отступы ставят его в правый
+ * верхний угол строки заголовка, как в макете, а кликабельная площадь кнопки сохраняется.
+ */
+export declare const ModalCloseButton: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {}, never>;
+export declare const ModalContent: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -6,6 +6,5 @@ export declare const DashboardPlaceholder: import('styled-components').StyledCom
 }, never>;
 export declare const DashboardWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     hasImage?: boolean;
-    isPresentationMode?: boolean;
 }, never>;
 export declare const DashboardContent: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;

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

@@ -760,11 +760,36 @@ export interface ConfigTask {
     updateDate?: string;
     id?: string;
 }
+/** Край, к которому прижимается картинка слота `bgImage` в шапке модалки. */
+export declare const MODAL_HEADER_BG_POSITIONS: readonly ["left", "right", "top", "bottom"];
+export type ModalHeaderBgPosition = (typeof MODAL_HEADER_BG_POSITIONS)[number];
+/**
+ * Фон шапки модалки — абсолютный слой под заголовком и содержимым: раскладку диалога он не сдвигает.
+ *
+ * Слой рисуется, когда есть что рисовать: `gradient`, `overlay` или слот `bgImage` среди детей модалки.
+ * Порядок снизу вверх: градиент → картинка `bgImage` → `overlay`. Сам слот `bgImage` — обычный
+ * элемент `type: "image"`; его геометрию и якорь задают эти опции, а масштаб — его собственный `fit`.
+ */
+export interface ConfigModalHeaderOptions {
+    /** Градиентный рисунок из шапки карточки объекта (`header-gradient.png`). */
+    gradient?: boolean;
+    /** Высота блока шапки от верхнего края диалога, px. По умолчанию 82px — по макету. */
+    height?: number;
+    /** Отступ 0.5rem сверху и по бокам: шапка становится отдельной скруглённой плашкой. */
+    withPadding?: boolean;
+    /** Растворение шапки книзу — до прозрачного к 95% высоты. По умолчанию включено, `false` выключает. */
+    bottomBlur?: boolean;
+    /** Якорь картинки `bgImage` (`object-position`). Не задан — по центру. */
+    bgPosition?: ModalHeaderBgPosition;
+    /** CSS `background` поверх картинки: цвет или градиент. Работает и без картинки. */
+    overlay?: string;
+}
 export interface ConfigModalOptions {
     title?: string;
     maxWidth?: string;
     minWidth?: string;
     minHeight?: string;
+    header?: ConfigModalHeaderOptions;
 }
 export interface ConfigModalContentRef {
     containerId: string;