@evergis/react 4.0.95 → 4.0.97

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

@@ -1,5 +1,5 @@
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, ConfigContainerHeader, ConfigOptions, ContainerProps, ContainerTemplate, HeaderTemplate } from './types';
+import { ClientFeatureAttribute, ConfigContainer, ConfigContainerChild, ConfigContainerHeader, ConfigOptions, ContainerProps, ContainerTemplate, HeaderTemplate, NumericSizeOptions } from './types';
 export type ElementButtonOptions = Record<string, never>;
 export interface ElementButtonConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "button";
@@ -16,7 +16,7 @@ export interface ElementCameraConfig extends Omit<ConfigContainerChild, "options
 export interface ElementCameraProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementCameraConfig;
 }
-export type ElementChartOptions = Pick<ConfigOptions, "column" | "markers" | "showLabels" | "showMarkers" | "showTotal" | "totalWord" | "totalAttribute" | "expandable" | "expanded" | "chartType" | "relatedDataSources" | "defaultColor" | "dotSnapping" | "height" | "radius" | "padding" | "fontColor" | "angle" | "barWidth" | "cornerRadius" | "width">;
+export type ElementChartOptions = Pick<ConfigOptions, "column" | "markers" | "showLabels" | "showMarkers" | "showTotal" | "totalWord" | "totalAttribute" | "expandable" | "expanded" | "chartType" | "relatedDataSources" | "defaultColor" | "dotSnapping" | "radius" | "padding" | "fontColor" | "angle" | "barWidth" | "cornerRadius"> & NumericSizeOptions;
 export interface ElementChartConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "chart";
     options?: ElementChartOptions;
@@ -32,7 +32,7 @@ export interface ElementChipsConfig extends Omit<ConfigContainerChild, "options"
 export interface ElementChipsProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementChipsConfig;
 }
-export type ElementControlOptions = Pick<ConfigOptions, "relatedDataSource" | "label" | "width" | "control" | "placeholder">;
+export type ElementControlOptions = Pick<ConfigOptions, "relatedDataSource" | "label" | "control" | "placeholder"> & Pick<NumericSizeOptions, "width">;
 export interface ElementControlConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "control";
     options?: ElementControlOptions;
@@ -48,7 +48,7 @@ export interface ElementIconConfig extends Omit<ConfigContainerChild, "options"
 export interface ElementIconProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementIconConfig;
 }
-export type ElementImageOptions = Pick<ConfigOptions, "width">;
+export type ElementImageOptions = Pick<ConfigOptions, "width" | "height" | "fit">;
 export interface ElementImageConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "image";
     options?: ElementImageOptions;
@@ -74,7 +74,7 @@ export interface ElementLinkConfig extends Omit<ConfigContainerChild, "options"
 export interface ElementLinkProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementLinkConfig;
 }
-export type ElementMarkdownOptions = Pick<ConfigOptions, "expandLength">;
+export type ElementMarkdownOptions = Pick<ConfigOptions, "expandLength" | "noMargin">;
 export interface ElementMarkdownConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "markdown";
     options?: ElementMarkdownOptions;
@@ -98,7 +98,7 @@ export interface ElementSlideshowConfig extends Omit<ConfigContainerChild, "opti
 export interface ElementSlideshowProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementSlideshowConfig;
 }
-export type ElementSvgOptions = Pick<ConfigOptions, "width" | "height" | "fontColor">;
+export type ElementSvgOptions = Pick<ConfigOptions, "fontColor"> & NumericSizeOptions;
 export interface ElementSvgConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "svg";
     options?: ElementSvgOptions;
@@ -154,7 +154,7 @@ export interface CameraContainerConfig extends Omit<ConfigContainerChild, "optio
 export interface CameraContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: CameraContainerConfig;
 }
-export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty">;
+export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "width" | "height" | "chartFill">;
 export interface ChartAliasChild extends Omit<ConfigContainerChild, "id"> {
     id: "alias";
 }
@@ -185,7 +185,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">;
+export type ContainersGroupContainerOptions = Pick<ConfigOptions, "column" | "expandable" | "expanded" | "width" | "height" | "alignItems">;
 export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.ContainersGroup;
     options?: ContainersGroupContainerOptions;
@@ -193,7 +193,7 @@ export interface ContainersGroupContainerConfig extends Omit<ConfigContainerChil
 export interface ContainersGroupContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ContainersGroupContainerConfig;
 }
-export type DataSourceContainerOptions = Pick<ConfigOptions, "column" | "relatedDataSource" | "expandable" | "expanded" | "width" | "height">;
+export type DataSourceContainerOptions = Pick<ConfigOptions, "column" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "width" | "height">;
 export interface DataSourceContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.DataSource;
     options?: DataSourceContainerOptions;
@@ -205,7 +205,7 @@ export type DataSourceInnerContainerOptions = Pick<ConfigOptions, "relatedDataSo
 export interface DataSourceInnerContainerConfig extends Omit<ConfigContainerChild, "options"> {
     options?: DataSourceInnerContainerOptions;
 }
-export type DataSourceProgressContainerOptions = Pick<ConfigOptions, "maxValue" | "showTotal" | "relatedDataSource" | "expandable" | "expanded" | "shownItems" | "width" | "height">;
+export type DataSourceProgressContainerOptions = Pick<ConfigOptions, "maxValue" | "showTotal" | "relatedDataSource" | "innerTemplateName" | "expandable" | "expanded" | "shownItems" | "otherItems" | "width" | "height">;
 export interface DataSourceProgressContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.DataSourceProgress;
     options?: DataSourceProgressContainerOptions;
@@ -322,7 +322,12 @@ export interface ExportPdfContainerProps extends Omit<ContainerProps, "elementCo
     elementConfig?: ExportPdfContainerConfig;
 }
 export type FiltersContainerOptions = Pick<ConfigOptions, "padding" | "bgColor" | "fontColor" | "fontSize" | "expandable" | "expanded" | "width" | "height">;
-export type FilterChildOptions = Pick<ConfigOptions, "filterName" | "label" | "placeholder" | "control" | "controls" | "relatedDataSource" | "minValue" | "maxValue">;
+/**
+ * Опции ребёнка FiltersContainer. Набор — объединение того, что реально читают все восемь
+ * реализаций фильтра: dropdown берёт `variants`/`noEmptyOption`, text — `searchFilterName`
+ * и `multiSelect`, chips — цвета и иконку, rangeNumber — `step` и границы, rangeDate — `withTime`.
+ */
+export type FilterChildOptions = Pick<ConfigOptions, "filterName" | "searchFilterName" | "label" | "placeholder" | "control" | "controls" | "relatedDataSource" | "minValue" | "maxValue" | "step" | "withTime" | "multiSelect" | "variants" | "noEmptyOption" | "width" | "height" | "align" | "shownItems" | "icon" | "iconAttribute" | "colorAttribute" | "fontColor" | "backgroundColor" | "maxTextWidth">;
 export interface FilterChild extends Omit<ConfigContainerChild, "options" | "type"> {
     /** {@link FilterType} оставляем строкой, чтобы не плодить два почти одинаковых union-а в `type`. */
     type?: ConfigContainerChild["type"];
@@ -344,7 +349,7 @@ export interface IconContainerConfig extends Omit<ConfigContainerChild, "options
 export interface IconContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: IconContainerConfig;
 }
-export type ImageContainerOptions = Record<string, never>;
+export type ImageContainerOptions = Pick<ConfigOptions, "width" | "height">;
 export interface ImageContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Image;
     options?: ImageContainerOptions;
@@ -387,7 +392,7 @@ export interface ProgressContainerConfig extends Omit<ConfigContainerChild, "opt
 export interface ProgressContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ProgressContainerConfig;
 }
-export type RoundedBackgroundContainerOptions = Pick<ConfigOptions, "maxLength" | "center" | "fontColor" | "innerTemplateStyle" | "inlineUnits" | "big" | "bigIcon" | "hideEmpty" | "colorAttribute">;
+export type RoundedBackgroundContainerOptions = Pick<ConfigOptions, "maxLength" | "wordBreak" | "center" | "fontColor" | "innerTemplateStyle" | "inlineUnits" | "big" | "bigIcon" | "hideEmpty" | "colorAttribute">;
 export interface RoundedBackgroundContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.RoundedBackground;
     options?: RoundedBackgroundContainerOptions;
@@ -424,7 +429,7 @@ export interface TaskContainerConfig extends Omit<ConfigContainerChild, "options
 export interface TaskContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: TaskContainerConfig;
 }
-export type TitleContainerOptions = Pick<ConfigOptions, "simple" | "downloadById">;
+export type TitleContainerOptions = Pick<ConfigOptions, "simple" | "downloadById" | "align">;
 export interface TitleContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
     templateName?: ContainerTemplate.Title;
     options?: TitleContainerOptions;

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

@@ -0,0 +1,8 @@
+/**
+ * Флаг «растянуть график на всю ширину контейнера» (`options.chartFill` контейнера Chart).
+ *
+ * Компонент `Chart` рендерится через `renderElement({ id: "chart" })` и получает только дочерний
+ * узел `{ id: "chart" }` — опции контейнера до него не доходят. `ChartContainer` оборачивает
+ * график в провайдер этого контекста, а `Chart` читает флаг через `useContext`.
+ */
+export declare const ChartFillContext: import('react').Context<boolean>;

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

@@ -1,3 +1,2 @@
-import { FC } from 'react';
 import { ChartContainerProps } from '../types';
-export declare const ChartWrapper: FC<ChartContainerProps>;
+export declare const ChartWrapper: import('react').MemoExoticComponent<import('react').ForwardRefExoticComponent<ChartContainerProps & import('react').RefAttributes<HTMLDivElement>>>;

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

@@ -1,4 +1,4 @@
-import { CSSProperties } from 'react';
+import { CSSObject } from 'styled-components';
 import { AttributeType } from '@evergis/api';
 import { ConfigContainer, ConfigContainerChild } from './types';
 export declare const CONFIG_PAGES_ID = "pages";
@@ -33,4 +33,5 @@ export declare const GEOMETRY_ATTRIBUTE = "geometry";
 export declare const DEFAULT_ID_ATTRIBUTE_NAME = "gid";
 export declare const DEFAULT_DROPDOWN_WIDTH = 312;
 export declare const DEFAULT_FILTER_PADDING = 12;
-export declare const BASE_CONTAINER_STYLE: CSSProperties;
+/** Базовый отступ обёртки контейнера. Снимается, когда контейнер занимает ячейку целиком. */
+export declare const BASE_CONTAINER_STYLE: CSSObject;

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

@@ -0,0 +1,2 @@
+import { ContainerRootProps } from '../../styled';
+export declare const ChartContainerWrapper: import('styled-components').StyledComponent<"span", any, import('@evergis/uilib-gl').FlexSpanProps & ContainerRootProps, never>;

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

@@ -0,0 +1,20 @@
+/**
+ * Обёртка записей источника.
+ *
+ * В ряду (`column: false`) записи переносятся на новую строку. Без переноса они дрались бы за
+ * одну строку: обёртка каждой записи — flex-элемент и ужимается, а внутренний шаблон (плашка
+ * RoundedBackground имеет жёсткие 9rem) — нет, поэтому записи наезжали бы друг на друга.
+ *
+ * `flex-wrap` намеренно не вынесен в row-ветку самого `Container`: там дети — карточки
+ * контейнеров шириной 100%, и перенос уложил бы их по одной на строку, сломав ряд у
+ * ContainersGroup.
+ */
+export declare const DataSourceContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & import('../../styled').ContainerRootProps & {
+    isTitle?: boolean;
+    isColumn?: boolean;
+    isMain?: boolean;
+    noBorders?: boolean;
+    $alignItems?: import('../..').AlignItems;
+} & {
+    $isRow?: boolean;
+}, never>;

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

@@ -1,4 +1,5 @@
-export declare const DataSourceProgressContainerWrapper: import('styled-components').StyledComponent<"div", any, {}, never>;
+import { ContainerRootProps } from '../../styled';
+export declare const DataSourceProgressContainerWrapper: import('styled-components').StyledComponent<"div", any, ContainerRootProps, never>;
 export declare const ContainerToggler: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IIconButtonProps>, any, {
     toggled?: boolean | undefined;
     color?: string | undefined;

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

@@ -1,10 +1,19 @@
-export declare const FiltersContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+import { ContainerRootProps } from '../../styled';
+export declare const FiltersContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps & {
     $padding?: number;
     $bgColor?: string;
     $fontSize?: string;
     $fontColor?: string;
 }, never>;
 export declare const StyledIconButton: import('styled-components').StyledComponent<any, any, any, any>;
+/**
+ * Обёртка фильтра-дерева.
+ *
+ * TreeDropdown вешает `width` на сам `<input>`, а не на свою корневую обёртку. Из-за этого
+ * `width: 100%` резолвится относительно обёртки, ширина которой определяется контентом, —
+ * и фильтр встаёт уже соседних. Растягиваем обёртку принудительно.
+ */
+export declare const TreeFilterContainer: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const TextFilterContainer: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const BarChartContainer: import('styled-components').StyledComponent<"div", any, {
     barHeight?: number;

package/dist/components/Dashboard/containers/FiltersContainer/utils/getFilterWidth.d.ts

@@ -0,0 +1,9 @@
+import { CssSize } from '../../../types';
+/**
+ * Ширина фильтра из конфига. Без явного значения фильтр занимает всю ширину контейнера.
+ *
+ * Раньше у каждого фильтра был свой пиксельный фолбэк, подогнанный под левую панель приложения
+ * (288px у Dropdown, 17.25rem у Text, 17rem у RangeNumber, ничего у Tree), из-за чего в одной
+ * панели фильтры вставали «лесенкой» — и тем заметнее, чем шире контейнер.
+ */
+export declare const getFilterWidth: (width?: CssSize) => string;

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

@@ -1,5 +1,6 @@
+import { ContainerRootProps } from '../../styled';
 export declare const ImageContainerBg: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ImageContainerTitle: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ImageContainerText: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const ImageContainerButton: import('styled-components').StyledComponent<"button", any, import('@evergis/uilib-gl').IButtonProps, never>;
-export declare const ImageContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const ImageContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps, never>;

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

@@ -1,8 +1,9 @@
-export declare const LayersContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+export declare const LayersContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & import('../../styled').ContainerRootProps & {
     isTitle?: boolean;
     isColumn?: boolean;
     isMain?: boolean;
     noBorders?: boolean;
+    $alignItems?: import('../..').AlignItems;
 } & {
     isPresentationMode?: boolean;
 }, never>;

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

@@ -0,0 +1,2 @@
+import { ContainerRootProps } from '../../styled';
+export declare const TaskContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps, never>;

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

@@ -1,6 +1,8 @@
+import { Alignment } from '../../types';
 export declare const ContainerIconTitle: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     fontColor?: string;
 }, never>;
 export declare const ContainerTitle: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     simple?: boolean;
+    $align?: Alignment;
 }, never>;

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

@@ -1,6 +1,9 @@
-export declare const UploaderContainer: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+import { ContainerRootProps } from '../../styled';
+export declare const UploadContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps, never>;
+export declare const UploaderContainer: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps & {
     isTitle?: boolean;
     isColumn?: boolean;
     isMain?: boolean;
     noBorders?: boolean;
+    $alignItems?: import('../..').AlignItems;
 }, never>;

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

@@ -1,6 +1,6 @@
 import { FC } from 'react';
 import { ProgressContainerProps, RoundedBackgroundContainerProps } from '../types';
-export declare const containerComponents: {
+export declare const getContainerComponents: () => {
     readonly DefaultAttributes: FC<import('../componentTypes').DefaultAttributesContainerProps>;
     readonly Pages: FC<import('../componentTypes').PagesContainerProps>;
     readonly Tabs: FC<import('../componentTypes').TabsContainerProps>;

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

@@ -18,9 +18,10 @@ export declare const SvgContainer: import('styled-components').StyledComponent<"
     $width?: number;
     $fontColor?: string;
 }, never>;
-export declare const TwoColumnContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+export declare const TwoColumnContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & import('../styled').ContainerRootProps & {
     isTitle?: boolean;
     isColumn?: boolean;
     isMain?: boolean;
     noBorders?: boolean;
+    $alignItems?: import('..').AlignItems;
 }, never>;

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

@@ -0,0 +1,5 @@
+import { ContainerRootProps } from '../../styled';
+import { ObjectFit } from '../../types';
+export declare const ElementImg: import('styled-components').StyledComponent<"img", any, ContainerRootProps & {
+    $fit?: ObjectFit;
+}, never>;

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

@@ -1 +1,3 @@
-export declare const MarkdownWrapper: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const MarkdownWrapper: import('styled-components').StyledComponent<"div", any, {
+    $noMargin?: boolean;
+}, never>;

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

@@ -25,8 +25,10 @@ export * from './useHideIfEmptyDataSource';
 export * from './useProjectDashboardInit';
 export * from './useRelatedDataSourceAttributes';
 export * from './useRenderElement';
+export * from './useResizeWidth';
 export * from './useShownOtherItems';
 export * from './useUpdateDataSource';
 export * from './useWidgetConfig';
 export * from './useWidgetContext';
 export * from './useWidgetPage';
+export * from './useWrapperSize';

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

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

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

@@ -0,0 +1,23 @@
+import { CSSProperties } from 'react';
+import { CSSObject } from 'styled-components';
+import { ConfigContainerChild } from '../types';
+interface UseWrapperSizeParams {
+    elementConfig?: ConfigContainerChild;
+    /** Внутренние дефолты обёртки контейнера. Ссылка должна быть стабильной (константа или useMemo). */
+    defaults?: CSSObject;
+}
+export interface WrapperRootProps {
+    id?: string;
+    "data-templatename"?: string;
+    style?: CSSProperties;
+    $sizeCss?: CSSObject;
+}
+/**
+ * Пропсы корневой обёртки контейнера: идентификаторы для внешних селекторов, авторский `style`
+ * из конфига и css-объект размеров.
+ *
+ * Размеры уходят styled-пропом (класс), а не inline-стилем, поэтому перебиваются снаружи
+ * без `!important`. Авторский `style` остаётся inline — у него приоритет по замыслу автора конфига.
+ */
+export declare const useWrapperSize: ({ elementConfig, defaults }: UseWrapperSizeParams) => WrapperRootProps;
+export {};

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

@@ -1,12 +1,29 @@
 import { CSSProperties } from 'react';
+import { CSSObject } from 'styled-components';
+import { AlignItems } from './types';
+/** Пропсы корневой обёртки контейнера — см. `useWrapperSize`. */
+export interface ContainerRootProps {
+    $sizeCss?: CSSObject;
+    "data-templatename"?: string;
+}
+/**
+ * Размеры контейнера из конфига.
+ *
+ * `&&` поднимает специфичность до двух классов: иначе правило проиграет родительскому
+ * `Container > * { width: 100% }` (та же специфичность — победитель зависел бы от порядка
+ * вставки стилей). Снаружи такое правило по-прежнему перебивается `#id` без `!important`.
+ */
+export declare const sizeCssMixin: import('styled-components').FlattenInterpolation<import('styled-components').ThemedStyledProps<ContainerRootProps, any>>;
 export declare const ElementValueWrapper: import('styled-components').StyledComponent<"div", any, {
     noMargin?: boolean;
+    $sizeTransparent?: boolean;
 }, never>;
-export declare const Container: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+export declare const Container: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & ContainerRootProps & {
     isTitle?: boolean;
     isColumn?: boolean;
     isMain?: boolean;
     noBorders?: boolean;
+    $alignItems?: AlignItems;
 }, never>;
 export declare const ContainerWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     $zIndex?: CSSProperties["zIndex"];

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

@@ -15,6 +15,26 @@ export type ChartType = (typeof CHART_TYPES)[number];
 /** Выравнивание текста/блоков. */
 export declare const ALIGNMENTS: readonly ["left", "center", "right"];
 export type Alignment = (typeof ALIGNMENTS)[number];
+/** Выравнивание детей контейнера по поперечной оси (CSS `align-items`). */
+export declare const ALIGN_ITEMS: readonly ["flex-start", "center", "flex-end", "stretch", "baseline"];
+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-размер контейнера: число — пиксели, строка — любое CSS-значение (`"100%"`, `"24rem"`,
+ * `"calc(100% - 1rem)"`). Значение `"100%"` включает fill-режим — контейнер занимает всю ячейку
+ * родителя, а его внутренние дефолты (отступы, собственная высота) снимаются.
+ */
+export type CssSize = number | string;
+/**
+ * Размеры, которые обязаны оставаться числом в пикселях: значение уходит в вычисления
+ * (геометрия графиков) или в HTML-атрибут, где `"100%"` не работает.
+ */
+export interface NumericSizeOptions {
+    width?: number;
+    height?: number;
+}
 /** Режим отображения коллекций. */
 export declare const VIEW_MODES: readonly ["grid", "list"];
 export type ViewMode = (typeof VIEW_MODES)[number];
@@ -87,11 +107,13 @@ export interface SaveHookInput {
     changedProperties: Record<string, unknown>;
     changedGeometry?: Geometry;
 }
-export interface ConfigControl extends Pick<ConfigOptions, "relatedDataSource" | "minValue" | "maxValue" | "step" | "label" | "placeholder" | "width" | "variants"> {
+export interface ConfigControl extends Pick<ConfigOptions, "relatedDataSource" | "minValue" | "maxValue" | "step" | "label" | "placeholder" | "variants"> {
     type: "dropdown" | "checkbox" | "chips" | "string";
     attributeName?: string;
     targetAttributeName?: string;
     defaultValue?: EditAttributeValue;
+    /** Ширина контрола в пикселях — уходит в CSS-строку, проценты не поддерживаются. */
+    width?: number;
 }
 export interface BaseMapSettings {
     opacity?: number;
@@ -131,14 +153,23 @@ export interface CustomFeatureSelect {
  */
 /** Размеры и раскладка. */
 export interface ConfigLayoutOptions {
-    width?: number;
-    height?: number;
+    /** Ширина корневой обёртки контейнера. Число — пиксели, строка — CSS-значение. */
+    width?: CssSize;
+    /** Высота корневой обёртки контейнера. `"100%"` — заполнить ячейку родителя. */
+    height?: CssSize;
     padding?: number;
     radius?: number;
     cornerRadius?: number;
     column?: boolean;
     twoColumns?: boolean;
+    /** Растянуть график контейнера Chart на всю ширину контейнера (график любого типа). */
+    chartFill?: boolean;
+    /** Горизонтальное выравнивание содержимого заголовка контейнера. */
     align?: Alignment;
+    /** Выравнивание детей контейнера по поперечной оси. В ряду по умолчанию `center`. */
+    alignItems?: AlignItems;
+    /** Масштабирование изображения элемента `image`. */
+    fit?: ObjectFit;
     center?: boolean;
     innerTemplateStyle?: CSSProperties;
     withPadding?: boolean;

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

@@ -1,8 +1,30 @@
 import { CSSProperties } from 'react';
+import { CSSObject } from 'styled-components';
+import { CssSize } from '../types';
+/** Размер, при котором контейнер занимает всю ячейку родителя. */
+export declare const FILL_SIZE = "100%";
+export interface WrapperSizeParams {
+    /** Авторский `style` узла конфига — учитывается только ради приоритета `options` над `style`. */
+    style?: CSSProperties;
+    /** `options.width` контейнера. */
+    width?: CssSize;
+    /** `options.height` контейнера. */
+    height?: CssSize;
+    /** Внутренние дефолты обёртки контейнера: отступы, собственная высота и т.п. */
+    defaults?: CSSObject;
+    /** Ширина по умолчанию, если `options.width` не задан. Контейнеры передают `FILL_SIZE`, элементы — нет. */
+    defaultWidth?: CssSize;
+}
+export declare const isFillSize: (size?: CssSize) => boolean;
 /**
- * Мержит `width`/`height` из options контейнера в inline-style его корневой обёртки.
+ * CSS-объект корневой обёртки контейнера: внутренние дефолты плюс размеры из `options`.
  *
- * Значения размера из options имеют приоритет над одноимёнными полями `style`.
- * Поле добавляется только когда задано — иначе `style` остаётся нетронутым.
+ * Результат уходит в styled-проп, а не в inline-style, поэтому перебивается снаружи обычной
+ * специфичностью (`#id`, `[data-templatename]`) — без `!important`.
+ *
+ * Размер `"100%"` включает fill-режим: контейнер занимает ячейку целиком, для чего снимаются
+ * конфликтующие внутренние дефолты обёртки, а контент лишается возможности её распирать
+ * (`min-width`/`min-height: 0`). Для fill-высоты добавляется `flex: 1 1 auto` — в колонке
+ * контейнер забирает остаток ячейки под заголовком, а не переполняет её на его высоту.
  */
-export declare const getWrapperSizeStyle: (style?: CSSProperties, width?: number, height?: number) => CSSProperties;
+export declare const getWrapperSizeStyle: ({ style, width: widthOption, height, defaults, defaultWidth, }: WrapperSizeParams) => CSSObject | undefined;

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

@@ -61,6 +61,7 @@ export * from './removeDataSource';
 export * from './roundTotalSum';
 export * from './updateDataSource';
 export * from './sliceShownOtherItems';
+export * from './toCssSize';
 export * from './toRenderableValue';
 export * from './tooltipNameFromAttributes';
 export * from './tooltipValueFromAttributes';

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

@@ -0,0 +1,14 @@
+import { CssSize } from '../types';
+/**
+ * Приводит размер из конфига к CSS-значению: число — пиксели, строка — как есть.
+ *
+ * Нужен там, где значение подставляется в CSS-строку (`width: ${...}`), — в отличие от
+ * inline-style и css-объекта styled-components, которые добавляют `px` к числам сами.
+ */
+export declare const toCssSize: (size?: CssSize) => string | undefined;
+/**
+ * Пиксельное число из размера конфига — для API, которым нужен именно `number`
+ * (геометрия графиков). Относительные значения (`"100%"`, `"10rem"`) числом не выражаются
+ * и возвращают `undefined`, чтобы вызывающий код взял свой дефолт.
+ */
+export declare const toPxNumber: (size?: CssSize) => number | undefined;