@evergis/react 4.0.153 → 4.0.154

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

@@ -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" | "radius" | "padding" | "fontColor" | "angle" | "barWidth" | "cornerRadius" | "shownItems" | "otherItems"> & NumericSizeOptions;
+export type ElementChartOptions = Pick<ConfigOptions, "column" | "markers" | "showLabels" | "showMarkers" | "showTotal" | "totalWord" | "totalAttribute" | "expandable" | "expanded" | "chartType" | "relatedDataSources" | "defaultColor" | "dotSnapping" | "radius" | "padding" | "fontColor" | "angle" | "barWidth" | "cornerRadius" | "shownItems" | "otherItems" | "axis"> & NumericSizeOptions;
 export interface ElementChartConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "chart";
     options?: ElementChartOptions;
@@ -57,7 +57,7 @@ export interface ElementImageConfig extends Omit<ConfigContainerChild, "options"
 export interface ElementImageProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: ElementImageConfig;
 }
-export type ElementLegendOptions = Pick<ConfigOptions, "twoColumns" | "chartId" | "relatedDataSources" | "fontSize" | "chartType">;
+export type ElementLegendOptions = Pick<ConfigOptions, "twoColumns" | "chartId" | "relatedDataSources" | "fontSize" | "chartType" | "column">;
 export interface ElementLegendConfig extends Omit<ConfigContainerChild, "options" | "type"> {
     type?: "legend";
     options?: ElementLegendOptions;
@@ -169,7 +169,7 @@ export interface CameraContainerConfig extends Omit<ConfigContainerChild, "optio
 export interface CameraContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: CameraContainerConfig;
 }
-export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "fill"> & ContainerBoxOptions;
+export type ChartContainerOptions = Pick<ConfigOptions, "twoColumns" | "hideEmpty" | "fill" | "legendInline"> & ContainerBoxOptions;
 export interface ChartAliasChild extends Omit<ConfigContainerChild, "id"> {
     id: "alias";
 }

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

@@ -0,0 +1,24 @@
+/**
+ * Положение поля графика (области линий и сетки) внутри тела элемента `chart`, в пикселях.
+ *
+ * `left` / `right` — отступы поля от левого и правого краёв тела: колонка подписи оси плюс значения
+ * шкалы. `width` — ширина всего тела.
+ */
+export interface ChartPlotInsets {
+    left: number;
+    right: number;
+    width: number;
+}
+export interface ChartPlotContextValue {
+    /** Сообщает контейнеру фактическое положение поля после отрисовки графика. */
+    reportPlotInsets?: (insets: ChartPlotInsets) => void;
+}
+/**
+ * Контекст, через который элемент `chart` сообщает контейнеру, где лежит поле графика.
+ *
+ * По макету подпись оси X и легенда выравниваются по полю графика, а не по краям контейнера.
+ * Ширину шкал d3 вычисляет только при отрисовке, а подвал с подписью и легендой рисует
+ * `ChartContainer` — снаружи элемента. Без контейнера (элемент сам по себе) провайдера нет,
+ * и отчёт просто не отправляется.
+ */
+export declare const ChartPlotContext: import('react').Context<ChartPlotContextValue>;

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

@@ -0,0 +1,23 @@
+import { FC } from 'react';
+import { ChartAxisTitle } from '../../../hooks/useChartAxisTitles';
+import { ConfigAxisSide } from '../../../types';
+type AxisTitlesTopProps = {
+    left?: ChartAxisTitle;
+    right?: ChartAxisTitle;
+    /** Цвет подписи, если у стороны нет своего (несколько серий на стороне). */
+    neutralColor: string;
+};
+/** Горизонтальные подписи осей над телом графика: левая прижата влево, правая — вправо. */
+export declare const AxisTitlesTop: FC<AxisTitlesTopProps>;
+type AxisTitleSideSlotProps = {
+    side: ConfigAxisSide;
+    axisTitle?: ChartAxisTitle;
+    neutralColor: string;
+    /** Верхнее поле SVG — колонка повторяет его, чтобы подпись центрировалась по полю графика. */
+    plotTop: number;
+    /** Нижнее поле SVG вместе с полосой подписей оси X. */
+    plotBottom: number;
+};
+/** Вертикальная подпись оси сбоку от тела графика. Без подписи ничего не рендерит. */
+export declare const AxisTitleSideSlot: FC<AxisTitleSideSlotProps>;
+export {};

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

@@ -1,4 +1,37 @@
 import { CSSProperties } from 'react';
+import { ConfigAxisSide } from '../../types';
+/** Обёртка линейного графика: строка горизонтальных подписей над телом, вертикальные — по бокам. */
+export declare const LineChartLayout: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const LineChartRow: import('styled-components').StyledComponent<"div", any, {}, never>;
+/**
+ * Тело линейного графика между вертикальными подписями осей. Забирает всю оставшуюся ширину строки —
+ * её и измеряем, чтобы отдать d3 пиксельную ширину: подписи бывают в одну и в две строки.
+ */
+export declare const LineChartBody: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const AxisTitlesRow: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const AxisTitleTop: import('styled-components').StyledComponent<"div", any, {
+    $color?: string;
+}, never>;
+/**
+ * Колонка вертикальной подписи оси: ширина — по тексту (одна или две строки) плюс зазор до значений
+ * шкалы. Вертикальные отступы колонки повторяют поля SVG, поэтому подпись центрируется по полю
+ * графика, а не по всей высоте вместе с подписями оси X.
+ */
+export declare const AxisTitleSideColumn: import('styled-components').StyledComponent<"div", any, {
+    $side: ConfigAxisSide;
+    $plotTop: number;
+    $plotBottom: number;
+}, never>;
+/**
+ * Сам текст вертикальной подписи. Поворот вынесен на внутренний элемент: повёрнутая целиком колонка
+ * перенесла бы зазор до шкалы на внешнюю сторону. Левая подпись читается снизу вверх, правая — сверху
+ * вниз, как на макете.
+ */
+export declare const AxisTitleSide: import('styled-components').StyledComponent<"div", any, {
+    $color?: string;
+} & {
+    $side: ConfigAxisSide;
+}, never>;
 export declare const ChartTooltipTable: import('styled-components').StyledComponent<"table", any, {}, never>;
 export declare const ChartTooltip: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
 export declare const ChartTooltipLabel: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -5,6 +5,7 @@ export declare const ChartLegend: FC<{
     chartElement?: ConfigContainerChild;
     type: WidgetType;
     twoColumns: boolean;
+    column?: boolean;
     fontSize: string | number;
     loading: boolean;
 }>;

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

@@ -1,5 +1,6 @@
 export declare const ChartLegendContainer: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     twoColumns?: boolean;
+    $column?: boolean;
 }, never>;
 export declare const ChartLegendItem: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     isFiltered?: boolean;

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

@@ -1,7 +1,7 @@
 import { CSSProperties } from 'react';
 import { CSSObject } from 'styled-components';
 import { AttributeIconType, AttributeType, QueryLayerServiceInfoDc } from '@evergis/api';
-import { ConfigContainer, ConfigContainerChild, ConfigElementType } from './types';
+import { ConfigAxisAlign, ConfigContainer, ConfigContainerChild, ConfigElementType } from './types';
 export declare const CONFIG_PAGES_ID = "pages";
 export declare const CONFIG_PAGE_ID = "page";
 /**
@@ -38,6 +38,42 @@ export declare const MAX_CHART_WIDTH = 300;
 export declare const DEFAULT_CHART_ANGLE = 4;
 export declare const DEFAULT_CHART_HEIGHT = 90;
 export declare const STACK_BAR_TOTAL_HEIGHT = 20;
+/** Высота строки текста подписи оси (шрифт 10px) — по макету. */
+export declare const AXIS_TITLE_LINE_HEIGHT = 12;
+/** Зазор между подписью оси и значениями шкалы — по макету. */
+export declare const AXIS_TITLE_GAP = 4;
+/**
+ * Поле SVG графика под выступ крайних делений шкалы значений.
+ *
+ * d3 центрирует подпись деления на его линии (`dy: 0.32em`), поэтому у крайнего деления половина подписи
+ * выходит за поле графика. Если поле вплотную к краю SVG, половина оказывается за SVG, и её срезает
+ * обёртка: у линейного графика в fill — `ChartFillMeasure` (`overflow: hidden`), у барчарта всегда —
+ * `BarChartContainer` (`overflow-x: hidden`, отчего и по вертикали содержимое не `visible`).
+ */
+export declare const Y_AXIS_LABEL_OVERHANG = 6;
+/** Зазор от строки горизонтальных подписей осей до верхней линии сетки — по макету. */
+export declare const AXIS_TITLE_TOP_GRID_GAP = 9;
+/** Число делений шкал линейного графика; у левой и правой шкал оно общее, чтобы совпадала сетка. */
+export declare const LINE_CHART_Y_TICKS = 4;
+/**
+ * Высота строки горизонтальных подписей осей (`axis.titlePosition: "top"`). Вместе с верхним полем SVG
+ * (Y_AXIS_LABEL_OVERHANG) даёт строку текста и 9px до верхней линии сетки: деление центрировано на
+ * линии и выступает над ней на ~5px, так что между подписью и значением шкалы остаются те же 4px,
+ * что и у вертикальной подписи.
+ */
+export declare const AXIS_TITLE_TOP_HEIGHT: number;
+/**
+ * Пустая полоса под подписями оси X внутри SVG линейного графика: под ось зарезервировано
+ * LINE_CHART_LABEL_MARGIN (20px), а подписи сдвинуты вниз на +16px, поэтому строка подписи
+ * (шрифт d3 10px) кончается примерно в 14px от низа SVG.
+ */
+export declare const LINE_CHART_X_LABELS_BLANK = 14;
+/** Зазор между подписями оси X и подписью самой оси — по макету. */
+export declare const X_AXIS_TITLE_GAP = 4;
+/** Зазор между подписью оси X и легендой, идущей отдельной строкой, — по макету. */
+export declare const X_AXIS_TITLE_LEGEND_GAP = 8;
+/** Выравнивание подписи оси X → `justify-content` строки-подвала графика. */
+export declare const CHART_AXIS_ALIGN_JUSTIFY: Record<ConfigAxisAlign, CSSProperties["justifyContent"]>;
 export declare const FILTER_PREFIX = "%";
 /** Имя системного геометрического фильтра — выделение, нарисованное пользователем на карте. */
 export declare const GEOMETRY_FILTER_NAME = "geometry";

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

@@ -1,6 +1,6 @@
 import { BarChartData, PieChartData } from '@evergis/charts';
 import { QueryLayerServiceInfoDc } from '@evergis/api';
-import { ConfigContainerChild, ContainerProps, FilterItem } from '../../types';
+import { ConfigAxisSide, ConfigContainerChild, ContainerProps, FilterItem } from '../../types';
 export type ChartProps = Pick<ContainerProps, "config" | "elementConfig" | "type" | "renderElement"> & {
     element: ConfigContainerChild;
 };
@@ -11,4 +11,6 @@ export type ChartDataProps = {
     attributeUnits: string | null;
     dataSourceName: string | null;
     color: string | null;
+    /** Сторона шкалы, к которой привязана серия. */
+    axisSide: ConfigAxisSide;
 };

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

@@ -7,6 +7,7 @@ export declare const DEFAULT_BAR_CHART_HEIGHT = 100;
 export declare const BAR_CHART_HEADER_HEIGHT = 40;
 export declare const BAR_CHART_FOOTER_MARGIN = 16;
 export declare const LINE_CHART_LABEL_MARGIN = 20;
+export declare const LINE_CHART_X_AXIS_PADDING = 15;
 export declare const DEFAULT_BAR_CHART_MARGINS: {
     top: number;
     left: number;

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

@@ -1,3 +1,5 @@
+import { CSSProperties } from 'react';
+import { ChartPlotInsets } from '../components/Chart/ChartPlotContext';
 export declare const ContainerAlias: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
     hasBottomMargin?: boolean;
 }, never>;
@@ -6,6 +8,42 @@ export declare const ContainerChart: import('styled-components').StyledComponent
     $fill?: boolean;
 }, never>;
 export declare const ContainerLegend: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+/**
+ * Строка под телом графика: подпись оси X и, при `legendInline`, легенда справа от неё.
+ *
+ * `$offsetTop` подтягивает строку к подписям оси X: под ними внутри SVG остаётся пустая полоса,
+ * и без поправки зазор получился бы втрое больше макетного.
+ */
+export declare const ChartFooter: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+    $align?: CSSProperties["justifyContent"];
+    $insets?: ChartPlotInsets | null;
+    $offsetTop?: number;
+    $awaitingPlot?: boolean;
+}, never>;
+export declare const ChartXAxisTitle: import('styled-components').StyledComponent<"div", any, {
+    $color?: string;
+}, never>;
+/**
+ * Строка легенды под графиком. `$gapTop` заменяет отступ сверху, который легенде задаёт `ContainerValue`;
+ * `$offsetTop` сдвигает саму строку — подтягивает её к подписям оси X, как строку с подписью оси.
+ *
+ * `$justify` выравнивает сами записи. Выравнивание строки (`justifyContent`) до них не доходит: обёртки
+ * легенды — Flex из uilib-gl с `width: 100%`, а записи внутри легенда всегда центрирует.
+ */
+export declare const ChartLegendRow: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+    $insets?: ChartPlotInsets | null;
+    $gapTop?: number;
+    $offsetTop?: number;
+    $justify?: CSSProperties["justifyContent"];
+    $awaitingPlot?: boolean;
+}, never>;
+/**
+ * Колонка «график + подпись оси X» для легенды сбоку (`twoColumns`). Без неё подпись встала бы третьим
+ * элементом ряда рядом с легендой, а не под графиком.
+ */
+export declare const ChartWithFooter: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps & {
+    $fill?: boolean;
+}, 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;

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

@@ -9,6 +9,9 @@ export * from './useContainerRoot';
 export * from './useEditGroupAttributes';
 export * from './useFetchImageWithAuth';
 export * from './useFetchWithAuth';
+export * from './useChartAxisAttributes';
+export * from './useChartAxisTickFormat';
+export * from './useChartAxisTitles';
 export * from './useChartChange';
 export * from './useChartData';
 export * from './useConfigDataSources';

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

@@ -0,0 +1,19 @@
+import { ConfigDataSource, ConfigRelatedDataSource } from '../types';
+type UseChartAxisAttributesProps = {
+    dataSources: ConfigDataSource[];
+    relatedAttributes: ConfigRelatedDataSource[];
+};
+/**
+ * Оси значений линейного графика и атрибуты, по `stringFormat` которых форматируются деления.
+ *
+ * У левой и правой осей это разные атрибуты, поэтому они резолвятся по отдельности: иначе на
+ * правой оси окажутся единицы измерения левой.
+ */
+export declare const useChartAxisAttributes: ({ dataSources, relatedAttributes }: UseChartAxisAttributesProps) => {
+    axes: ConfigRelatedDataSource[];
+    strokeColors: string[];
+    leftAxisAttribute: import('@evergis/api').AttributeConfigurationDc;
+    rightAxisAttribute: import('@evergis/api').AttributeConfigurationDc;
+};
+export type ChartAxisAttribute = ReturnType<typeof useChartAxisAttributes>["leftAxisAttribute"];
+export {};

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

@@ -0,0 +1,18 @@
+import { ConfigDataSource, ConfigRelatedDataSource } from '../types';
+import * as d3 from "d3";
+type UseChartAxisTickFormatProps = {
+    dataSources: ConfigDataSource[];
+    relatedAttributes: ConfigRelatedDataSource[];
+};
+/**
+ * Форматтеры делений левой и правой шкал линейного графика — по `stringFormat` своего атрибута.
+ *
+ * Отдаются в `tickFormat` генератора оси, а не подменяют текст после отрисовки: d3 измеряет ширину
+ * шкалы по уже нарисованным подписям и по ней сдвигает поле графика. Подмена текста задним числом
+ * (`30` → `30,0`) делала подпись шире замера, и она заезжала на подпись оси слева.
+ */
+export declare const useChartAxisTickFormat: ({ dataSources, relatedAttributes }: UseChartAxisTickFormatProps) => {
+    formatLeftTick: (value: d3.NumberValue) => string;
+    formatRightTick: (value: d3.NumberValue) => string;
+};
+export {};

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

@@ -0,0 +1,32 @@
+import { ConfigOptions, ConfigRelatedDataSource } from '../types';
+type UseChartAxisTitlesProps = {
+    options?: ConfigOptions;
+    axes: ConfigRelatedDataSource[];
+    isLineChart: boolean;
+};
+/** Подпись оси одной стороны графика. */
+export type ChartAxisTitle = {
+    title: string;
+    /** Цвет серии, если она на стороне одна; иначе не задан — подпись берёт нейтральный цвет шкалы. */
+    color?: string;
+};
+/**
+ * Подписи осей линейного графика и место, которое они занимают над телом графика.
+ *
+ * Режим размещения общий для всех осей (`options.axis.titlePosition`), текст — у каждой оси свой.
+ * Цвет подписи отдельной опцией не задаётся: одна серия на стороне — подпись в её цвет, несколько —
+ * нейтральная, потому что тогда подпись описывает всю ось, а не одну из линий. Ширину вертикальных
+ * подписей здесь не считаем — она зависит от числа строк текста и измеряется по факту.
+ */
+export declare const useChartAxisTitles: ({ options, axes, isLineChart }: UseChartAxisTitlesProps) => {
+    axisTitles: {
+        left: ChartAxisTitle;
+        right: ChartAxisTitle;
+    };
+    hasTopTitles: boolean;
+    hasSideTitles: boolean;
+    axisTitlesHeight: number;
+    hideLeftAxis: boolean;
+    hideRightAxis: boolean;
+};
+export {};

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

@@ -71,17 +71,54 @@ export interface ConfigRelatedAttribute {
     attributeTitle?: string;
     condition?: string;
 }
+/** Роль источника: ось категорий или ось значений. */
+export type ConfigAxisType = "x" | "y";
+/** Сторона, на которой выводятся значения оси. */
+export type ConfigAxisSide = "left" | "right";
+/**
+ * Настройки оси и привязанной к ней серии.
+ *
+ * Заменяет прежние плоские поля `chartAxis` / `axisColor` / `hideAxis`
+ * у `ConfigRelatedDataSource`.
+ */
+export interface ConfigAxis {
+    /** Роль источника. По умолчанию `"y"`. */
+    type?: ConfigAxisType;
+    /** Сторона вывода значений; серия строится по шкале этой стороны. По умолчанию `"left"`. */
+    side?: ConfigAxisSide;
+    /** Цвет линии, заливки и метки в легенде. */
+    color?: string;
+    /**
+     * Подпись оси. Пусто — подписи нет.
+     *
+     * Цвет подписи отдельно не задаётся: если на стороне одна серия, подпись берёт её `color`,
+     * если несколько — нейтральный `options.fontColor` (подпись описывает ось, а не одну из линий).
+     */
+    title?: string;
+    /** Скрыть ось целиком. */
+    hide?: boolean;
+}
 export interface ConfigRelatedDataSource {
     dataSourceName: string;
     attributeName: string;
     attributeTitle: string;
     attributeUnits?: string;
     attributeColor?: string;
+    /** Имя серии в легенде. К оси не относится, поэтому лежит снаружи `axis`. */
     alias?: string;
+    filterName?: string;
+    axis?: ConfigAxis;
+    /**
+     * @deprecated Устаревшая плоская форма настроек оси — используйте `axis`.
+     *
+     * Поля читаются только слоем совместимости (`resolveAxis`) ради конфигов, созданных до
+     * переезда на `axis`, и не должны появляться в новом коде. Заданный `axis` имеет приоритет.
+     */
     chartAxis?: string;
+    /** @deprecated Используйте `axis.color`. */
     axisColor?: string;
+    /** @deprecated Используйте `axis.hide`. */
     hideAxis?: boolean;
-    filterName?: string;
 }
 export interface ConfigRelatedResource {
     resourceId: string;
@@ -258,6 +295,11 @@ export interface ConfigLayoutOptions {
      */
     autoHeight?: boolean;
     twoColumns?: boolean;
+    /**
+     * ChartContainer: легенда встаёт в одну строку справа от подписи оси X.
+     * Игнорируется при `twoColumns` (легенда справа) и при отсутствии подписи оси X.
+     */
+    legendInline?: boolean;
     /** Вписать график контейнера Chart в контейнер: по ширине всегда, по высоте — при заданной высоте (object-fit: contain). */
     fill?: boolean;
     /**
@@ -340,6 +382,20 @@ export interface ConfigDataSourceBindingOptions {
     hideIfEmptyDataSource?: string;
 }
 /** Опции графика. */
+/** Выравнивание подписи оси X. */
+export type ConfigAxisAlign = "left" | "center" | "right";
+/** Режим размещения подписей осей Y — общий для всех осей графика. */
+export type ConfigAxisTitlePosition = "side" | "top";
+/** Общие настройки осей графика. Настройки конкретной оси — в `ConfigRelatedDataSource.axis`. */
+export interface ConfigChartAxisOptions {
+    /** `side` — вертикально снаружи от значений, `top` — горизонтально над осью. По умолчанию `"side"`. */
+    titlePosition?: ConfigAxisTitlePosition;
+    x?: {
+        title?: string;
+        /** По умолчанию `"center"`. */
+        align?: ConfigAxisAlign;
+    };
+}
 export interface ConfigChartOptions {
     chartType?: ChartType;
     /** ⚠️ entity-ref: ссылка на ChartContainer по id. */
@@ -353,6 +409,8 @@ export interface ConfigChartOptions {
     dotSnapping?: boolean;
     drawMinMax?: boolean;
     angle?: number;
+    /** Подписи осей и подпись оси X. Работает только у линейного графика. */
+    axis?: ConfigChartAxisOptions;
 }
 /** Иконки/изображения. */
 export interface ConfigVisualOptions {

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

@@ -0,0 +1,29 @@
+import { ConfigAxis, ConfigAxisSide, ConfigRelatedDataSource } from '../types';
+type AxisSource = Partial<ConfigRelatedDataSource>;
+/**
+ * Настройки оси источника.
+ *
+ * Читает `axis`, а при его отсутствии собирает объект из устаревших плоских полей
+ * `chartAxis` / `axisColor` / `hideAxis`. Заданный `axis` имеет приоритет: узел, который уже
+ * правили в редакторе, не должен откатываться к старым значениям.
+ */
+export declare const resolveAxis: (source?: AxisSource) => ConfigAxis;
+/**
+ * Источник питает ось значений.
+ *
+ * Отсутствие `axis.type` означает `"y"`: конфиг без явного типа — самый частый случай,
+ * и раньше такой источник молча выпадал из графика.
+ */
+export declare const isValueAxis: (source: AxisSource) => boolean;
+/** Сторона оси; отсутствие `axis.side` означает `"left"`. */
+export declare const getAxisSide: (source: AxisSource) => ConfigAxisSide;
+/** Источник выводится на правой оси. */
+export declare const isRightAxis: (source: AxisSource) => boolean;
+/**
+ * Запись описывает ось чарта, а не источник фильтра.
+ *
+ * `BarChartFilter` собирает `relatedConfig` вручную и осей не задаёт — ему нужна исходная палитра,
+ * а не растянутая под число элементов.
+ */
+export declare const hasAxisConfig: ({ axis, chartAxis }: AxisSource) => boolean;
+export {};

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

@@ -20,6 +20,7 @@ export * from './getAttributeIconElement';
 export * from './getAttributeIconUrl';
 export * from './getAttributesConfiguration';
 export * from './getAttributeValue';
+export * from './chartAxis';
 export * from './getChartAxes';
 export * from './getChartFilterName';
 export * from './getChartMarkers';