@evergis/react 4.0.101 → 4.0.103

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

@@ -124,6 +124,12 @@ export interface ElementUploaderConfig extends Omit<ConfigContainerChild, "optio
 export interface ElementUploaderProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementUploaderConfig;
 }
+/**
+ * Опции размерной модели корневой обёртки — общие для всех контейнеров, которые проходят через
+ * `getWrapperSizeStyle`. Подмешивается к `<Name>ContainerOptions` вместо перечисления полей в
+ * каждом `Pick`, чтобы следующее размерное свойство не пришлось разносить по полутора десяткам мест.
+ */
+export type ContainerBoxOptions = Pick<ConfigOptions, "width" | "height" | "overflow">;
 export type AddFeatureContainerOptions = Record<string, never>;
 export type AddFeatureButtonOptions = Pick<ConfigOptions, "icon" | "title" | "layerName" | "geometryType">;
 export interface AddFeatureButtonChild extends Omit<ConfigContainerChild, "options" | "type"> {
@@ -138,7 +144,7 @@ export interface AddFeatureContainerConfig extends Omit<ConfigContainerChild, "o
 export interface AddFeatureContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: AddFeatureContainerConfig;
 }
-export type AttachmentContainerOptions = Pick<ConfigOptions, "expandable" | "expanded" | "viewMode" | "shownItems" | "otherItems" | "relatedDataSource" | "controls" | "width" | "height">;
+export type AttachmentContainerOptions = Pick<ConfigOptions, "expandable" | "expanded" | "viewMode" | "shownItems" | "otherItems" | "relatedDataSource" | "controls"> & ContainerBoxOptions;
 export interface AttachmentContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Attachment;
     options?: AttachmentContainerOptions;
@@ -146,7 +152,7 @@ export interface AttachmentContainerConfig extends Omit<ConfigContainerChild, "o
 export interface AttachmentContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: AttachmentContainerConfig;
 }
-export type CameraContainerOptions = Pick<ConfigOptions, "expandable" | "expanded" | "width" | "height">;
+export type CameraContainerOptions = Pick<ConfigOptions, "expandable" | "expanded"> & ContainerBoxOptions;
 export interface CameraContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Camera;
     options?: CameraContainerOptions;
@@ -154,7 +160,7 @@ export interface CameraContainerConfig extends Omit<ConfigContainerChild, "optio
 export interface CameraContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: CameraContainerConfig;
 }
-export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "width" | "height" | "chartFill">;
+export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "fill"> & ContainerBoxOptions;
 export interface ChartAliasChild extends Omit<ConfigContainerChild, "id"> {
     id: "alias";
 }
@@ -185,7 +191,7 @@ export interface ChartContainerConfig extends Omit<ConfigContainerChild, "option
 export interface ChartContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ChartContainerConfig;
 }
-export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "width" | "height" | "alignItems">;
+export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "alignItems"> & ContainerBoxOptions;
 export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.ContainersGroup;
     options?: ContainersGroupContainerOptions;
@@ -193,7 +199,7 @@ export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChil
 export interface ContainersGroupContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ContainersGroupContainerConfig;
 }
-export type DataSourceContainerOptions = Pick<ConfigOptions, "column" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "width" | "height">;
+export type DataSourceContainerOptions = Pick<ConfigOptions, "column" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded"> & ContainerBoxOptions;
 export interface DataSourceContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.DataSource;
     options?: DataSourceContainerOptions;
@@ -205,7 +211,7 @@ export type DataSourceInnerContainerOptions = Pick<ConfigOptions, "relatedDataSo
 export interface DataSourceInnerContainerConfig extends Omit<ConfigContainerChild, "options"> {
     options?: DataSourceInnerContainerOptions;
 }
-export type DataSourceProgressContainerOptions = Pick<ConfigOptions, "maxValue" | "showTotal" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "shownItems" | "otherItems" | "width" | "height">;
+export type DataSourceProgressContainerOptions = Pick<ConfigOptions, "maxValue" | "showTotal" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "shownItems" | "otherItems"> & ContainerBoxOptions;
 export interface DataSourceProgressContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.DataSourceProgress;
     options?: DataSourceProgressContainerOptions;
@@ -321,7 +327,7 @@ export interface ExportPdfContainerConfig extends Omit<ConfigContainerChild, "op
 export interface ExportPdfContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ExportPdfContainerConfig;
 }
-export type FiltersContainerOptions = Pick<ConfigOptions, "padding" | "bgColor" | "fontColor" | "fontSize" | "expandable" | "expanded" | "width" | "height">;
+export type FiltersContainerOptions = Pick<ConfigOptions, "padding" | "bgColor" | "fontColor" | "fontSize" | "expandable" | "expanded"> & ContainerBoxOptions;
 /**
  * Опции ребёнка FiltersContainer. Набор — объединение того, что реально читают все восемь
  * реализаций фильтра: dropdown берёт `variants`/`noEmptyOption`, text — `searchFilterName`
@@ -349,7 +355,7 @@ export interface IconContainerConfig extends Omit<ConfigContainerChild, "options
 export interface IconContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: IconContainerConfig;
 }
-export type ImageContainerOptions = Pick<ConfigOptions, "width" | "height">;
+export type ImageContainerOptions = ContainerBoxOptions;
 export interface ImageContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Image;
     options?: ImageContainerOptions;
@@ -357,7 +363,7 @@ export interface ImageContainerConfig extends Omit<ConfigContainerChild, "option
 export interface ImageContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ImageContainerConfig;
 }
-export type LayersContainerOptions = Pick<ConfigOptions, "layerNames" | "expandable" | "expanded" | "width" | "height">;
+export type LayersContainerOptions = Pick<ConfigOptions, "layerNames" | "expandable" | "expanded"> & ContainerBoxOptions;
 export interface LayersContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Layers;
     options?: LayersContainerOptions;
@@ -365,7 +371,7 @@ export interface LayersContainerConfig extends Omit<ConfigContainerChild, "optio
 export interface LayersContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: LayersContainerConfig;
 }
-export type OneColumnContainerOptions = Pick<ConfigOptions, "attributes" | "useProjectHiddenAttributes" | "hideEmpty" | "innerTemplateStyle" | "width" | "height">;
+export type OneColumnContainerOptions = Pick<ConfigOptions, "attributes" | "useProjectHiddenAttributes" | "hideEmpty" | "innerTemplateStyle"> & ContainerBoxOptions;
 export interface OneColumnContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.OneColumn;
     options?: OneColumnContainerOptions;
@@ -400,7 +406,7 @@ export interface RoundedBackgroundContainerConfig extends Omit<ConfigContainerCh
 export interface RoundedBackgroundContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: RoundedBackgroundContainerConfig;
 }
-export type SlideshowContainerOptions = Pick<ConfigOptions, "expandable" | "expanded" | "width" | "height">;
+export type SlideshowContainerOptions = Pick<ConfigOptions, "expandable" | "expanded"> & ContainerBoxOptions;
 export interface SlideshowContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Slideshow;
     options?: SlideshowContainerOptions;
@@ -421,7 +427,7 @@ export interface TabsContainerConfig extends Omit<ConfigContainerChild, "options
 export interface TabsContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: TabsContainerConfig;
 }
-export type TaskContainerOptions = Pick<ConfigOptions, "title" | "relatedResources" | "center" | "icon" | "statusColors" | "responseFilters" | "useNotifications" | "width" | "height">;
+export type TaskContainerOptions = Pick<ConfigOptions, "title" | "relatedResources" | "center" | "icon" | "statusColors" | "responseFilters" | "useNotifications"> & ContainerBoxOptions;
 export interface TaskContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Task;
     options?: TaskContainerOptions;
@@ -437,7 +443,7 @@ export interface TitleContainerConfig extends Omit<ConfigContainerChild, "option
 export interface TitleContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: TitleContainerConfig;
 }
-export type TwoColumnContainerOptions = Pick<ConfigOptions, "attributes" | "useProjectHiddenAttributes" | "hideEmpty" | "innerTemplateStyle" | "width" | "height">;
+export type TwoColumnContainerOptions = Pick<ConfigOptions, "attributes" | "useProjectHiddenAttributes" | "hideEmpty" | "innerTemplateStyle"> & ContainerBoxOptions;
 export interface TwoColumnContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.TwoColumn;
     options?: TwoColumnContainerOptions;
@@ -445,7 +451,7 @@ export interface TwoColumnContainerConfig extends Omit<ConfigContainerChild, "op
 export interface TwoColumnContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: TwoColumnContainerConfig;
 }
-export type UploadContainerOptions = Pick<ConfigOptions, "expandable" | "expanded" | "width" | "height">;
+export type UploadContainerOptions = Pick<ConfigOptions, "expandable" | "expanded"> & ContainerBoxOptions;
 export interface UploadContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Upload;
     options?: UploadContainerOptions;

package/dist/components/Dashboard/components/Chart/FillContext.d.ts

@@ -0,0 +1,15 @@
+/** Значение контекста вписывания тела графика в контейнер (`options.fill` контейнера Chart). */
+export interface FillContextValue {
+    /** Вписать тело графика в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
+    fill: boolean;
+    /** У контейнера ограниченная высота ⇒ можно фитить по высоте (иначе только по ширине). */
+    fitHeight: boolean;
+}
+/**
+ * Контекст вписывания графика (`options.fill` контейнера Chart).
+ *
+ * Компонент `Chart` рендерится через `renderElement({ id: "chart" })` и получает только дочерний
+ * узел `{ id: "chart" }` — опции контейнера до него не доходят. `ChartContainer` оборачивает
+ * график в провайдер этого контекста, а `Chart` читает значение через `useContext`.
+ */
+export declare const FillContext: import('react').Context<FillContextValue>;

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

@@ -15,6 +15,7 @@ export declare const PieChartCenter: import('styled-components').StyledComponent
 export declare const ChartWrapperContainer: import('styled-components').StyledComponent<"div", any, {
     column: boolean;
 }, never>;
+export declare const ChartFillMeasure: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const Tooltip: import('styled-components').StyledComponent<"div", any, {
     transform?: CSSProperties["transform"];
 }, never>;

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

@@ -8,6 +8,8 @@ export declare const StackBar: FC<{
     type: WidgetType;
     alias: ConfigContainerChild;
     options: ConfigOptions;
+    /** fill контейнера: полоса тянется на всю доступную высоту вместо толщины из options.height. */
+    fill?: boolean;
     renderElement: ContainerProps["renderElement"];
     renderTooltip: (data: PieChartData[]) => ReactElement | string;
 }>;

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

@@ -1,8 +1,11 @@
-export declare const StackBarContainer: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const StackBarContainer: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+    $fill?: boolean;
+}, never>;
 export declare const StackBarHeader: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
 export declare const StackBarSection: import('styled-components').StyledComponent<"div", any, {
     $width: string;
     $height?: string | number;
+    $fill?: boolean;
     $color: string;
     cornerRadius: number;
     hasAnyFilter?: boolean;

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

@@ -2,9 +2,11 @@ export declare const CheckboxWrapper: import('styled-components').StyledComponen
     fontColor?: string;
     big?: boolean;
     column?: boolean;
+    $fill?: boolean;
 }, never>;
 export declare const ChipsWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     fontColor?: string;
     big?: boolean;
     column?: boolean;
+    $fill?: boolean;
 }, never>;

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

@@ -21,9 +21,11 @@ export declare const BarChartContainer: import('styled-components').StyledCompon
 }, never>;
 export declare const AnyChartWrapper: import('styled-components').StyledComponent<"div", any, {
     height?: number;
+    $fill?: boolean;
 }, never>;
 export declare const BarChartWrapper: import('styled-components').StyledComponent<"div", any, {
     height?: number;
+    $fill?: boolean;
 }, never>;
 export declare const BarChartFilterHeader: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     height?: string | number;

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

@@ -2,13 +2,16 @@ export declare const ContainerAlias: import('styled-components').StyledComponent
     hasBottomMargin?: boolean;
 }, never>;
 export declare const ContainerAliasIcon: import('styled-components').StyledComponent<"div", any, {}, never>;
-export declare const ContainerChart: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const ContainerChart: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+    $fill?: boolean;
+}, never>;
 export declare const ContainerLegend: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
 export declare const ContainerUnits: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ContainerValue: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     fontColor?: string;
     big?: boolean;
     column?: boolean;
+    $fill?: boolean;
 }, never>;
 export declare const ContainerIcon: import('styled-components').StyledComponent<"span", any, import('@evergis/uilib-gl').IIconProps & {
     $fontColor?: string;

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

@@ -25,7 +25,7 @@ export * from './useHideIfEmptyDataSource';
 export * from './useProjectDashboardInit';
 export * from './useRelatedDataSourceAttributes';
 export * from './useRenderElement';
-export * from './useResizeWidth';
+export * from './useResizeBox';
 export * from './useShownOtherItems';
 export * from './useUpdateDataSource';
 export * from './useWidgetConfig';

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

@@ -0,0 +1,17 @@
+import { RefObject } from 'react';
+/** Измеренный content-box наблюдаемого элемента: обе оси в пикселях либо `undefined` до первого замера. */
+export interface ResizeBox {
+    width?: number;
+    height?: number;
+}
+/**
+ * Измеряет фактические ширину и высоту DOM-элемента и обновляет их на любой ресайз (ResizeObserver).
+ *
+ * Возвращает `[ref, box]`, где `box` — `{ width, height }` в пикселях (content-box) либо пустой объект,
+ * пока элемент ещё не измерен. Используется для «резинового» графика: d3-графикам нужны конкретные
+ * пиксельные размеры, а не CSS `100%`, а для вписывания (fit) нужны обе оси.
+ *
+ * `enabled: false` полностью отключает наблюдение — обычные (не fill) графики не измеряются
+ * и не вызывают лишних ре-рендеров.
+ */
+export declare const useResizeBox: (enabled: boolean) => [RefObject<HTMLDivElement>, ResizeBox];

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

@@ -21,6 +21,9 @@ export type AlignItems = (typeof ALIGN_ITEMS)[number];
 /** Масштабирование изображения внутри своего бокса (CSS `object-fit`). */
 export declare const OBJECT_FITS: readonly ["cover", "contain", "fill", "none", "scale-down"];
 export type ObjectFit = (typeof OBJECT_FITS)[number];
+/** Поведение контента, выходящего за бокс контейнера (CSS `overflow`). */
+export declare const OVERFLOWS: readonly ["visible", "hidden", "scroll", "auto"];
+export type Overflow = (typeof OVERFLOWS)[number];
 /**
  * CSS-размер контейнера: число — пиксели, строка — любое CSS-значение (`"100%"`, `"24rem"`,
  * `"calc(100% - 1rem)"`). Значение `"100%"` включает fill-режим — контейнер занимает всю ячейку
@@ -157,13 +160,21 @@ export interface ConfigLayoutOptions {
     width?: CssSize;
     /** Высота корневой обёртки контейнера. `"100%"` — заполнить ячейку родителя. */
     height?: CssSize;
+    /**
+     * Что делать с контентом, вылезающим за бокс контейнера (CSS `overflow`). Не задана — браузерный
+     * дефолт `visible`: контент вытекает и залезает на соседние слоты.
+     *
+     * Значения кроме `"visible"` обрезают и абсолютно спозиционированных потомков — у контейнера
+     * Filters с заданной высотой открытый список фильтра будет обрезан по боксу.
+     */
+    overflow?: Overflow;
     padding?: number;
     radius?: number;
     cornerRadius?: number;
     column?: boolean;
     twoColumns?: boolean;
-    /** Растянуть график контейнера Chart на всю ширину контейнера (график любого типа). */
-    chartFill?: boolean;
+    /** Вписать график контейнера Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
+    fill?: boolean;
     /** Горизонтальное выравнивание содержимого заголовка контейнера. */
     align?: Alignment;
     /** Выравнивание детей контейнера по поперечной оси. В ряду по умолчанию `center`. */
@@ -187,6 +198,10 @@ export interface MarkdownTagTypography {
     fontSize?: FontSizeToken | string;
     lineHeight?: string;
     fontWeight?: number | string;
+    /** Отступ снизу — задаёт расстояние до следующего блока (между тегами). */
+    marginBottom?: string;
+    /** Отступ сверху — задаёт расстояние до предыдущего блока (между тегами). */
+    marginTop?: string;
 }
 /**
  * Пер-тег типографика markdown-виджета. Отсутствующий тег или свойство —

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

@@ -1,6 +1,6 @@
 import { CSSProperties } from 'react';
 import { CSSObject } from 'styled-components';
-import { CssSize } from '../types';
+import { CssSize, Overflow } from '../types';
 /** Размер, при котором контейнер занимает всю ячейку родителя. */
 export declare const FILL_SIZE = "100%";
 export interface WrapperSizeParams {
@@ -10,6 +10,8 @@ export interface WrapperSizeParams {
     width?: CssSize;
     /** `options.height` контейнера. */
     height?: CssSize;
+    /** `options.overflow` контейнера — что делать с контентом, вылезающим за бокс. */
+    overflow?: Overflow;
     /** Внутренние дефолты обёртки контейнера: отступы, собственная высота и т.п. */
     defaults?: CSSObject;
     /** Ширина по умолчанию, если `options.width` не задан. Контейнеры передают `FILL_SIZE`, элементы — нет. */
@@ -26,5 +28,8 @@ export declare const isFillSize: (size?: CssSize) => boolean;
  * конфликтующие внутренние дефолты обёртки, а контент лишается возможности её распирать
  * (`min-width`/`min-height: 0`). Для fill-высоты добавляется `flex: 1 1 auto` — в колонке
  * контейнер забирает остаток ячейки под заголовком, а не переполняет её на его высоту.
+ *
+ * `overflow` уходит в CSS как есть и ничем не подменяется: не задан — работает браузерный
+ * `visible`, то есть контент крупнее бокса вытекает на соседние слоты.
  */
-export declare const getWrapperSizeStyle: ({ style, width: widthOption, height, defaults, defaultWidth, }: WrapperSizeParams) => CSSObject | undefined;
+export declare const getWrapperSizeStyle: ({ style, width: widthOption, height, overflow, defaults, defaultWidth, }: WrapperSizeParams) => CSSObject | undefined;