@evergis/react 4.0.121 → 4.0.123

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

@@ -1,5 +1,20 @@
 import { FC } from 'react';
 import { ProgressContainerProps, RoundedBackgroundContainerProps } from '../types';
+/**
+ * Шаблоны, чей компонент держит `id`, `data-templatename`, авторский `style` и `$sizeCss`
+ * на ЕДИНСТВЕННОМ собственном корне — через `useContainerRoot` / `useWrapperSize`.
+ *
+ * Такому контейнеру не нужна внешняя обёртка `ElementValueWrapper`: она добавляла в DOM второй
+ * узел с теми же атрибутами и стилями (см. `formatElementValue`).
+ *
+ * Остальных здесь нет намеренно: `DefaultAttributes`, `EditGroup` и `OneColumn`/`TwoColumn`
+ * в режиме `attributesToRender` возвращают НЕСКОЛЬКО корней, а `Title`, `Icon`, `Divider`,
+ * `Tabs`, `AddFeature`, `ExportPdf`, `Progress`, `RoundedBackground` ставят `id`/`style` руками.
+ * Для них обёртка — единственный одиночный узел, снимать её нельзя.
+ *
+ * Переводишь очередной контейнер на `useContainerRoot` — добавь его сюда.
+ */
+export declare const ROOT_OWNING_TEMPLATES: ReadonlySet<string>;
 export declare const getContainerComponents: () => {
     readonly DefaultAttributes: FC<import('../componentTypes').DefaultAttributesContainerProps>;
     readonly Pages: FC<import('../componentTypes').PagesContainerProps>;

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

@@ -8,9 +8,12 @@ interface UseWrapperSizeParams {
 }
 export interface WrapperRootProps {
     id?: string;
+    /** Дубль `id` для внешних селекторов: раньше его нёс `ElementValueWrapper` вокруг контейнера. */
+    "data-id"?: string;
     "data-templatename"?: string;
     style?: CSSProperties;
     $sizeCss?: CSSObject;
+    $noMargin?: boolean;
 }
 /**
  * Пропсы корневой обёртки контейнера: идентификаторы для внешних селекторов, авторский `style`
@@ -18,6 +21,10 @@ export interface WrapperRootProps {
  *
  * Размеры уходят styled-пропом (класс), а не inline-стилем, поэтому перебиваются снаружи
  * без `!important`. Авторский `style` остаётся inline — у него приоритет по замыслу автора конфига.
+ *
+ * `data-id` и `$noMargin` раньше жили на внешней обёртке `ElementValueWrapper`; она вешала их
+ * на второй узел поверх этого корня, дублируя стили, и для таких контейнеров больше не создаётся
+ * (см. `ROOT_OWNING_TEMPLATES`).
  */
 export declare const useWrapperSize: ({ elementConfig, defaults }: UseWrapperSizeParams) => WrapperRootProps;
 export {};

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

@@ -4,6 +4,8 @@ import { AlignItems } from './types';
 /** Пропсы корневой обёртки контейнера — см. `useWrapperSize`. */
 export interface ContainerRootProps {
     $sizeCss?: CSSObject;
+    $noMargin?: boolean;
+    "data-id"?: string;
     "data-templatename"?: string;
 }
 /**
@@ -14,6 +16,22 @@ export interface ContainerRootProps {
  * вставки стилей). Снаружи такое правило по-прежнему перебивается `#id` без `!important`.
  */
 export declare const sizeCssMixin: import('styled-components').FlattenInterpolation<import('styled-components').ThemedStyledProps<ContainerRootProps, any>>;
+/**
+ * `options.noMargin` контейнера: гасит отступ, который родительская колонка ставит своим детям
+ * (`Container > *:not(:last-child)`).
+ *
+ * `&&&&` — ровно та сила, что была у обёртки `ElementValueWrapper`: правило должно перебивать
+ * и родительскую колонку, и собственные `defaults` контейнера, пришедшие в `$sizeCss`.
+ */
+export declare const noMarginMixin: import('styled-components').FlattenInterpolation<import('styled-components').ThemedStyledProps<ContainerRootProps, any>>;
+/**
+ * Обёртка значения элемента.
+ *
+ * Контейнеры, владеющие своим корнем (`ROOT_OWNING_TEMPLATES`), сюда больше не попадают —
+ * обёртка дублировала их `data-id`, `data-templatename` и `style` вторым узлом DOM.
+ * `$sizeTransparent` поэтому работает только на контейнерах, которые ещё не переведены
+ * на `useContainerRoot`.
+ */
 export declare const ElementValueWrapper: import('styled-components').StyledComponent<"div", any, {
     noMargin?: boolean;
     $sizeTransparent?: boolean;

package/dist/components/Dashboard/utils/formatElementValue.d.ts

@@ -1,10 +1,15 @@
 import { ReactNode } from 'react';
 import { i18n } from 'i18next';
 import { ClientFeatureAttribute, ConfigContainerChild, RenderElementValue } from '../types';
-export declare const formatElementValue: ({ t, value, elementConfig, attributes, wrap, }: {
+export declare const formatElementValue: ({ t, value, elementConfig, attributes, wrap, hasOwnRoot, }: {
     t: i18n["t"];
     value: RenderElementValue;
     elementConfig: ConfigContainerChild;
     attributes: ClientFeatureAttribute[];
     wrap?: boolean;
+    /**
+     * Значение — контейнер, который сам держит `id`, `data-templatename`, авторский `style`
+     * и `$sizeCss` на своём единственном корне (см. `useWrapperSize`). Обёртка ему не нужна.
+     */
+    hasOwnRoot?: boolean;
 }) => ReactNode | string;

package/dist/components/Dashboard/utils/getContainerComponent.d.ts

@@ -1 +1,9 @@
 export declare const getContainerComponent: (innerTemplateName: string) => any;
+/**
+ * Контейнер этого шаблона сам держит идентификаторы и стили на своём единственном корне —
+ * внешняя обёртка ему не нужна, см. {@link ROOT_OWNING_TEMPLATES}.
+ *
+ * Живёт рядом с `getContainerComponent` ради правила про неизвестный шаблон: тот резолвится
+ * в `default` (= `ContainersGroupContainer`), а он корнем владеет.
+ */
+export declare const isRootOwningContainer: (templateName?: string) => boolean;