@gravity-ui/charts 1.45.0 → 1.46.1

package/dist/cjs/core/shapes/utils.js

@@ -0,0 +1,138 @@
+import { path } from 'd3-path';
+import { select } from 'd3-selection';
+import get from 'lodash/get';
+import { getDataCategoryValue } from '../utils';
+const ONE_POINT_DOMAIN_DATA_CAPACITY = 3;
+export function getXValue(args) {
+    const { point, points, xAxis, xScale } = args;
+    if (xAxis.type === 'category') {
+        const xBandScale = xScale;
+        const categories = get(xAxis, 'categories', []);
+        const dataCategory = getDataCategoryValue({ axisDirection: 'x', categories, data: point });
+        return (xBandScale(dataCategory) || 0) + xBandScale.step() / 2;
+    }
+    let xLinearScale = xScale;
+    const [xMinDomain, xMaxDomain] = xLinearScale.domain();
+    if (Number(xMinDomain) === Number(xMaxDomain) &&
+        (points === null || points === void 0 ? void 0 : points.length) === ONE_POINT_DOMAIN_DATA_CAPACITY) {
+        const x1 = Number(points[0].x);
+        const xTarget = Number(points[1].x);
+        const x3 = Number(points[2].x);
+        if (!Number.isNaN(x1) && !Number.isNaN(xTarget) && !Number.isNaN(x3)) {
+            const xMin = Math.min(x1, xTarget, x3);
+            const xMax = Math.max(x1, xTarget, x3);
+            xLinearScale = xLinearScale
+                .copy()
+                .domain([xMin + (xTarget - xMin) / 2, xMax - (xMax - xTarget) / 2]);
+        }
+    }
+    return point.x === null ? null : xLinearScale(point.x);
+}
+export function getYValue(args) {
+    const { point, points, yAxis, yScale } = args;
+    if (yAxis.type === 'category') {
+        const yBandScale = yScale;
+        const categories = get(yAxis, 'categories', []);
+        const dataCategory = getDataCategoryValue({ axisDirection: 'y', categories, data: point });
+        return (yBandScale(dataCategory) || 0) + yBandScale.step() / 2;
+    }
+    let yLinearScale = yScale;
+    const [yMinDomain, yMaxDomain] = yLinearScale.domain();
+    if (Number(yMinDomain) === Number(yMaxDomain) &&
+        (points === null || points === void 0 ? void 0 : points.length) === ONE_POINT_DOMAIN_DATA_CAPACITY) {
+        const y1 = Number(points[0].y);
+        const yTarget = Number(points[1].y);
+        const y3 = Number(points[2].y);
+        if (!Number.isNaN(y1) && !Number.isNaN(yTarget) && !Number.isNaN(y3)) {
+            const yMin = Math.min(y1, yTarget, y3);
+            const yMax = Math.max(y1, yTarget, y3);
+            yLinearScale = yLinearScale
+                .copy()
+                .domain([yMin + (yTarget - yMin) / 2, yMax - (yMax - yTarget) / 2]);
+        }
+    }
+    return point.y === null ? null : yLinearScale(point.y);
+}
+export function shapeKey(d) {
+    return d.id || -1;
+}
+export function setActiveState(args) {
+    const { element, datum, state, active } = args;
+    const elementSelection = select(element);
+    if (datum.active !== active) {
+        datum.active = active;
+        const opacity = datum.active ? null : state === null || state === void 0 ? void 0 : state.opacity;
+        elementSelection.attr('opacity', opacity || null);
+    }
+    return datum;
+}
+export function getRectPath(args) {
+    const { x, y, width, height, borderRadius = 0 } = args;
+    const borderRadiuses = typeof borderRadius === 'number' ? new Array(4).fill(borderRadius) : borderRadius;
+    const [borderRadiusTopLeft = 0, borderRadiusTopRight = 0, borderRadiusBottomRight = 0, borderRadiusBottomLeft = 0,] = borderRadiuses !== null && borderRadiuses !== void 0 ? borderRadiuses : [];
+    const p = path();
+    let startAngle = -Math.PI / 2;
+    const angle = Math.PI / 2;
+    p.moveTo(x + borderRadiusTopLeft, y);
+    p.lineTo(x + width - borderRadiusTopRight, y);
+    p.arc(x + width - borderRadiusTopRight, y + borderRadiusTopRight, borderRadiusTopRight, startAngle, startAngle + angle);
+    startAngle += angle;
+    p.lineTo(x + width, y + height - borderRadiusBottomRight);
+    p.arc(x + width - borderRadiusBottomRight, y + height - borderRadiusBottomRight, borderRadiusBottomRight, startAngle, startAngle + angle);
+    startAngle += angle;
+    p.lineTo(x + borderRadiusBottomLeft, y + height);
+    p.arc(x + borderRadiusBottomLeft, y + height - borderRadiusBottomLeft, borderRadiusBottomLeft, startAngle, startAngle + angle);
+    startAngle += angle;
+    p.lineTo(x, y + borderRadiusTopLeft);
+    p.arc(x + borderRadiusTopLeft, y + borderRadiusTopLeft, borderRadiusTopLeft, startAngle, startAngle + angle);
+    p.closePath();
+    return p;
+}
+export function getRectBorderPath(args) {
+    const { x, y, width, height, borderWidth, borderRadius = 0 } = args;
+    if (!borderWidth) {
+        return '';
+    }
+    const halfWidth = borderWidth / 2;
+    const expandedWidth = width + borderWidth;
+    const expandedHeight = height + borderWidth;
+    const innerWidth = width - borderWidth;
+    const innerHeight = height - borderWidth;
+    const borderRadiuses = typeof borderRadius === 'number' ? new Array(4).fill(borderRadius) : borderRadius;
+    const [borderRadiusTopLeft = 0, borderRadiusTopRight = 0, borderRadiusBottomRight = 0, borderRadiusBottomLeft = 0,] = borderRadiuses !== null && borderRadiuses !== void 0 ? borderRadiuses : [];
+    const adjustOuterRadius = (radius) => (radius ? radius + halfWidth : 0);
+    const outerBorderRadius = [
+        adjustOuterRadius(borderRadiusTopLeft),
+        adjustOuterRadius(borderRadiusTopRight),
+        adjustOuterRadius(borderRadiusBottomRight),
+        adjustOuterRadius(borderRadiusBottomLeft),
+    ];
+    const outerPath = getRectPath({
+        x: x - halfWidth,
+        y: y - halfWidth,
+        width: expandedWidth,
+        height: expandedHeight,
+        borderRadius: outerBorderRadius,
+    }).toString();
+    if (innerWidth <= 0 || innerHeight <= 0) {
+        return outerPath;
+    }
+    const innerBorderRadius = [
+        Math.max(borderRadiusTopLeft - halfWidth, 0),
+        Math.max(borderRadiusTopRight - halfWidth, 0),
+        Math.max(borderRadiusBottomRight - halfWidth, 0),
+        Math.max(borderRadiusBottomLeft - halfWidth, 0),
+    ];
+    const innerPath = getRectPath({
+        x: x + halfWidth,
+        y: y + halfWidth,
+        width: innerWidth,
+        height: innerHeight,
+        borderRadius: innerBorderRadius,
+    }).toString();
+    return `${outerPath} ${innerPath}`;
+}
+export function getClipPathIdByBounds(args) {
+    const { bounds, clipPathId } = args;
+    return bounds ? `${clipPathId}-${bounds}` : clipPathId;
+}

package/dist/cjs/{hooks/useShapes → core/shapes}/waterfall/prepare-data.d.ts

@@ -1,6 +1,6 @@
-import type { ChartScale } from '../../../core/scales/types';
-import type { PreparedXAxis, PreparedYAxis } from '../../useAxis/types';
-import type { PreparedSeriesOptions, PreparedWaterfallSeries } from '../../useSeries/types';
+import type { PreparedXAxis, PreparedYAxis } from '../../axes/types';
+import type { ChartScale } from '../../scales/types';
+import type { PreparedSeriesOptions, PreparedWaterfallSeries } from '../../series/types';
 import type { PreparedWaterfallData } from './types';
 export declare const prepareWaterfallData: (args: {
     series: PreparedWaterfallSeries[];

package/dist/cjs/{hooks/useShapes → core/shapes}/waterfall/prepare-data.js

@@ -1,9 +1,9 @@
 import get from 'lodash/get';
 import sortBy from 'lodash/sortBy';
-import { getLabelsSize } from '../../../core/utils';
-import { getFormattedValue } from '../../../core/utils/format';
-import { MIN_BAR_GAP, MIN_BAR_WIDTH } from '../../constants';
-import { getXValue, getYValue } from '../utils';
+import { MIN_BAR_GAP, MIN_BAR_WIDTH } from '../../shapes/bar-constants';
+import { getXValue, getYValue } from '../../shapes/utils';
+import { getLabelsSize } from '../../utils';
+import { getFormattedValue } from '../../utils/format';
 async function getLabelData(d, plotHeight) {
     var _a, _b;
     if (!d.series.dataLabels.enabled) {

package/dist/cjs/core/shapes/waterfall/renderer.d.ts

@@ -0,0 +1,6 @@
+import type { Dispatch } from 'd3-dispatch';
+import type { PreparedSeriesOptions } from '../../series/types';
+import type { PreparedWaterfallData } from './types';
+export declare function renderWaterfall(elements: {
+    plot: SVGGElement;
+}, preparedData: PreparedWaterfallData[], seriesOptions: PreparedSeriesOptions, allowOverlapDataLabels: boolean, dispatcher?: Dispatch<object>): () => void;

package/dist/cjs/core/shapes/waterfall/renderer.js

@@ -0,0 +1,115 @@
+import { color } from 'd3-color';
+import { select } from 'd3-selection';
+import { line as lineGenerator } from 'd3-shape';
+import get from 'lodash/get';
+import { block } from '../../../utils';
+import { DASH_STYLE } from '../../constants';
+import { filterOverlappingLabels, getLineDashArray, getWaterfallPointColor } from '../../utils';
+const b = block('waterfall');
+export function renderWaterfall(elements, preparedData, seriesOptions, allowOverlapDataLabels, dispatcher) {
+    const svgElement = select(elements.plot);
+    const connectorSelector = `.${b('connector')}`;
+    const hoverOptions = get(seriesOptions, 'waterfall.states.hover');
+    const inactiveOptions = get(seriesOptions, 'waterfall.states.inactive');
+    svgElement.selectAll('*').remove();
+    const rectSelection = svgElement
+        .selectAll('allRects')
+        .data(preparedData)
+        .join('rect')
+        .attr('class', b('segment'))
+        .attr('x', (d) => d.x)
+        .attr('y', (d) => d.y)
+        .attr('height', (d) => d.height)
+        .attr('width', (d) => d.width)
+        .attr('fill', (d) => getWaterfallPointColor(d.data, d.series))
+        .attr('opacity', (d) => d.opacity)
+        .attr('cursor', (d) => d.series.cursor);
+    let dataLabels = preparedData.map((d) => d.label).filter(Boolean);
+    if (!allowOverlapDataLabels) {
+        dataLabels = filterOverlappingLabels(dataLabels);
+    }
+    const labelSelection = svgElement
+        .selectAll('text')
+        .data(dataLabels)
+        .join('text')
+        .html((d) => d.text)
+        .attr('class', b('label'))
+        .attr('x', (d) => d.x)
+        .attr('y', (d) => d.y)
+        .attr('text-anchor', (d) => d.textAnchor)
+        .style('font-size', (d) => d.style.fontSize)
+        .style('font-weight', (d) => d.style.fontWeight || null)
+        .style('fill', (d) => d.style.fontColor || null);
+    // Add the connector line between bars
+    svgElement
+        .selectAll(connectorSelector)
+        .data(preparedData)
+        .join('path')
+        .attr('class', b('connector'))
+        .attr('d', (d, index) => {
+        const line = lineGenerator();
+        const prev = preparedData[index - 1];
+        if (!prev) {
+            return null;
+        }
+        const points = [];
+        if (Number(prev.data.y) > 0) {
+            points.push([prev.x, prev.y]);
+        }
+        else {
+            points.push([prev.x, prev.y + prev.height]);
+        }
+        if (Number(d.data.y) > 0 && !d.data.total) {
+            points.push([d.x + d.width, d.y + d.height]);
+        }
+        else {
+            points.push([d.x + d.width, d.y]);
+        }
+        return line(points);
+    })
+        .attr('stroke-width', 1)
+        .attr('stroke-dasharray', () => getLineDashArray(DASH_STYLE.Dash, 1));
+    function handleShapeHover(data) {
+        const hoverEnabled = hoverOptions === null || hoverOptions === void 0 ? void 0 : hoverOptions.enabled;
+        const inactiveEnabled = inactiveOptions === null || inactiveOptions === void 0 ? void 0 : inactiveOptions.enabled;
+        if (!data) {
+            if (hoverEnabled) {
+                rectSelection.attr('fill', (d) => getWaterfallPointColor(d.data, d.series));
+            }
+            if (inactiveEnabled) {
+                rectSelection.attr('opacity', null);
+                labelSelection.attr('opacity', null);
+            }
+            return;
+        }
+        if (hoverEnabled) {
+            const hoveredValues = data.map((d) => d.data.x);
+            rectSelection.attr('fill', (d) => {
+                var _a;
+                const fillColor = getWaterfallPointColor(d.data, d.series);
+                if (hoveredValues.includes(d.data.x)) {
+                    const brightness = hoverOptions === null || hoverOptions === void 0 ? void 0 : hoverOptions.brightness;
+                    return ((_a = color(fillColor)) === null || _a === void 0 ? void 0 : _a.brighter(brightness).toString()) || fillColor;
+                }
+                return fillColor;
+            });
+        }
+        if (inactiveEnabled) {
+            const hoveredSeries = data.map((d) => d.series.id);
+            rectSelection.attr('opacity', (d) => {
+                return hoveredSeries.includes(d.series.id)
+                    ? null
+                    : (inactiveOptions === null || inactiveOptions === void 0 ? void 0 : inactiveOptions.opacity) || null;
+            });
+            labelSelection.attr('opacity', (d) => {
+                return hoveredSeries.includes(d.series.id)
+                    ? null
+                    : (inactiveOptions === null || inactiveOptions === void 0 ? void 0 : inactiveOptions.opacity) || null;
+            });
+        }
+    }
+    dispatcher === null || dispatcher === void 0 ? void 0 : dispatcher.on('hover-shape.waterfall', handleShapeHover);
+    return () => {
+        dispatcher === null || dispatcher === void 0 ? void 0 : dispatcher.on('hover-shape.waterfall', null);
+    };
+}

package/dist/{esm/hooks/useShapes → cjs/core/shapes}/waterfall/types.d.ts

@@ -1,5 +1,5 @@
 import type { HtmlItem, LabelData, WaterfallSeriesData } from '../../../types';
-import type { PreparedWaterfallSeries } from '../../useSeries/types';
+import type { PreparedWaterfallSeries } from '../../series/types';
 export type PreparedWaterfallData = {
     x: number;
     y: number;

package/dist/cjs/{hooks/useShapes → core/shapes}/x-range/prepare-data.d.ts

@@ -1,6 +1,6 @@
-import type { ChartScale } from '../../../core/scales/types';
-import type { PreparedXAxis, PreparedYAxis } from '../../useAxis/types';
-import type { PreparedXRangeSeries } from '../../useSeries/types';
+import type { PreparedXAxis, PreparedYAxis } from '../../axes/types';
+import type { ChartScale } from '../../scales/types';
+import type { PreparedXRangeSeries } from '../../series/types';
 import type { PreparedXRangeData } from './types';
 type PrepareXRangeDataArgs = {
     series: PreparedXRangeSeries[];

package/dist/cjs/{hooks/useShapes → core/shapes}/x-range/prepare-data.js

@@ -1,8 +1,8 @@
 import get from 'lodash/get';
-import { getDataCategoryValue, getLabelsSize, getTextSizeFn, getTextWithElipsis } from '../../../core/utils';
-import { getFormattedValue } from '../../../core/utils/format';
-import { MIN_BAR_WIDTH } from '../../constants';
-import { getBandSize } from '../../utils/get-band-size';
+import { MIN_BAR_WIDTH } from '../../shapes/bar-constants';
+import { getDataCategoryValue, getLabelsSize, getTextSizeFn, getTextWithElipsis } from '../../utils';
+import { getBandSize } from '../../utils/band-size';
+import { getFormattedValue } from '../../utils/format';
 const DEFAULT_BAR_PADDING = 0.2;
 export async function prepareXRangeData(args) {
     var _a;

package/dist/cjs/core/shapes/x-range/renderer.d.ts

@@ -0,0 +1,6 @@
+import type { Dispatch } from 'd3-dispatch';
+import type { PreparedSeriesOptions } from '../../series/types';
+import type { PreparedXRangeData } from './types';
+export declare function renderXRange(elements: {
+    plot: SVGGElement;
+}, preparedData: PreparedXRangeData[], seriesOptions: PreparedSeriesOptions, dispatcher?: Dispatch<object>): () => void;

package/dist/cjs/core/shapes/x-range/renderer.js

@@ -0,0 +1,94 @@
+import { color } from 'd3-color';
+import { select } from 'd3-selection';
+import get from 'lodash/get';
+import { block } from '../../../utils';
+import { getRectPath } from '../../shapes/utils';
+import { getLineDashArray } from '../../utils';
+const b = block('x-range');
+export function renderXRange(elements, preparedData, seriesOptions, dispatcher) {
+    const svgElement = select(elements.plot);
+    svgElement.selectAll('*').remove();
+    const segmentSelection = svgElement
+        .selectAll(`path.${b('segment')}`)
+        .data(preparedData)
+        .join('path')
+        .attr('d', (d) => {
+        const borderRadius = Math.min(d.height / 2, d.width / 2, d.series.borderRadius);
+        return getRectPath({
+            x: d.x,
+            y: d.y,
+            width: d.width,
+            height: d.height,
+            borderRadius,
+        }).toString();
+    })
+        .attr('class', b('segment'))
+        .attr('fill', (d) => d.color)
+        .attr('opacity', (d) => { var _a; return (_a = d.data.opacity) !== null && _a !== void 0 ? _a : d.series.opacity; })
+        .attr('cursor', (d) => d.series.cursor);
+    svgElement
+        .selectAll(`path.${b('segment-border')}`)
+        .data(preparedData.filter((d) => d.series.borderWidth > 0))
+        .join('path')
+        .attr('d', (d) => {
+        const borderRadius = Math.min(d.height / 2, d.width / 2, d.series.borderRadius);
+        return getRectPath({
+            x: d.x,
+            y: d.y,
+            width: d.width,
+            height: d.height,
+            borderRadius,
+        }).toString();
+    })
+        .attr('class', b('segment-border'))
+        .attr('fill', 'none')
+        .attr('stroke', (d) => d.series.borderColor)
+        .attr('stroke-width', (d) => d.series.borderWidth)
+        .attr('stroke-dasharray', (d) => getLineDashArray(d.series.borderDashStyle, d.series.borderWidth))
+        .attr('opacity', (d) => { var _a; return (_a = d.data.opacity) !== null && _a !== void 0 ? _a : d.series.opacity; })
+        .attr('pointer-events', 'none');
+    const svgLabels = preparedData.flatMap((d) => d.svgLabels);
+    svgElement
+        .selectAll(`text.${b('label')}`)
+        .data(svgLabels)
+        .join('text')
+        .attr('class', b('label'))
+        .attr('x', (d) => d.x)
+        .attr('y', (d) => d.y)
+        .attr('text-anchor', (d) => d.textAnchor)
+        .attr('dominant-baseline', 'central')
+        .attr('pointer-events', 'none')
+        .style('font-size', (d) => d.style.fontSize)
+        .style('font-weight', (d) => d.style.fontWeight || null)
+        .style('fill', (d) => d.style.fontColor || null)
+        .html((d) => d.text);
+    const hoverOptions = get(seriesOptions, 'x-range.states.hover');
+    const inactiveOptions = get(seriesOptions, 'x-range.states.inactive');
+    function handleShapeHover(data) {
+        if (hoverOptions === null || hoverOptions === void 0 ? void 0 : hoverOptions.enabled) {
+            const hoveredSet = new Set(data === null || data === void 0 ? void 0 : data.map((d) => d.data));
+            segmentSelection.attr('fill', (d) => {
+                var _a;
+                const fillColor = d.color;
+                if (hoveredSet.has(d.data)) {
+                    return (((_a = color(fillColor)) === null || _a === void 0 ? void 0 : _a.brighter(hoverOptions.brightness).toString()) || fillColor);
+                }
+                return fillColor;
+            });
+        }
+        if (inactiveOptions === null || inactiveOptions === void 0 ? void 0 : inactiveOptions.enabled) {
+            const hoveredSeries = data === null || data === void 0 ? void 0 : data.map((d) => d.series.id);
+            segmentSelection.attr('opacity', (d) => {
+                var _a, _b;
+                if ((hoveredSeries === null || hoveredSeries === void 0 ? void 0 : hoveredSeries.length) && !hoveredSeries.includes(d.series.id)) {
+                    return inactiveOptions.opacity || null;
+                }
+                return (_b = (_a = d.data.opacity) !== null && _a !== void 0 ? _a : d.series.opacity) !== null && _b !== void 0 ? _b : null;
+            });
+        }
+    }
+    dispatcher === null || dispatcher === void 0 ? void 0 : dispatcher.on('hover-shape.x-range', handleShapeHover);
+    return () => {
+        dispatcher === null || dispatcher === void 0 ? void 0 : dispatcher.on('hover-shape.x-range', null);
+    };
+}

package/dist/{esm/hooks/useShapes → cjs/core/shapes}/x-range/types.d.ts

@@ -1,5 +1,5 @@
 import type { HtmlItem, LabelData, TooltipDataChunkXRange } from '../../../types';
-import type { PreparedXRangeSeries } from '../../useSeries/types';
+import type { PreparedXRangeSeries } from '../../series/types';
 export type PreparedXRangeData = Omit<TooltipDataChunkXRange, 'series'> & {
     x: number;
     y: number;

package/dist/cjs/core/types/chart/area.d.ts

@@ -87,7 +87,6 @@ export interface AreaSeries<T = MeaningfulAny> extends BaseSeries {
      * - `'connect'`: Connect points across null values (skip nulls in rendering). **Not supported with `stacking`.**
      * - `'zero'`: Treat null values as zero
      * - `'skip'`: Omit the data point (creates gap in area)
-     *
      * @default 'skip'
      */
     nullMode?: 'connect' | 'zero' | 'skip';

package/dist/cjs/core/types/chart/axis.d.ts

@@ -298,7 +298,6 @@ export interface AxisPlotShape extends AxisPlot {
      * Called with the pixel coordinates of the shape and the plot area dimensions.
      * Must return a string of valid SVG markup that will be inserted inside a `<g>` container
      * positioned at the shape's axis value.
-     *
      * @example
      * ```
      * renderer: ({plotHeight}) =>

package/dist/cjs/core/types/chart/base.d.ts

@@ -19,17 +19,14 @@ export type CustomFormat = {
  * Specifies how a value should be formatted for display.
  *
  * - `{ type: 'number' }` — numeric formatting with optional precision, units, percent display, etc.
- *   See [FormatNumberOptions](https://gravity-ui.github.io/charts/pages/api/Utilities/interfaces/FormatNumberOptions.html) for all available options.
+ * See [FormatNumberOptions](https://gravity-ui.github.io/charts/pages/api/Utilities/interfaces/FormatNumberOptions.html) for all available options.
  * - `{ type: 'date' }` — date/time formatting
- *
  * @example
  * // Two decimal places, shown as percent
  * { type: 'number', precision: 2, format: 'percent' }
- *
  * @example
  * // Compact thousands: 1 500 000 → "1.5M"
  * { type: 'number', unit: 'auto', precision: 1 }
- *
  * @example
  * // Date value (Unix ms) formatted as "17 October 2025"
  * { type: 'date', format: 'DD MMMM YYYY' }

package/dist/cjs/core/types/chart/title.d.ts

@@ -5,6 +5,7 @@ export interface ChartTitle {
     /**
      * Maximum number of text rows. If the text exceeds this limit, it is truncated with an ellipsis.
      * Default: 1
+     * Not applicable when `html: true` — HTML content manages its own layout.
      */
     maxRowCount?: number;
     /**
@@ -17,4 +18,21 @@ export interface ChartTitle {
      * It is assigned as a data-qa attribute to an element.
      */
     qa?: string;
+    /**
+     * Enables HTML rendering for the chart title.
+     * When true, the title is rendered as an HTML element on top of the SVG
+     * instead of an SVG text node. This allows using arbitrary HTML tags
+     * (e.g. links, styled spans) that cannot be embedded in SVG.
+     * The element will be displayed outside the box of the SVG element.
+     */
+    html?: boolean;
+    /**
+     * Maximum height of the title area. Accepts a pixel value (`number` or `"100px"`)
+     * or a percentage string (`"50%"`) relative to the full chart height.
+     * When the title content exceeds this height, it is clipped.
+     * Only applicable when `html: true`.
+     *
+     * Default: 50%
+     */
+    maxHeight?: string | number;
 }

package/dist/cjs/{hooks/utils/get-band-size.js → core/utils/band-size.js}

@@ -1,4 +1,4 @@
-import { isBandScale } from '../../core/utils';
+import { isBandScale } from '../utils';
 export function getBandSize({ domain, scale, }) {
     if (!scale || !domain.length) {
         return 0;

package/dist/{esm/hooks → cjs/core}/utils/bar-y.d.ts

@@ -1,7 +1,7 @@
-import type { ChartScale } from '../../core/scales/types';
 import type { BarYSeries, BarYSeriesData } from '../../types';
-import type { PreparedYAxis } from '../useAxis/types';
-import type { PreparedBarYSeries, PreparedSeriesOptions } from '../useSeries/types';
+import type { PreparedYAxis } from '../axes/types';
+import type { ChartScale } from '../scales/types';
+import type { PreparedBarYSeries, PreparedSeriesOptions } from '../series/types';
 /**
  * BarY always filters out data with null or replace null by zero.
  */

package/dist/cjs/{hooks → core}/utils/bar-y.js

@@ -1,9 +1,9 @@
 import { max } from 'd3-array';
 import get from 'lodash/get';
-import { getDataCategoryValue } from '../../core/utils';
-import { MIN_BAR_GAP, MIN_BAR_GROUP_GAP, MIN_BAR_WIDTH } from '../constants';
-import { getSeriesStackId } from '../useSeries/utils';
-import { getBandSize } from './get-band-size';
+import { getSeriesStackId } from '../series/utils';
+import { MIN_BAR_GAP, MIN_BAR_GROUP_GAP, MIN_BAR_WIDTH } from '../shapes/bar-constants';
+import { getDataCategoryValue } from '../utils';
+import { getBandSize } from './band-size';
 const isSeriesDataValid = (d) => d.x !== null;
 export function groupBarYDataByYValue(series, yAxis) {
     const data = {};

package/dist/cjs/core/utils/get-closest-data.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeData } from '../../hooks';
+import type { ShapeData } from '../../hooks/useShapes';
 import type { ChartSeries, ChartSeriesData, TooltipDataChunk } from '../../types';
 type GetClosestPointsArgs = {
     position: [number, number];

package/dist/cjs/core/utils/series/sorting.js

@@ -1,8 +1,8 @@
 import { sort } from 'd3-array';
 import { isEmpty } from 'lodash';
 import get from 'lodash/get';
-import { getAxisCategories } from '../../utils';
 import { SERIES_TYPE } from '../../constants';
+import { getAxisCategories } from '../../utils';
 function applyAxisCategoriesOrder({ series, axis, key, }) {
     var _a, _b;
     const originalCategories = (_a = axis === null || axis === void 0 ? void 0 : axis.categories) !== null && _a !== void 0 ? _a : [];

package/dist/cjs/core/utils/text.d.ts

@@ -4,7 +4,6 @@ import type { BaseTextStyle, MeaningfulAny } from '../../types';
  * Approximate ratio of descenders relative to the full font em height.
  * Based on the Chromium hanging baseline algorithm where hanging offset ≈ ascent × 0.2.
  * This means ascent ≈ 80% of em height, descenders ≈ 20%.
- *
  * @see https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/html/canvas/text_metrics.cc;l=32
  */
 export declare const DESCENDER_RATIO = 0.2;

package/dist/cjs/core/utils/text.js

@@ -5,7 +5,6 @@ const b = block('chart');
  * Approximate ratio of descenders relative to the full font em height.
  * Based on the Chromium hanging baseline algorithm where hanging offset ≈ ascent × 0.2.
  * This means ascent ≈ 80% of em height, descenders ≈ 20%.
- *
  * @see https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/html/canvas/text_metrics.cc;l=32
  */
 export const DESCENDER_RATIO = 0.2;

package/dist/cjs/hooks/index.d.ts

@@ -8,7 +8,7 @@ export * from './useCrosshair';
 export * from './usePrevious';
 export * from './useRangeSlider';
 export * from './useRangeSlider/types';
-export * from './useSeries';
+export { getPreparedSeries, getVisibleSeries } from '../core/series';
 export * from '../core/series/types';
 export * from './useShapes';
 export * from '../core/layout/split';

package/dist/cjs/hooks/index.js

@@ -8,7 +8,7 @@ export * from './useCrosshair';
 export * from './usePrevious';
 export * from './useRangeSlider';
 export * from './useRangeSlider/types';
-export * from './useSeries';
+export { getPreparedSeries, getVisibleSeries } from '../core/series';
 export * from '../core/series/types';
 export * from './useShapes';
 export * from '../core/layout/split';

package/dist/cjs/hooks/types.d.ts

@@ -1,5 +1,6 @@
 import type { TextRowData } from '../components/types';
-import type { ChartBrush, ChartData, ChartMargin, ChartTitle, ChartZoom, DeepRequired } from '../types';
+import type { BaseTextStyle, ChartBrush, ChartData, ChartMargin, ChartTitle, ChartZoom, DeepRequired } from '../types';
+import type { HtmlItem } from '../types/chart-ui';
 export type PreparedZoom = DeepRequired<Omit<ChartZoom, 'enabled' | 'brush'>> & DeepRequired<{
     brush: ChartBrush;
 }>;
@@ -7,10 +8,12 @@ export type PreparedChart = {
     margin: ChartMargin;
     zoom: PreparedZoom | null;
 };
-export type PreparedTitle = Omit<ChartTitle, 'margin'> & {
+export type PreparedTitle = Omit<ChartTitle, 'margin' | 'style'> & {
     height: number;
     margin: number;
-    contentRows: TextRowData[];
+    style: BaseTextStyle;
+    contentRows?: TextRowData[];
+    htmlElements?: HtmlItem[];
 };
 export type PreparedTooltip = ChartData['tooltip'] & {
     enabled: boolean;

package/dist/cjs/hooks/useRangeSlider/types.d.ts

@@ -1,9 +1,9 @@
 import type { ChartScale } from '../../core/scales/types';
+import type { PreparedLegend, PreparedSeries, PreparedSeriesOptions } from '../../core/series/types';
 import type { ChartXAxis, ChartYAxis, LegendConfig } from '../../types';
 import type { PreparedChart } from '../types';
 import type { PreparedRangeSlider, PreparedXAxis, PreparedYAxis } from '../useAxis/types';
 import type { BrushSelection, UseBrushProps } from '../useBrush/types';
-import type { PreparedLegend, PreparedSeries, PreparedSeriesOptions } from '../useSeries/types';
 export type RangeSliderState = {
     max: number;
     min: number;

package/dist/cjs/hooks/useRangeSlider/utils.d.ts

@@ -1,8 +1,8 @@
 import type { ChartScale } from '../../core/scales/types';
+import type { PreparedLegend } from '../../core/series/types';
 import type { PreparedChart } from '../types';
 import type { PreparedRangeSlider } from '../useAxis/types';
 import type { BrushSelection } from '../useBrush/types';
-import type { PreparedLegend } from '../useSeries/types';
 import type { RangeSliderState } from './types';
 export declare function getRangeSliderOffsetTop(args: {
     height: number;