@gravity-ui/charts 0.5.0 → 0.6.1

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

@@ -1,13 +1,12 @@
 import type { Dispatch } from 'd3';
-import type { TooltipDataChunk } from '../../types';
+import type { PointPosition, 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;
+    pointerPosition: PointPosition | undefined;
 };
 export {};

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

@@ -1,5 +1,5 @@
 import type { MeaningfulAny } from '../misc';
-import type { ChartTooltipRendererData } from './tooltip';
+import type { ChartTooltipRendererArgs } from './tooltip';
 export type ChartMargin = {
     top: number;
     right: number;
@@ -13,6 +13,6 @@ export type ChartOptions = {
             point: MeaningfulAny;
             series: MeaningfulAny;
         }, event: PointerEvent) => void;
-        pointermove?: (data: ChartTooltipRendererData | undefined, event: PointerEvent) => void;
+        pointermove?: (data: ChartTooltipRendererArgs | undefined, event: PointerEvent) => void;
     };
 };

package/dist/cjs/types/chart/series.d.ts

@@ -16,7 +16,7 @@ export type ChartSeriesData<T = MeaningfulAny> = ScatterSeriesData<T> | PieSerie
 export type DataLabelRendererData<T = MeaningfulAny> = {
     data: ChartSeriesData<T>;
 };
-type BasicHoverState = {
+export type BasicHoverState = {
     /**
      * Enable separate styles for the hovered series.
      *
@@ -223,4 +223,3 @@ export type ChartSeriesOptions = {
         };
     };
 };
-export {};

package/dist/cjs/types/chart/tooltip.d.ts

@@ -59,7 +59,7 @@ export type TooltipDataChunkWaterfall<T = MeaningfulAny> = {
 export type TooltipDataChunk<T = MeaningfulAny> = (TooltipDataChunkBarX<T> | TooltipDataChunkBarY<T> | TooltipDataChunkPie<T> | TooltipDataChunkScatter<T> | TooltipDataChunkLine<T> | TooltipDataChunkArea<T> | TooltipDataChunkTreemap<T> | TooltipDataChunkWaterfall<T>) & {
     closest?: boolean;
 };
-export type ChartTooltipRendererData<T = MeaningfulAny> = {
+export type ChartTooltipRendererArgs<T = MeaningfulAny> = {
     hovered: TooltipDataChunk<T>[];
     xAxis?: ChartXAxis;
     yAxis?: ChartYAxis;
@@ -67,9 +67,9 @@ export type ChartTooltipRendererData<T = MeaningfulAny> = {
 export type ChartTooltip<T = MeaningfulAny> = {
     enabled?: boolean;
     /** Specifies the renderer for the tooltip. If returned null default tooltip renderer will be used. */
-    renderer?: (args: {
-        hovered: TooltipDataChunk<T>[];
-        xAxis?: ChartXAxis;
-        yAxis?: ChartYAxis;
-    }) => React.ReactElement | null;
+    renderer?: (args: ChartTooltipRendererArgs<T>) => React.ReactElement | null;
+    pin?: {
+        enabled?: boolean;
+        modifierKey?: 'altKey' | 'metaKey';
+    };
 };

package/dist/cjs/types/chart-ui.d.ts

@@ -18,6 +18,10 @@ export type HtmlItem = {
     x: number;
     y: number;
     content: string;
+    size: {
+        width: number;
+        height: number;
+    };
 };
 export type ShapeDataWithHtmlItems = {
     htmlElements: HtmlItem[];

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

@@ -2,3 +2,4 @@
  * A utilitarian type to describe `any` when it does not contradict the typescript usage paradigm.
  */
 export type MeaningfulAny = any;
+export type PointPosition = [number, number];

package/dist/cjs/utils/misc.d.ts

@@ -1,2 +1,10 @@
-export declare const randomString: (length: number, chars: string) => string;
-export declare const getUniqId: () => string;
+export declare function randomString(length: number, chars: string): string;
+export declare function getUniqId(): string;
+/**
+ * Checks Macintosh hardware is used.
+ *
+ * Note: there is no better way to get this information as using depricated property `navigator.platform`.
+ *
+ * More details [here](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/platform#examples).
+ */
+export declare function isMacintosh(): boolean;

package/dist/cjs/utils/misc.js

@@ -1,8 +1,20 @@
-export const randomString = (length, chars) => {
+export function randomString(length, chars) {
     let result = '';
     for (let i = length; i > 0; --i) {
         result += chars[Math.floor(Math.random() * chars.length)];
     }
     return result;
-};
-export const getUniqId = () => `gravity-chart.${randomString(5, '0123456789abcdefghijklmnopqrstuvwxyz')}`;
+}
+export function getUniqId() {
+    return `gravity-chart.${randomString(5, '0123456789abcdefghijklmnopqrstuvwxyz')}`;
+}
+/**
+ * Checks Macintosh hardware is used.
+ *
+ * Note: there is no better way to get this information as using depricated property `navigator.platform`.
+ *
+ * More details [here](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/platform#examples).
+ */
+export function isMacintosh() {
+    return typeof navigator === 'undefined' ? false : /Mac|iP(hone|[oa]d)/.test(navigator.platform);
+}

package/dist/esm/components/ChartInner/index.d.ts

@@ -1,10 +1,4 @@
 import React from 'react';
-import type { ChartData } from '../../types';
+import type { ChartInnerProps } from './types';
 import './styles.css';
-type Props = {
-    width: number;
-    height: number;
-    data: ChartData;
-};
-export declare const ChartInner: (props: Props) => React.JSX.Element;
-export {};
+export declare const ChartInner: (props: ChartInnerProps) => React.JSX.Element;

package/dist/esm/components/ChartInner/index.js

@@ -1,77 +1,39 @@
 import React from 'react';
-import { pointer } from 'd3';
-import throttle from 'lodash/throttle';
-import { IS_TOUCH_ENABLED } from '../../constants';
-import { useAxisScales, useChartDimensions, useChartOptions, useSeries, useShapes, } from '../../hooks';
-import { getYAxisWidth } from '../../hooks/useChartDimensions/utils';
-import { getPreparedXAxis } from '../../hooks/useChartOptions/x-axis';
-import { getPreparedYAxis } from '../../hooks/useChartOptions/y-axis';
-import { useSplit } from '../../hooks/useSplit';
 import { EventType, block, getD3Dispatcher } from '../../utils';
-import { getClosestPoints } from '../../utils/chart/get-closest-data';
 import { AxisX, AxisY } from '../Axis';
 import { Legend } from '../Legend';
 import { PlotTitle } from '../PlotTitle';
 import { Title } from '../Title';
 import { Tooltip } from '../Tooltip';
+import { useChartInnerHandlers } from './useChartInnerHandlers';
+import { useChartInnerProps } from './useChartInnerProps';
+import { useChartInnerState } from './useChartInnerState';
 import './styles.css';
 const b = block('d3');
-const THROTTLE_DELAY = 50;
 export const ChartInner = (props) => {
     var _a, _b, _c, _d;
     const { width, height, data } = props;
     const svgRef = React.useRef(null);
     const htmlLayerRef = React.useRef(null);
-    const dispatcher = React.useMemo(() => {
-        return getD3Dispatcher();
-    }, []);
-    const { chart, title, tooltip } = useChartOptions({
-        data,
-    });
-    const xAxis = React.useMemo(() => getPreparedXAxis({ xAxis: data.xAxis, width, series: data.series.data }), [data, width]);
-    const yAxis = React.useMemo(() => getPreparedYAxis({
-        series: data.series.data,
-        yAxis: data.yAxis,
-        height,
-    }), [data, height]);
-    const { legendItems, legendConfig, preparedSeries, preparedSeriesOptions, preparedLegend, handleLegendItemClick, } = useSeries({
-        chartWidth: width,
-        chartHeight: height,
-        chartMargin: chart.margin,
-        series: data.series,
-        legend: data.legend,
-        preparedYAxis: yAxis,
-    });
-    const { boundsWidth, boundsHeight } = useChartDimensions({
-        width,
-        height,
-        margin: chart.margin,
-        preparedLegend,
-        preparedXAxis: xAxis,
-        preparedYAxis: yAxis,
-        preparedSeries: preparedSeries,
+    const dispatcher = React.useMemo(() => getD3Dispatcher(), []);
+    const { boundsHeight, boundsOffsetLeft, boundsOffsetTop, boundsWidth, handleLegendItemClick, legendConfig, legendItems, preparedSeries, preparedSplit, preparedLegend, prevHeight, prevWidth, shapes, shapesData, title, tooltip, xAxis, xScale, yAxis, yScale, } = useChartInnerProps(Object.assign(Object.assign({}, props), { dispatcher, htmlLayout: htmlLayerRef.current }));
+    const { tooltipPinned, togglePinTooltip, unpinTooltip } = useChartInnerState({
+        dispatcher,
+        tooltip,
     });
-    const preparedSplit = useSplit({ split: data.split, boundsHeight, chartWidth: width });
-    const { xScale, yScale } = useAxisScales({
-        boundsWidth,
+    const { handleChartClick, handleMouseLeave, throttledHandleMouseMove, throttledHandleTouchMove } = useChartInnerHandlers({
         boundsHeight,
-        series: preparedSeries,
-        xAxis,
-        yAxis,
-        split: preparedSplit,
-    });
-    const { shapes, shapesData } = useShapes({
+        boundsOffsetLeft,
+        boundsOffsetTop,
         boundsWidth,
-        boundsHeight,
         dispatcher,
-        series: preparedSeries,
-        seriesOptions: preparedSeriesOptions,
+        shapesData,
+        svgContainer: svgRef.current,
+        togglePinTooltip,
+        tooltipPinned,
+        unpinTooltip,
         xAxis,
-        xScale,
         yAxis,
-        yScale,
-        split: preparedSplit,
-        htmlLayout: htmlLayerRef.current,
     });
     const clickHandler = (_b = (_a = data.chart) === null || _a === void 0 ? void 0 : _a.events) === null || _b === void 0 ? void 0 : _b.click;
     const pointerMoveHandler = (_d = (_c = data.chart) === null || _c === void 0 ? void 0 : _c.events) === null || _d === void 0 ? void 0 : _d.pointermove;
@@ -90,68 +52,11 @@ export const ChartInner = (props) => {
             dispatcher.on(EventType.POINTERMOVE_CHART, null);
         };
     }, [dispatcher, clickHandler, pointerMoveHandler]);
-    const boundsOffsetTop = chart.margin.top;
-    // We only need to consider the width of the first left axis
-    const boundsOffsetLeft = chart.margin.left + getYAxisWidth(yAxis[0]);
-    const isOutsideBounds = React.useCallback((x, y) => {
-        return x < 0 || x > boundsWidth || y < 0 || y > boundsHeight;
-    }, [boundsHeight, boundsWidth]);
-    const handleMove = ([pointerX, pointerY], event) => {
-        const x = pointerX - boundsOffsetLeft;
-        const y = pointerY - boundsOffsetTop;
-        if (isOutsideBounds(x, y)) {
-            dispatcher.call(EventType.HOVER_SHAPE, {}, undefined);
-            dispatcher.call(EventType.POINTERMOVE_CHART, {}, undefined, event);
-            return;
-        }
-        const closest = getClosestPoints({
-            position: [x, y],
-            shapesData,
-        });
-        dispatcher.call(EventType.HOVER_SHAPE, event.target, closest, [pointerX, pointerY]);
-        dispatcher.call(EventType.POINTERMOVE_CHART, {}, {
-            hovered: closest,
-            xAxis,
-            yAxis: yAxis[0],
-        }, event);
-    };
-    const handleMouseMove = (event) => {
-        const [pointerX, pointerY] = pointer(event, svgRef.current);
-        handleMove([pointerX, pointerY], event);
-    };
-    const throttledHandleMouseMove = IS_TOUCH_ENABLED
-        ? undefined
-        : throttle(handleMouseMove, THROTTLE_DELAY);
-    const handleMouseLeave = (event) => {
-        throttledHandleMouseMove === null || throttledHandleMouseMove === void 0 ? void 0 : throttledHandleMouseMove.cancel();
-        dispatcher.call(EventType.HOVER_SHAPE, {}, undefined);
-        dispatcher.call(EventType.POINTERMOVE_CHART, {}, undefined, event);
-    };
-    const handleTouchMove = (event) => {
-        const touch = event.touches[0];
-        const [pointerX, pointerY] = pointer(touch, svgRef.current);
-        handleMove([pointerX, pointerY], event);
-    };
-    const throttledHandleTouchMove = IS_TOUCH_ENABLED
-        ? throttle(handleTouchMove, THROTTLE_DELAY)
-        : undefined;
-    const handleChartClick = React.useCallback((event) => {
-        const [pointerX, pointerY] = pointer(event, svgRef.current);
-        const x = pointerX - boundsOffsetLeft;
-        const y = pointerY - boundsOffsetTop;
-        if (isOutsideBounds(x, y)) {
-            return;
-        }
-        const items = getClosestPoints({
-            position: [x, y],
-            shapesData,
-        });
-        const selected = items === null || items === void 0 ? void 0 : items.find((item) => item.closest);
-        if (!selected) {
-            return;
+    React.useEffect(() => {
+        if ((prevWidth !== width || prevHeight !== height) && tooltipPinned) {
+            unpinTooltip === null || unpinTooltip === void 0 ? void 0 : unpinTooltip();
         }
-        dispatcher.call('click-chart', undefined, { point: selected.data, series: selected.series }, event);
-    }, [boundsOffsetLeft, boundsOffsetTop, dispatcher, isOutsideBounds, shapesData]);
+    }, [prevWidth, width, prevHeight, height, tooltipPinned, unpinTooltip]);
     return (React.createElement(React.Fragment, null,
         React.createElement("svg", { ref: svgRef, className: b(), width: width, height: height, onMouseMove: throttledHandleMouseMove, onMouseLeave: handleMouseLeave, onTouchStart: throttledHandleTouchMove, onTouchMove: throttledHandleTouchMove, onClick: handleChartClick },
             title && React.createElement(Title, Object.assign({}, title, { chartWidth: width })),
@@ -164,9 +69,9 @@ export const ChartInner = (props) => {
                     React.createElement("g", { transform: `translate(0, ${boundsHeight})` },
                         React.createElement(AxisX, { axis: xAxis, width: boundsWidth, height: boundsHeight, scale: xScale, split: preparedSplit })))),
                 shapes),
-            preparedLegend.enabled && (React.createElement(Legend, { chartSeries: preparedSeries, boundsWidth: boundsWidth, legend: preparedLegend, items: legendItems, config: legendConfig, onItemClick: handleLegendItemClick }))),
+            preparedLegend.enabled && (React.createElement(Legend, { chartSeries: preparedSeries, boundsWidth: boundsWidth, legend: preparedLegend, items: legendItems, config: legendConfig, onItemClick: handleLegendItemClick, onUpdate: unpinTooltip }))),
         React.createElement("div", { className: b('html-layer'), ref: htmlLayerRef, style: {
                 transform: `translate(${boundsOffsetLeft}px, ${boundsOffsetTop}px)`,
             } }),
-        React.createElement(Tooltip, { dispatcher: dispatcher, tooltip: tooltip, svgContainer: svgRef.current, xAxis: xAxis, yAxis: yAxis[0] })));
+        React.createElement(Tooltip, { dispatcher: dispatcher, tooltip: tooltip, svgContainer: svgRef.current, xAxis: xAxis, yAxis: yAxis[0], onOutsideClick: unpinTooltip, tooltipPinned: tooltipPinned })));
 };

package/dist/esm/components/ChartInner/types.d.ts

@@ -0,0 +1,6 @@
+import type { ChartData } from '../../types';
+export type ChartInnerProps = {
+    width: number;
+    height: number;
+    data: ChartData;
+};

package/dist/esm/components/ChartInner/useChartInnerHandlers.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { Dispatch } from 'd3';
+import type { PreparedAxis, ShapeData } from '../../hooks';
+import type { useChartInnerState } from './useChartInnerState';
+type ChartInnerState = ReturnType<typeof useChartInnerState>;
+type Props = {
+    boundsHeight: number;
+    boundsOffsetLeft: number;
+    boundsOffsetTop: number;
+    boundsWidth: number;
+    dispatcher: Dispatch<object>;
+    shapesData: ShapeData[];
+    svgContainer: SVGSVGElement | null;
+    togglePinTooltip: ChartInnerState['togglePinTooltip'];
+    tooltipPinned: boolean;
+    unpinTooltip: ChartInnerState['unpinTooltip'];
+    xAxis: PreparedAxis;
+    yAxis: PreparedAxis[];
+};
+export declare function useChartInnerHandlers(props: Props): {
+    handleChartClick: (event: React.MouseEvent<SVGSVGElement>) => void;
+    handleMouseLeave: React.MouseEventHandler<SVGSVGElement>;
+    throttledHandleMouseMove: import("lodash").DebouncedFuncLeading<React.MouseEventHandler<SVGSVGElement>> | undefined;
+    throttledHandleTouchMove: import("lodash").DebouncedFuncLeading<React.TouchEventHandler<SVGSVGElement>> | undefined;
+};
+export {};

package/dist/esm/components/ChartInner/useChartInnerHandlers.js

@@ -0,0 +1,94 @@
+import React from 'react';
+import { pointer } from 'd3';
+import throttle from 'lodash/throttle';
+import { IS_TOUCH_ENABLED } from '../../constants';
+import { EventType } from '../../utils';
+import { getClosestPoints } from '../../utils/chart/get-closest-data';
+const THROTTLE_DELAY = 50;
+export function useChartInnerHandlers(props) {
+    const { boundsHeight, boundsOffsetLeft, boundsOffsetTop, boundsWidth, dispatcher, shapesData, svgContainer, togglePinTooltip, tooltipPinned, unpinTooltip, xAxis, yAxis, } = props;
+    const isOutsideBounds = React.useCallback((x, y) => {
+        return x < 0 || x > boundsWidth || y < 0 || y > boundsHeight;
+    }, [boundsHeight, boundsWidth]);
+    const handleMove = ([pointerX, pointerY], event) => {
+        if (tooltipPinned) {
+            return;
+        }
+        const x = pointerX - boundsOffsetLeft;
+        const y = pointerY - boundsOffsetTop;
+        if (isOutsideBounds(x, y)) {
+            dispatcher.call(EventType.HOVER_SHAPE, {}, undefined);
+            dispatcher.call(EventType.POINTERMOVE_CHART, {}, undefined, event);
+            return;
+        }
+        const closest = getClosestPoints({
+            position: [x, y],
+            shapesData,
+        });
+        dispatcher.call(EventType.HOVER_SHAPE, event.target, closest, [pointerX, pointerY]);
+        dispatcher.call(EventType.POINTERMOVE_CHART, {}, {
+            hovered: closest,
+            xAxis,
+            yAxis: yAxis[0],
+        }, event);
+    };
+    const handleMouseMove = (event) => {
+        const [pointerX, pointerY] = pointer(event, svgContainer);
+        handleMove([pointerX, pointerY], event);
+    };
+    const throttledHandleMouseMove = IS_TOUCH_ENABLED
+        ? undefined
+        : throttle(handleMouseMove, THROTTLE_DELAY);
+    const handleMouseLeave = (event) => {
+        if (tooltipPinned) {
+            return;
+        }
+        throttledHandleMouseMove === null || throttledHandleMouseMove === void 0 ? void 0 : throttledHandleMouseMove.cancel();
+        dispatcher.call(EventType.HOVER_SHAPE, {}, undefined);
+        dispatcher.call(EventType.POINTERMOVE_CHART, {}, undefined, event);
+    };
+    const handleTouchMove = (event) => {
+        const touch = event.touches[0];
+        const [pointerX, pointerY] = pointer(touch, svgContainer);
+        handleMove([pointerX, pointerY], event);
+    };
+    const throttledHandleTouchMove = IS_TOUCH_ENABLED
+        ? throttle(handleTouchMove, THROTTLE_DELAY)
+        : undefined;
+    const handleChartClick = (event) => {
+        const [pointerX, pointerY] = pointer(event, svgContainer);
+        const x = pointerX - boundsOffsetLeft;
+        const y = pointerY - boundsOffsetTop;
+        if (isOutsideBounds(x, y)) {
+            return;
+        }
+        const items = getClosestPoints({
+            position: [x, y],
+            shapesData,
+        });
+        const selected = items === null || items === void 0 ? void 0 : items.find((item) => item.closest);
+        if (!selected) {
+            if (tooltipPinned) {
+                unpinTooltip === null || unpinTooltip === void 0 ? void 0 : unpinTooltip();
+            }
+            return;
+        }
+        dispatcher.call(EventType.CLICK_CHART, undefined, { point: selected.data, series: selected.series }, event);
+        const nextTooltipFixed = !tooltipPinned;
+        if (!nextTooltipFixed) {
+            dispatcher.call(EventType.HOVER_SHAPE, event.target, items, [pointerX, pointerY]);
+            dispatcher.call(EventType.POINTERMOVE_CHART, {}, {
+                hovered: items,
+                xAxis,
+                yAxis: yAxis[0],
+            }, event);
+        }
+        togglePinTooltip === null || togglePinTooltip === void 0 ? void 0 : togglePinTooltip(nextTooltipFixed, event);
+    };
+    return {
+        handleChartClick,
+        handleMouseLeave,
+        throttledHandleMouseMove,
+        throttledHandleTouchMove,
+    };
+}

package/dist/esm/components/ChartInner/useChartInnerProps.d.ts

@@ -0,0 +1,43 @@
+import React from 'react';
+import type { Dispatch } from 'd3';
+import type { ChartInnerProps } from './types';
+type Props = ChartInnerProps & {
+    dispatcher: Dispatch<object>;
+    htmlLayout: HTMLElement | null;
+};
+export declare function useChartInnerProps(props: Props): {
+    boundsHeight: number;
+    boundsOffsetLeft: number;
+    boundsOffsetTop: number;
+    boundsWidth: number;
+    handleLegendItemClick: import("../../hooks").OnLegendItemClick;
+    legendConfig: {
+        offset: {
+            left: number;
+            top: number;
+        };
+        pagination: {
+            limit: number;
+            maxPage: number;
+        } | undefined;
+    };
+    legendItems: import("../../hooks").LegendItem[][];
+    preparedLegend: import("../../hooks").PreparedLegend;
+    preparedSeries: import("../../hooks").PreparedSeries[];
+    preparedSplit: import("../../hooks").PreparedSplit;
+    prevHeight: number | undefined;
+    prevWidth: number | undefined;
+    shapes: React.ReactElement<any, string | React.JSXElementConstructor<any>>[];
+    shapesData: import("../../hooks").ShapeData[];
+    title: (import("../../types").ChartTitle & {
+        height: number;
+    }) | undefined;
+    tooltip: import("../../types").ChartTooltip<any> & {
+        enabled: boolean;
+    };
+    xAxis: import("../../hooks").PreparedAxis;
+    xScale: import("../../hooks").ChartScale | undefined;
+    yAxis: import("../../hooks").PreparedAxis[];
+    yScale: import("../../hooks").ChartScale[] | undefined;
+};
+export {};

package/dist/esm/components/ChartInner/useChartInnerProps.js

@@ -0,0 +1,81 @@
+import React from 'react';
+import { useAxisScales, useChartDimensions, useChartOptions, usePrevious, useSeries, useShapes, useSplit, } from '../../hooks';
+import { getYAxisWidth } from '../../hooks/useChartDimensions/utils';
+import { getPreparedXAxis } from '../../hooks/useChartOptions/x-axis';
+import { getPreparedYAxis } from '../../hooks/useChartOptions/y-axis';
+export function useChartInnerProps(props) {
+    const { width, height, data, dispatcher, htmlLayout } = props;
+    const prevWidth = usePrevious(width);
+    const prevHeight = usePrevious(height);
+    const { chart, title, tooltip } = useChartOptions({ data });
+    const xAxis = React.useMemo(() => getPreparedXAxis({ xAxis: data.xAxis, width, series: data.series.data }), [data, width]);
+    const yAxis = React.useMemo(() => getPreparedYAxis({
+        series: data.series.data,
+        yAxis: data.yAxis,
+        height,
+    }), [data, height]);
+    const { legendItems, legendConfig, preparedSeries, preparedSeriesOptions, preparedLegend, handleLegendItemClick, } = useSeries({
+        chartWidth: width,
+        chartHeight: height,
+        chartMargin: chart.margin,
+        series: data.series,
+        legend: data.legend,
+        preparedYAxis: yAxis,
+    });
+    const { boundsWidth, boundsHeight } = useChartDimensions({
+        width,
+        height,
+        margin: chart.margin,
+        preparedLegend,
+        preparedXAxis: xAxis,
+        preparedYAxis: yAxis,
+        preparedSeries: preparedSeries,
+    });
+    const preparedSplit = useSplit({ split: data.split, boundsHeight, chartWidth: width });
+    const { xScale, yScale } = useAxisScales({
+        boundsWidth,
+        boundsHeight,
+        series: preparedSeries,
+        xAxis,
+        yAxis,
+        split: preparedSplit,
+    });
+    const { shapes, shapesData } = useShapes({
+        boundsWidth,
+        boundsHeight,
+        dispatcher,
+        series: preparedSeries,
+        seriesOptions: preparedSeriesOptions,
+        xAxis,
+        xScale,
+        yAxis,
+        yScale,
+        split: preparedSplit,
+        htmlLayout,
+    });
+    const boundsOffsetTop = chart.margin.top;
+    // We only need to consider the width of the first left axis
+    const boundsOffsetLeft = chart.margin.left + getYAxisWidth(yAxis[0]);
+    return {
+        boundsHeight,
+        boundsOffsetLeft,
+        boundsOffsetTop,
+        boundsWidth,
+        handleLegendItemClick,
+        legendConfig,
+        legendItems,
+        preparedLegend,
+        preparedSeries,
+        preparedSplit,
+        prevHeight,
+        prevWidth,
+        shapes,
+        shapesData,
+        title,
+        tooltip,
+        xAxis,
+        xScale,
+        yAxis,
+        yScale,
+    };
+}

package/dist/esm/components/ChartInner/useChartInnerState.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { Dispatch } from 'd3';
+import type { ChartTooltip } from '../../types';
+type Props = {
+    dispatcher: Dispatch<object>;
+    tooltip?: ChartTooltip;
+};
+export declare function useChartInnerState(props: Props): {
+    tooltipPinned: boolean;
+    togglePinTooltip: ((value: boolean, event: React.MouseEvent) => void) | undefined;
+    unpinTooltip: (() => void) | undefined;
+};
+export {};

package/dist/esm/components/ChartInner/useChartInnerState.js

@@ -0,0 +1,34 @@
+import React from 'react';
+import { EventType, isMacintosh } from '../../utils';
+export function useChartInnerState(props) {
+    var _a, _b;
+    const { dispatcher, tooltip } = props;
+    const [tooltipPinned, setTooltipPinned] = React.useState(false);
+    const tooltipEnabled = tooltip === null || tooltip === void 0 ? void 0 : tooltip.enabled;
+    const tooltipPinEnabled = (_a = tooltip === null || tooltip === void 0 ? void 0 : tooltip.pin) === null || _a === void 0 ? void 0 : _a.enabled;
+    const modifierKey = (_b = tooltip === null || tooltip === void 0 ? void 0 : tooltip.pin) === null || _b === void 0 ? void 0 : _b.modifierKey;
+    const togglePinTooltip = React.useCallback((value, event) => {
+        let resultValue = value;
+        if (value && modifierKey) {
+            switch (modifierKey) {
+                case 'altKey': {
+                    resultValue = event.altKey;
+                    break;
+                }
+                case 'metaKey': {
+                    resultValue = isMacintosh() ? event.metaKey : event.ctrlKey;
+                }
+            }
+        }
+        setTooltipPinned(resultValue);
+    }, [modifierKey]);
+    const unpinTooltip = React.useCallback(() => {
+        setTooltipPinned(false);
+        dispatcher.call(EventType.HOVER_SHAPE, {}, undefined);
+    }, [dispatcher]);
+    return {
+        tooltipPinned,
+        togglePinTooltip: tooltipEnabled && tooltipPinEnabled ? togglePinTooltip : undefined,
+        unpinTooltip: tooltipEnabled && tooltipPinEnabled ? unpinTooltip : undefined,
+    };
+}

package/dist/esm/components/Legend/index.d.ts

@@ -8,6 +8,7 @@ type Props = {
     items: LegendItem[][];
     config: LegendConfig;
     onItemClick: OnLegendItemClick;
+    onUpdate?: () => void;
 };
 export declare const Legend: (props: Props) => React.JSX.Element;
 export {};

package/dist/esm/components/Legend/index.js

@@ -134,7 +134,7 @@ function renderLegendSymbol(args) {
     });
 }
 export const Legend = (props) => {
-    const { boundsWidth, chartSeries, legend, items, config, onItemClick } = props;
+    const { boundsWidth, chartSeries, legend, items, config, onItemClick, onUpdate } = props;
     const ref = React.useRef(null);
     const [paginationOffset, setPaginationOffset] = React.useState(0);
     React.useEffect(() => {
@@ -164,6 +164,7 @@ export const Legend = (props) => {
                     .attr('class', b('item'))
                     .on('click', function (e, d) {
                     onItemClick({ name: d.name, metaKey: e.metaKey });
+                    onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate();
                 });
                 const getXPosition = (i) => {
                     return line.slice(0, i).reduce((acc, legendItem) => {
@@ -292,6 +293,6 @@ export const Legend = (props) => {
             contentWidth: legendWidth,
         });
         svgElement.attr('transform', `translate(${[left, config.offset.top].join(',')})`);
-    }, [boundsWidth, chartSeries, onItemClick, legend, items, config, paginationOffset]);
+    }, [boundsWidth, chartSeries, onItemClick, onUpdate, legend, items, config, paginationOffset]);
     return React.createElement("g", { className: b(), ref: ref, width: boundsWidth, height: legend.height });
 };