@gravity-ui/charts 0.1.0

package/dist/esm/hooks/useSplit/index.js

@@ -0,0 +1,57 @@
+import get from 'lodash/get';
+import { calculateNumericProperty, getHorisontalSvgTextHeight } from '../../utils';
+const DEFAULT_TITLE_FONT_SIZE = '15px';
+const TITLE_TOP_BOTTOM_PADDING = 8;
+function preparePlotTitle(args) {
+    const { title, plotIndex, plotHeight, chartWidth, gap } = args;
+    const titleText = (title === null || title === void 0 ? void 0 : title.text) || '';
+    const titleStyle = {
+        fontSize: get(title, 'style.fontSize', DEFAULT_TITLE_FONT_SIZE),
+        fontWeight: get(title, 'style.fontWeight'),
+    };
+    const titleHeight = titleText
+        ? getHorisontalSvgTextHeight({ text: titleText, style: titleStyle }) +
+            TITLE_TOP_BOTTOM_PADDING * 2
+        : 0;
+    const top = plotIndex * (plotHeight + gap);
+    return {
+        text: titleText,
+        x: chartWidth / 2,
+        y: top + titleHeight / 2,
+        style: titleStyle,
+        height: titleHeight,
+    };
+}
+export function getPlotHeight(args) {
+    const { split, boundsHeight, gap } = args;
+    const plots = (split === null || split === void 0 ? void 0 : split.plots) || [];
+    if (plots.length > 1) {
+        return (boundsHeight - gap * (plots.length - 1)) / plots.length;
+    }
+    return boundsHeight;
+}
+export const useSplit = (args) => {
+    var _a;
+    const { split, boundsHeight, chartWidth } = args;
+    const splitGap = (_a = calculateNumericProperty({ value: split === null || split === void 0 ? void 0 : split.gap, base: boundsHeight })) !== null && _a !== void 0 ? _a : 0;
+    const plotHeight = getPlotHeight({ split: split, boundsHeight, gap: splitGap });
+    const plots = (split === null || split === void 0 ? void 0 : split.plots) || [];
+    return {
+        plots: plots.map((p, index) => {
+            const title = preparePlotTitle({
+                title: p.title,
+                plotIndex: index,
+                gap: splitGap,
+                plotHeight,
+                chartWidth,
+            });
+            const top = index * (plotHeight + splitGap);
+            return {
+                top: top + title.height,
+                height: plotHeight - title.height,
+                title,
+            };
+        }),
+        gap: splitGap,
+    };
+};

package/dist/esm/hooks/useSplit/types.d.ts

@@ -0,0 +1,17 @@
+import type { BaseTextStyle } from '../../types';
+export type PreparedSplit = {
+    plots: PreparedPlot[];
+    gap: number;
+};
+export type PreparedPlot = {
+    title: PreparedPlotTitle;
+    top: number;
+    height: number;
+};
+export type PreparedPlotTitle = {
+    x: number;
+    y: number;
+    text: string;
+    style?: Partial<BaseTextStyle>;
+    height: number;
+};

package/dist/esm/hooks/useSplit/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/hooks/useTooltip/index.d.ts

@@ -0,0 +1,13 @@
+import type { Dispatch } from 'd3';
+import type { TooltipDataChunk } from '../../types';
+import type { PreparedTooltip } from '../useChartOptions/types';
+import type { PointerPosition } from './types';
+type Args = {
+    dispatcher: Dispatch<object>;
+    tooltip: PreparedTooltip;
+};
+export declare const useTooltip: ({ dispatcher, tooltip }: Args) => {
+    hovered: TooltipDataChunk[] | undefined;
+    pointerPosition: PointerPosition | undefined;
+};
+export {};

package/dist/esm/hooks/useTooltip/index.js

@@ -0,0 +1,17 @@
+import React from 'react';
+export const useTooltip = ({ dispatcher, tooltip }) => {
+    const [{ hovered, pointerPosition }, setTooltipState] = React.useState({});
+    React.useEffect(() => {
+        if (tooltip === null || tooltip === void 0 ? void 0 : tooltip.enabled) {
+            dispatcher.on('hover-shape.tooltip', (nextHovered, nextPointerPosition) => {
+                setTooltipState({ hovered: nextHovered, pointerPosition: nextPointerPosition });
+            });
+        }
+        return () => {
+            if (tooltip === null || tooltip === void 0 ? void 0 : tooltip.enabled) {
+                dispatcher.on('hover-shape.tooltip', null);
+            }
+        };
+    }, [dispatcher, tooltip]);
+    return { hovered, pointerPosition };
+};

package/dist/esm/hooks/useTooltip/types.d.ts

@@ -0,0 +1 @@
+export type PointerPosition = [number, number];

package/dist/esm/hooks/useTooltip/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/i18n/index.d.ts

@@ -0,0 +1,8 @@
+import type { I18NFn } from '@gravity-ui/i18n';
+import { I18N } from '@gravity-ui/i18n';
+import en from './keysets/en.json';
+type Keysets = typeof en;
+type TypedI18n = I18NFn<Keysets>;
+declare const i18nFactory: I18N;
+declare const i18n: TypedI18n;
+export { i18nFactory, i18n };

package/dist/esm/i18n/index.js

@@ -0,0 +1,10 @@
+import { I18N } from '@gravity-ui/i18n';
+import en from './keysets/en.json';
+import ru from './keysets/ru.json';
+const i18nFactory = new I18N();
+i18nFactory.registerKeysets('en', en);
+i18nFactory.registerKeysets('ru', ru);
+i18nFactory.setLang('en');
+i18nFactory.setFallbackLang('en');
+const i18n = i18nFactory.i18n.bind(i18nFactory);
+export { i18nFactory, i18n };

package/dist/esm/index.d.ts

@@ -0,0 +1,2 @@
+export * from './components';
+export type { ChartData } from './types';

package/dist/esm/index.js

@@ -0,0 +1 @@
+export * from './components';

package/dist/esm/libs/chart-error/index.d.ts

@@ -0,0 +1,16 @@
+export type ChartErrorArgs = {
+    code?: number | string;
+    originalError?: Error;
+    message?: string;
+};
+export declare const CHART_ERROR_CODE: {
+    NO_DATA: string;
+    INVALID_DATA: string;
+    UNKNOWN: string;
+};
+export declare class ChartError extends Error {
+    readonly code: number | string;
+    readonly isChartError = true;
+    constructor({ originalError, message, code }?: ChartErrorArgs);
+}
+export declare const isChartError: (error: unknown) => error is ChartError;

package/dist/esm/libs/chart-error/index.js

@@ -0,0 +1,19 @@
+export const CHART_ERROR_CODE = {
+    NO_DATA: 'NO_DATA',
+    INVALID_DATA: 'INVALID_DATA',
+    UNKNOWN: 'UNKNOWN_ERROR',
+};
+export class ChartError extends Error {
+    constructor({ originalError, message, code = CHART_ERROR_CODE.UNKNOWN } = {}) {
+        super(message);
+        this.isChartError = true;
+        this.code = code;
+        if (originalError) {
+            this.name = originalError.name;
+            this.stack = originalError.stack;
+        }
+    }
+}
+export const isChartError = (error) => {
+    return error instanceof Error && 'isChartError' in error;
+};

package/dist/esm/libs/format-number/i18n/en.json

@@ -0,0 +1,17 @@
+{
+  "units": {
+    "value_short-bytes": "B",
+    "value_short-kilobytes": "KB",
+    "value_short-megabytes": "MB",
+    "value_short-milliseconds": "ms",
+    "value_short-seconds": "s",
+    "value_short-minutes": "m",
+    "value_short-empty": "",
+    "value_short-k": "K",
+    "value_short-m": "M",
+    "value_short-b": "B",
+    "value_short-t": "T",
+    "value_space-delimiter": " ",
+    "value_number-delimiter": ""
+  }
+}

package/dist/esm/libs/format-number/i18n/i18n.d.ts

@@ -0,0 +1,5 @@
+import { I18N } from '@gravity-ui/i18n';
+type KeysetData = Parameters<InstanceType<typeof I18N>['registerKeysets']>[1];
+declare const i18nInstance: I18N;
+declare const makeInstance: (keysetName: string, keysetsData: Record<string, KeysetData>) => (key: string, params?: import("@gravity-ui/i18n").Params | undefined) => string;
+export { i18nInstance, makeInstance };

package/dist/esm/libs/format-number/i18n/i18n.js

@@ -0,0 +1,8 @@
+import { I18N } from '@gravity-ui/i18n';
+const i18nInstance = new I18N();
+i18nInstance.setLang('ru');
+const makeInstance = (keysetName, keysetsData) => {
+    Object.entries(keysetsData).forEach(([key, value]) => i18nInstance.registerKeysets(key, value));
+    return i18nInstance.i18n.bind(i18nInstance, keysetName);
+};
+export { i18nInstance, makeInstance };

package/dist/esm/libs/format-number/i18n/ru.json

@@ -0,0 +1,17 @@
+{
+  "units": {
+    "value_short-bytes": "Б",
+    "value_short-kilobytes": "КБ",
+    "value_short-megabytes": "МБ",
+    "value_short-milliseconds": "мс",
+    "value_short-seconds": "с",
+    "value_short-minutes": "м",
+    "value_short-empty": "",
+    "value_short-k": "K",
+    "value_short-m": "M",
+    "value_short-b": "B",
+    "value_short-t": "T",
+    "value_space-delimiter": " ",
+    "value_number-delimiter": ""
+  }
+}

package/dist/esm/libs/format-number/index.d.ts

@@ -0,0 +1,5 @@
+import type { FormatNumberOptions, FormatOptions } from './types';
+export declare const formatBytes: (value: number, options?: FormatOptions) => string;
+export declare const formatDuration: (value: number, options?: FormatOptions) => string;
+export declare const getNumberUnitRate: (value: number) => number;
+export declare const formatNumber: (value: number | string, options?: FormatNumberOptions) => string;

package/dist/esm/libs/format-number/index.js

@@ -0,0 +1,87 @@
+import { i18nInstance, makeInstance } from './i18n/i18n';
+import en from './i18n/en.json';
+import ru from './i18n/ru.json';
+const i18n = makeInstance('units', { ru, en });
+function getUnitRate(value, exponent, unitsI18nKeys) {
+    let resultUnitRate = 1;
+    while (Math.abs(value / Math.pow(exponent, resultUnitRate)) >= 1 &&
+        resultUnitRate < 10 &&
+        i18n(unitsI18nKeys[resultUnitRate])) {
+        resultUnitRate++;
+    }
+    return resultUnitRate - 1;
+}
+const unitFormatter = ({ exponent, unitsI18nKeys, unitDelimiterI18nKey, }) => {
+    return function formatUnit(value, options = {}) {
+        const { precision, unitRate, showRankDelimiter = true, lang } = options;
+        const i18nLang = i18nInstance.lang;
+        if (lang) {
+            i18nInstance.setLang(lang);
+        }
+        const resultUnitRate = typeof unitRate === 'number' ? unitRate : getUnitRate(value, exponent, unitsI18nKeys);
+        let result = value / Math.pow(exponent, resultUnitRate);
+        if (typeof precision === 'number') {
+            result = Number(result.toFixed(precision));
+        }
+        else if (precision === 'auto' && result % 1 !== 0) {
+            result = Number(result.toFixed(Math.abs(result) > 1 ? 2 : 4));
+        }
+        result = new Intl.NumberFormat(lang !== null && lang !== void 0 ? lang : i18nLang, {
+            minimumFractionDigits: typeof precision === 'number' ? precision : 0,
+            maximumFractionDigits: 20,
+            useGrouping: showRankDelimiter,
+        }).format(result);
+        const unit = i18n(unitsI18nKeys[resultUnitRate]);
+        const delimiter = i18n(unitDelimiterI18nKey);
+        i18nInstance.setLang(i18nLang);
+        return `${result}${delimiter}${unit}`;
+    };
+};
+export const formatBytes = unitFormatter({
+    exponent: 1024,
+    unitDelimiterI18nKey: 'value_space-delimiter',
+    unitsI18nKeys: ['value_short-bytes', 'value_short-kilobytes', 'value_short-megabytes'],
+});
+export const formatDuration = unitFormatter({
+    exponent: 1000,
+    unitDelimiterI18nKey: 'value_space-delimiter',
+    unitsI18nKeys: ['value_short-milliseconds', 'value_short-seconds', 'value_short-minutes'],
+});
+const BASE_NUMBER_FORMAT_UNIT_KEYS = [
+    'value_short-empty',
+    'value_short-k',
+    'value_short-m',
+    'value_short-b',
+    'value_short-t',
+];
+const baseFormatNumber = unitFormatter({
+    exponent: 1000,
+    unitDelimiterI18nKey: 'value_number-delimiter',
+    unitsI18nKeys: BASE_NUMBER_FORMAT_UNIT_KEYS,
+});
+export const getNumberUnitRate = (value) => getUnitRate(value, 1000, BASE_NUMBER_FORMAT_UNIT_KEYS);
+const NUMBER_UNIT_RATE_BY_UNIT = {
+    default: 0,
+    auto: undefined,
+    k: 1,
+    m: 2,
+    b: 3,
+    t: 4,
+};
+export const formatNumber = (value, options = {}) => {
+    if (Number.isNaN(value) || Number.isNaN(Number(value))) {
+        return new Intl.NumberFormat('en').format(Number(value));
+    }
+    const { format = 'number', multiplier = 1, prefix = '', postfix = '', unit, unitRate, labelMode, } = options;
+    let changedMultiplier = multiplier;
+    let prePostfix = '';
+    if (format === 'percent') {
+        changedMultiplier = 100;
+        prePostfix = '%';
+    }
+    if (labelMode === 'percent') {
+        prePostfix = '%';
+    }
+    const formattedValue = baseFormatNumber(Number(value) * changedMultiplier, Object.assign(Object.assign({}, options), { unitRate: unitRate !== null && unitRate !== void 0 ? unitRate : NUMBER_UNIT_RATE_BY_UNIT[unit !== null && unit !== void 0 ? unit : 'default'] }));
+    return `${prefix}${formattedValue}${prePostfix}${postfix}`;
+};

package/dist/esm/libs/format-number/types.d.ts

@@ -0,0 +1,14 @@
+export type FormatOptions = {
+    precision?: number | 'auto';
+    unitRate?: number;
+    showRankDelimiter?: boolean;
+    lang?: string;
+    labelMode?: string;
+};
+export type FormatNumberOptions = FormatOptions & {
+    format?: 'number' | 'percent';
+    multiplier?: number;
+    prefix?: string;
+    postfix?: string;
+    unit?: 'auto' | 'k' | 'm' | 'b' | 't' | null;
+};

package/dist/esm/libs/format-number/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/libs/index.d.ts

@@ -0,0 +1,2 @@
+export * from './chart-error';
+export * from './format-number';

package/dist/esm/libs/index.js

@@ -0,0 +1,2 @@
+export * from './chart-error';
+export * from './format-number';

package/dist/esm/types/chart/area.d.ts

@@ -0,0 +1,76 @@
+import type { SeriesType } from '../../constants';
+import type { MeaningfulAny } from '../misc';
+import type { BaseSeries, BaseSeriesData } from './base';
+import type { ChartLegend, RectLegendSymbolOptions } from './legend';
+import type { PointMarkerOptions } from './marker';
+export type AreaSeriesData<T = MeaningfulAny> = BaseSeriesData<T> & {
+    /**
+     * The `x` value of the point. Depending on the context , it may represents:
+     * - numeric value (for `linear` x axis)
+     * - timestamp value (for `datetime` x axis)
+     * - x axis category value (for `category` x axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `xAxis.categories`
+     */
+    x?: string | number;
+    /**
+     * The `y` value of the point. Depending on the context , it may represents:
+     * - numeric value (for `linear` y axis)
+     * - timestamp value (for `datetime` y axis)
+     * - y axis category value (for `category` y axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `yAxis[0].categories`
+     */
+    y?: string | number;
+    /** Data label value of the point. If not specified, the y value is used. */
+    label?: string | number;
+    /** Individual marker options for the point. */
+    marker?: {
+        /** States for a single point marker. */
+        states?: {
+            /** The normal state of a single point marker. */
+            normal?: {
+                /**
+                 * Enable or disable the point marker.
+                 *
+                 * @default false
+                 * */
+                enabled: boolean;
+            };
+        };
+    };
+};
+export type AreaMarkerSymbol = 'circle' | 'square';
+export type AreaMarkerOptions = PointMarkerOptions & {
+    symbol?: AreaMarkerSymbol;
+};
+export type AreaSeries<T = MeaningfulAny> = BaseSeries & {
+    type: typeof SeriesType.Area;
+    data: AreaSeriesData<T>[];
+    /** The name of the series (used in legend, tooltip etc) */
+    name: string;
+    /** Whether to stack the values of each series on top of each other.
+     * Possible values are undefined to disable, "normal" to stack by value or "percent"
+     *
+     * @default undefined
+     * */
+    stacking?: 'normal' | 'percent';
+    /** This option allows grouping series in a stacked chart */
+    stackId?: string;
+    /** The main color of the series (hex, rgba) */
+    color?: string;
+    /** Fill opacity for the area
+     *
+     * @default 0.75
+     * */
+    opacity?: number;
+    /** Pixel width of the graph line.
+     *
+     * @default 1
+     * */
+    lineWidth?: number;
+    /** Individual series legend options. Has higher priority than legend options in widget data */
+    legend?: ChartLegend & {
+        symbol?: RectLegendSymbolOptions;
+    };
+    /** Options for the point markers of line in area series */
+    marker?: AreaMarkerOptions;
+    /** Y-axis index (when using two axes) */
+    yAxis?: number;
+};

package/dist/esm/types/chart/area.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/chart/axis.d.ts

@@ -0,0 +1,85 @@
+import type { FormatNumberOptions } from '../formatter';
+import type { BaseTextStyle } from './base';
+export type ChartAxisType = 'category' | 'datetime' | 'linear' | 'logarithmic';
+export type ChartAxisTitleAlignment = 'left' | 'center' | 'right';
+export type ChartAxisLabels = {
+    /** Enable or disable the axis labels. */
+    enabled?: boolean;
+    /** The label's pixel distance from the perimeter of the plot area.
+     *
+     * @default: 10
+     */
+    margin?: number;
+    /** The pixel padding for axis labels, to ensure white space between them.
+     *
+     * @defaults: 5
+     * */
+    padding?: number;
+    dateFormat?: string;
+    numberFormat?: FormatNumberOptions;
+    style?: Partial<BaseTextStyle>;
+    /** For horizontal axes, enable label rotation to prevent overlapping labels.
+     * If there is enough space, labels are not rotated.
+     * As the chart gets narrower, it will start rotating the labels -45 degrees. */
+    autoRotation?: boolean;
+    /** Rotation of the labels in degrees.
+     *
+     * @default: 0
+     */
+    rotation?: number;
+};
+export type ChartAxis = {
+    categories?: string[];
+    timestamps?: number[];
+    type?: ChartAxisType;
+    /** The axis labels show the number or category for each tick. */
+    labels?: ChartAxisLabels;
+    /** The color of the line marking the axis itself. */
+    lineColor?: string;
+    title?: {
+        text?: string;
+        /** CSS styles for the title */
+        style?: Partial<BaseTextStyle>;
+        /** The pixel distance between the axis labels or line and the title.
+         *
+         * Defaults to 4 for horizontal axes, 8 for vertical.
+         * */
+        margin?: number;
+        /** Alignment of the title. */
+        align?: ChartAxisTitleAlignment;
+        /** Allows limiting of the contents of a title block to the specified number of lines.
+         *  Defaults to 1. */
+        maxRowCount?: number;
+    };
+    /** The minimum value of the axis. If undefined the min value is automatically calculate. */
+    min?: number;
+    /** The grid lines settings. */
+    grid?: {
+        /** Enable or disable the grid lines.
+         *
+         * Defaults to true.
+         * */
+        enabled?: boolean;
+    };
+    ticks?: {
+        /** Pixel interval of the tick marks. Not applicable to categorized axis.
+         * The specified value is only a hint; the interval between ticks can be greater or less depending on the data. */
+        pixelInterval?: number;
+    };
+    /** Padding of the max value relative to the length of the axis.
+     * A padding of 0.05 will make a 100px axis 5px longer.
+     *
+     * Defaults to 0.05 for Y axis and to 0.01 for X axis.
+     * */
+    maxPadding?: number;
+};
+export type ChartXAxis = ChartAxis;
+export type ChartYAxis = ChartAxis & {
+    /** Axis location.
+     * Possible values - 'left' and 'right'.
+     * */
+    position?: 'left' | 'right';
+    /** Property for splitting charts. Determines which area the axis is located in.
+     * */
+    plotIndex?: number;
+};

package/dist/esm/types/chart/axis.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/chart/bar-x.d.ts

@@ -0,0 +1,67 @@
+import type { SeriesType } from '../../constants';
+import type { MeaningfulAny } from '../misc';
+import type { BaseSeries, BaseSeriesData } from './base';
+import type { ChartLegend, RectLegendSymbolOptions } from './legend';
+import type { ChartSeriesOptions } from './series';
+export type BarXSeriesData<T = MeaningfulAny> = BaseSeriesData<T> & {
+    /**
+     * The `x` value of the bar. Depending on the context , it may represents:
+     * - numeric value (for `linear` x axis)
+     * - timestamp value (for `datetime` x axis)
+     * - x axis category value (for `category` x axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `xAxis.categories`
+     */
+    x?: string | number;
+    /**
+     * The `y` value of the bar. Depending on the context , it may represents:
+     * - numeric value (for `linear` y axis)
+     * - timestamp value (for `datetime` y axis)
+     * - y axis category value (for `category` y axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `yAxis[0].categories`
+     */
+    y?: string | number;
+    /**
+     * Corresponding value of axis category.
+     *
+     * @deprecated use `x` or `y` instead
+     */
+    category?: string;
+    /** Data label value of the bar-x column. If not specified, the y value is used. */
+    label?: string | number;
+    /** Individual opacity for the bar-x column. */
+    opacity?: number;
+};
+export type BarXSeries<T = MeaningfulAny> = BaseSeries & {
+    type: typeof SeriesType.BarX;
+    data: BarXSeriesData<T>[];
+    /** The name of the series (used in legend, tooltip etc) */
+    name: string;
+    /** The main color of the series (hex, rgba) */
+    color?: string;
+    /** Whether to stack the values of each series on top of each other.
+     * Possible values are undefined to disable, "normal" to stack by value or "percent"
+     *
+     * @default undefined
+     * */
+    stacking?: 'normal' | 'percent';
+    /** This option allows grouping series in a stacked chart */
+    stackId?: string;
+    /** Whether to group non-stacked columns or to let them render independent of each other.
+     * When false columns will be laid out individually and overlap each other.
+     *
+     * @default true
+     * */
+    grouping?: boolean;
+    dataLabels?: BaseSeries['dataLabels'] & ChartSeriesOptions['dataLabels'] & {
+        /**
+         * Whether to align the data label inside or outside the box
+         *
+         * @default false
+         * */
+        inside?: boolean;
+    };
+    /** Individual series legend options. Has higher priority than legend options in widget data */
+    legend?: ChartLegend & {
+        symbol?: RectLegendSymbolOptions;
+    };
+    /** Y-axis index (when using two axes) */
+    yAxis?: number;
+};

package/dist/esm/types/chart/bar-x.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/chart/bar-y.d.ts

@@ -0,0 +1,60 @@
+import type { SeriesType } from '../../constants';
+import type { MeaningfulAny } from '../misc';
+import type { BaseSeries, BaseSeriesData } from './base';
+import type { ChartLegend, RectLegendSymbolOptions } from './legend';
+import type { ChartSeriesOptions } from './series';
+export type BarYSeriesData<T = MeaningfulAny> = BaseSeriesData<T> & {
+    /**
+     * The `x` value of the bar. Depending on the context , it may represents:
+     * - numeric value (for `linear` x axis)
+     * - timestamp value (for `datetime` x axis)
+     * - x axis category value (for `category` x axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `xAxis.categories`
+     */
+    x?: string | number;
+    /**
+     * The `y` value of the bar. Depending on the context , it may represents:
+     * - numeric value (for `linear` y axis)
+     * - timestamp value (for `datetime` y axis)
+     * - y axis category value (for `category` y axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `yAxis[0].categories`
+     */
+    y?: string | number;
+    /** Data label value of the bar. If not specified, the x value is used. */
+    label?: string | number;
+    /** Individual opacity for the bar. */
+    opacity?: number;
+};
+export type BarYSeries<T = MeaningfulAny> = BaseSeries & {
+    type: typeof SeriesType.BarY;
+    data: BarYSeriesData<T>[];
+    /** The name of the series (used in legend, tooltip etc) */
+    name: string;
+    /** The main color of the series (hex, rgba) */
+    color?: string;
+    /** Whether to stack the values of each series on top of each other.
+     * Possible values are undefined to disable, "normal" to stack by value or "percent"
+     *
+     * @default undefined
+     * */
+    stacking?: 'normal' | 'percent';
+    /** This option allows grouping series in a stacked chart */
+    stackId?: string;
+    /** Whether to group non-stacked columns or to let them render independent of each other.
+     * When false columns will be laid out individually and overlap each other.
+     *
+     * @default true
+     * */
+    grouping?: boolean;
+    dataLabels?: ChartSeriesOptions['dataLabels'] & {
+        /**
+         * Whether to align the data label inside or outside the box.
+         * For charts with a percentage stack, it is always true.
+         *
+         * @default false
+         * */
+        inside?: boolean;
+    };
+    /** Individual series legend options. Has higher priority than legend options in widget data */
+    legend?: ChartLegend & {
+        symbol?: RectLegendSymbolOptions;
+    };
+};

package/dist/esm/types/chart/bar-y.js

@@ -0,0 +1 @@
+export {};