@wavemaker/react-native-echarts 1.0.0-dev.1 → 1.0.0-dev.11

package/radial/tooltip/default-radial-tooltip.js

@@ -0,0 +1,52 @@
+import React from 'react';
+import { StyleSheet, Text, View } from 'react-native';
+/** Themed default radial ring tooltip (React Native). */
+export function createDefaultRadialTooltip(theme) {
+    const t = theme.tooltip;
+    return function DefaultRadialTooltip(params) {
+        const { ringLabel, value, color } = params;
+        const rest = Math.max(0, Math.min(100, 100 - value));
+        return (<View style={{
+                backgroundColor: t.backgroundColor,
+                borderColor: t.borderColor,
+                borderWidth: t.borderWidth,
+                borderRadius: t.borderRadius,
+                padding: t.padding,
+            }}>
+        <View style={{ flexDirection: 'row', alignItems: 'center', marginBottom: 4 }}>
+          {color != null && color !== '' ? (<View style={[styles.swatch, { backgroundColor: color }]}/>) : (<View style={styles.swatchPlaceholder}/>)}
+          <Text style={[styles.title, { color: t.labelColor }]}>{ringLabel}</Text>
+        </View>
+        <Text style={[styles.line, { color: t.valueColor }]}>
+          <Text style={{ color: t.labelColor }}>fill: </Text>
+          {value.toFixed(0)}%
+        </Text>
+        <Text style={[styles.line, { color: t.valueColor }]}>
+          <Text style={{ color: t.labelColor }}>remaining: </Text>
+          {rest.toFixed(0)}%
+        </Text>
+      </View>);
+    };
+}
+const styles = StyleSheet.create({
+    title: {
+        fontWeight: '600',
+        fontSize: 13,
+        flex: 1,
+    },
+    line: {
+        fontSize: 12,
+        marginTop: 2,
+    },
+    swatch: {
+        width: 8,
+        height: 8,
+        borderRadius: 4,
+        marginRight: 6,
+    },
+    swatchPlaceholder: {
+        width: 8,
+        height: 8,
+        marginRight: 6,
+    },
+});

package/radial/tooltip/index.d.ts

@@ -0,0 +1,7 @@
+export { createDefaultRadialTooltip } from './default-radial-tooltip';
+export { createRadialTooltipPreset } from './radial-item-tooltip-presets';
+export type { RadialItemTooltipContext, RadialItemTooltipParams } from './radial-item-tooltip.types';
+export { radialItemParamsFromShowTip } from './radial-item-tooltip.utils';
+export { useRadialItemTooltip } from './use-radial-item-tooltip';
+export type { UseRadialItemTooltipOptions, UseRadialItemTooltipResult } from './use-radial-item-tooltip';
+//# sourceMappingURL=index.d.ts.map

package/radial/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../components/chart/radial/tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACrG,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/radial/tooltip/index.js

@@ -0,0 +1,4 @@
+export { createDefaultRadialTooltip } from './default-radial-tooltip';
+export { createRadialTooltipPreset } from './radial-item-tooltip-presets';
+export { radialItemParamsFromShowTip } from './radial-item-tooltip.utils';
+export { useRadialItemTooltip } from './use-radial-item-tooltip';

package/radial/tooltip/radial-item-tooltip-presets.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { ChartTooltipPreset } from '../../tooltip';
+import type { RadialItemTooltipParams } from './radial-item-tooltip.types';
+export declare function createRadialTooltipPreset(preset: ChartTooltipPreset): (params: RadialItemTooltipParams) => React.ReactElement;
+//# sourceMappingURL=radial-item-tooltip-presets.d.ts.map

package/radial/tooltip/radial-item-tooltip-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radial-item-tooltip-presets.d.ts","sourceRoot":"","sources":["../../../../../components/chart/radial/tooltip/radial-item-tooltip-presets.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAOxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAiD3E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,GACzB,CAAC,MAAM,EAAE,uBAAuB,KAAK,KAAK,CAAC,YAAY,CAYzD"}

package/radial/tooltip/radial-item-tooltip-presets.js

@@ -0,0 +1,43 @@
+import React from 'react';
+import { Text } from 'react-native';
+import { useChartTheme } from '../../chart-theme.context';
+import { TooltipPresetCard, TooltipPresetCompact, TooltipPresetKpi, TooltipPresetStriped, } from '../../tooltip/chart-tooltip-preset-shells';
+function radialCardFromParams(p) {
+    const { ringLabel, value, color } = p;
+    return (<TooltipPresetCard header={{ swatchColor: color, title: ringLabel, marginBottom: 6 }}>
+      <Text style={{ fontSize: 22, fontWeight: '800', color: '#0f172a' }}>{value.toFixed(0)}%</Text>
+      <Text style={{ fontSize: 12, color: '#64748b', marginTop: 4 }}>filled vs 100%</Text>
+    </TooltipPresetCard>);
+}
+function radialCompactFromParams(p) {
+    const { ringLabel, value } = p;
+    return <TooltipPresetCompact emphasis={ringLabel} detail={`${value.toFixed(0)}% fill`} wrap/>;
+}
+function RadialKpiPresetBody(p) {
+    const { theme } = useChartTheme();
+    const { ringLabel, value, color } = p;
+    return (<TooltipPresetKpi accentColor={color ?? '#3b82f6'} minWidth={140} overline={ringLabel} metric={<Text style={{ fontSize: 32, fontWeight: '800', color: theme.tooltip.valueColor, marginTop: 4 }}>
+          {value.toFixed(0)}%
+        </Text>} caption="of ring capacity"/>);
+}
+function radialStripedFromParams(p) {
+    const { ringLabel, value, color } = p;
+    const rest = Math.max(0, 100 - value);
+    return (<TooltipPresetStriped headerSwatch={{ color: color ?? '#64748b', title: ringLabel }} rows={[
+            { key: 'filled', leftLabel: 'filled', right: `${value.toFixed(0)}%` },
+            { key: 'remaining', leftLabel: 'remaining', right: `${rest.toFixed(0)}%` },
+        ]}/>);
+}
+export function createRadialTooltipPreset(preset) {
+    switch (preset) {
+        case 'card':
+            return (p) => radialCardFromParams(p);
+        case 'compact':
+            return (p) => radialCompactFromParams(p);
+        case 'kpi':
+            return (p) => <RadialKpiPresetBody {...p}/>;
+        case 'striped':
+            return (p) => radialStripedFromParams(p);
+    }
+    throw new Error(`Unknown tooltip preset: ${String(preset)}`);
+}

package/radial/tooltip/radial-item-tooltip.types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Item tooltip for radial ring chart (multiple ECharts `pie` series; filled slice is `dataIndex` 0).
+ */
+export interface RadialItemTooltipParams {
+    pointerX: number;
+    pointerY: number;
+    /** Ring index (matches `data` array order). */
+    seriesIndex: number;
+    /** Always `0` for the filled segment (background track uses index 1 and has no tooltip). */
+    dataIndex: number;
+    /** Ring label from data, or a generated name. */
+    ringLabel: string;
+    /** Fill amount 0–100. */
+    value: number;
+    color?: string;
+}
+export interface RadialItemTooltipContext {
+    normalizedSeries: Array<{
+        label?: string;
+        value: number;
+    }>;
+}
+//# sourceMappingURL=radial-item-tooltip.types.d.ts.map

package/radial/tooltip/radial-item-tooltip.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radial-item-tooltip.types.d.ts","sourceRoot":"","sources":["../../../../../components/chart/radial/tooltip/radial-item-tooltip.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D"}

package/radial/tooltip/radial-item-tooltip.types.js

@@ -0,0 +1,3 @@
+/**
+ * Item tooltip for radial ring chart (multiple ECharts `pie` series; filled slice is `dataIndex` 0).
+ */

package/radial/tooltip/radial-item-tooltip.utils.d.ts

@@ -0,0 +1,9 @@
+import type { RadialItemTooltipContext, RadialItemTooltipParams } from './radial-item-tooltip.types';
+/**
+ * Build radial ring tooltip params from an ECharts `showTip` payload.
+ * Only the filled arc (`dataIndex` 0) is shown; the background track is ignored.
+ */
+export declare function radialItemParamsFromShowTip(chart: any, evt: any, ctx: RadialItemTooltipContext, themeSeries: Array<{
+    color: string;
+}>): RadialItemTooltipParams | null;
+//# sourceMappingURL=radial-item-tooltip.utils.d.ts.map

package/radial/tooltip/radial-item-tooltip.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radial-item-tooltip.utils.d.ts","sourceRoot":"","sources":["../../../../../components/chart/radial/tooltip/radial-item-tooltip.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AA+DrG;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,GAAG,EACV,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,wBAAwB,EAC7B,WAAW,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACpC,uBAAuB,GAAG,IAAI,CAmDhC"}

package/radial/tooltip/radial-item-tooltip.utils.js

@@ -0,0 +1,122 @@
+function resolveDataIndexInside(data, evt) {
+    if (typeof evt?.dataIndexInside === 'number' && !Number.isNaN(evt.dataIndexInside)) {
+        return evt.dataIndexInside;
+    }
+    if (typeof evt?.dataIndex === 'number' && !Number.isNaN(evt.dataIndex)) {
+        const mapped = typeof data?.indexOfRawIndex === 'function' ? data.indexOfRawIndex(evt.dataIndex) : evt.dataIndex;
+        if (typeof mapped === 'number' && !Number.isNaN(mapped))
+            return mapped;
+    }
+    return null;
+}
+function pieSectorCenter(data, diInside) {
+    const layout = data.getItemLayout?.(diInside);
+    if (!layout || !Number.isFinite(layout.cx) || !Number.isFinite(layout.cy))
+        return null;
+    const cx = Number(layout.cx);
+    const cy = Number(layout.cy);
+    const r = Number(layout.r);
+    const r0 = Number(layout.r0 ?? 0);
+    const startAngle = Number(layout.startAngle);
+    const endAngle = Number(layout.endAngle);
+    if (!Number.isFinite(startAngle) || !Number.isFinite(endAngle))
+        return null;
+    const mid = (startAngle + endAngle) / 2;
+    const avgR = (r0 + r) / 2;
+    return {
+        x: cx + Math.cos(mid) * avgR,
+        y: cy + Math.sin(mid) * avgR,
+    };
+}
+function pointerFromEventOrSector(chart, evt, data) {
+    const ex = evt?.x;
+    const ey = evt?.y;
+    if (typeof ex === 'number' && typeof ey === 'number' && !Number.isNaN(ex) && !Number.isNaN(ey)) {
+        return { x: ex, y: ey };
+    }
+    return pieSectorCenter(data, 0);
+}
+function sliceValueAt(data, diInside) {
+    try {
+        const dim = typeof data.mapDimension === 'function' ? data.mapDimension('value') : null;
+        if (dim != null) {
+            const v = data.get(dim, diInside);
+            const n = Number(v);
+            if (Number.isFinite(n))
+                return n;
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    const v0 = data.get?.(0, diInside);
+    const n0 = Number(v0);
+    if (Number.isFinite(n0))
+        return n0;
+    try {
+        const n1 = Number(data.get?.('value', diInside));
+        if (Number.isFinite(n1))
+            return n1;
+    }
+    catch {
+        /* ignore */
+    }
+    return NaN;
+}
+/**
+ * Build radial ring tooltip params from an ECharts `showTip` payload.
+ * Only the filled arc (`dataIndex` 0) is shown; the background track is ignored.
+ */
+export function radialItemParamsFromShowTip(chart, evt, ctx, themeSeries) {
+    if (!chart || !evt)
+        return null;
+    if (Array.isArray(evt.dataByCoordSys) && evt.dataByCoordSys.length > 0)
+        return null;
+    const si = typeof evt.seriesIndex === 'number' ? evt.seriesIndex : 0;
+    if (si < 0 || si >= ctx.normalizedSeries.length)
+        return null;
+    const seriesModel = chart.getModel?.().getSeriesByIndex?.(si);
+    const seriesKind = seriesModel?.subType ?? seriesModel?.get?.('type');
+    if (!seriesModel || seriesKind !== 'pie')
+        return null;
+    const data = seriesModel.getData?.();
+    if (!data)
+        return null;
+    const diInside = resolveDataIndexInside(data, evt);
+    if (diInside == null || diInside !== 0)
+        return null;
+    const pixel = pointerFromEventOrSector(chart, evt, data);
+    if (!pixel)
+        return null;
+    const row = ctx.normalizedSeries[si];
+    if (!row)
+        return null;
+    const fromModel = sliceValueAt(data, 0);
+    const value = Number.isFinite(fromModel) ? fromModel : Number(row.value);
+    if (!Number.isFinite(value))
+        return null;
+    const ringLabel = row.label != null && row.label !== '' ? String(row.label) : `Ring ${si + 1}`;
+    let color;
+    try {
+        const style = data.getItemVisual?.(0, 'style');
+        const fill = style?.fill;
+        if (typeof fill === 'string' && fill !== '')
+            color = fill;
+    }
+    catch {
+        /* ignore */
+    }
+    if (color == null) {
+        const themeLen = Math.max(themeSeries.length, 1);
+        color = themeSeries[si % themeLen]?.color;
+    }
+    return {
+        pointerX: pixel.x,
+        pointerY: pixel.y,
+        seriesIndex: si,
+        dataIndex: 0,
+        ringLabel,
+        value,
+        ...(typeof color === 'string' ? { color } : {}),
+    };
+}

package/radial/tooltip/use-radial-item-tooltip.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { RadialItemTooltipContext, RadialItemTooltipParams } from './radial-item-tooltip.types';
+export interface UseRadialItemTooltipOptions {
+    active: boolean;
+    renderTooltip: (params: RadialItemTooltipParams) => React.ReactNode;
+    contextRef: React.RefObject<RadialItemTooltipContext>;
+    themeSeriesRef: React.RefObject<Array<{
+        color: string;
+    }>>;
+    width: number;
+    height: number;
+}
+export interface UseRadialItemTooltipResult {
+    attachRadialItemTooltipListeners: (chart: {
+        on: (ev: string, fn: (...args: any[]) => void) => void;
+        off: (ev: string, fn: (...args: any[]) => void) => void;
+    }) => () => void;
+    renderRadialTooltipOverlay: () => React.ReactNode;
+}
+/** Radial concentric ring tooltip as React Native UI (`trigger: 'item'`). */
+export declare function useRadialItemTooltip(options: UseRadialItemTooltipOptions): UseRadialItemTooltipResult;
+//# sourceMappingURL=use-radial-item-tooltip.d.ts.map

package/radial/tooltip/use-radial-item-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-radial-item-tooltip.d.ts","sourceRoot":"","sources":["../../../../../components/chart/radial/tooltip/use-radial-item-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAEhE,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGrG,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;IACpE,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACtD,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,gCAAgC,EAAE,CAAC,KAAK,EAAE;QACxC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;QACvD,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;KACzD,KAAK,MAAM,IAAI,CAAC;IACjB,0BAA0B,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;CACnD;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,0BAA0B,CAiDrG"}

package/radial/tooltip/use-radial-item-tooltip.js

@@ -0,0 +1,43 @@
+import React, { useCallback, useEffect, useState } from 'react';
+import { ChartPointerTooltipOverlay } from '../../tooltip/chart-pointer-tooltip-overlay';
+import { radialItemParamsFromShowTip } from './radial-item-tooltip.utils';
+/** Radial concentric ring tooltip as React Native UI (`trigger: 'item'`). */
+export function useRadialItemTooltip(options) {
+    const { active, renderTooltip, contextRef, themeSeriesRef, width, height } = options;
+    const [params, setParams] = useState(null);
+    useEffect(() => {
+        if (!active)
+            setParams(null);
+    }, [active]);
+    const attachRadialItemTooltipListeners = useCallback((chart) => {
+        if (!active)
+            return () => { };
+        const onShowTip = (evt) => {
+            const ctx = contextRef.current;
+            if (!ctx?.normalizedSeries?.length) {
+                setParams(null);
+                return;
+            }
+            const next = radialItemParamsFromShowTip(chart, evt, ctx, themeSeriesRef.current ?? []);
+            setParams(next);
+        };
+        const onHideTip = () => setParams(null);
+        chart.on('showTip', onShowTip);
+        chart.on('hideTip', onHideTip);
+        return () => {
+            chart.off('showTip', onShowTip);
+            chart.off('hideTip', onHideTip);
+        };
+    }, [active, contextRef, themeSeriesRef]);
+    const renderRadialTooltipOverlay = useCallback(() => {
+        if (!active || params == null)
+            return null;
+        return (<ChartPointerTooltipOverlay width={width} height={height} pointerX={params.pointerX} pointerY={params.pointerY}>
+        {renderTooltip(params)}
+      </ChartPointerTooltipOverlay>);
+    }, [active, renderTooltip, params, width, height]);
+    return {
+        attachRadialItemTooltipListeners,
+        renderRadialTooltipOverlay,
+    };
+}

package/scatter/index.d.ts

@@ -1,3 +1,4 @@
 export { ScatterChart } from './scatter-chart';
 export type { ScatterChartProps, ScatterSeriesData } from './scatter-chart.props';
+export * from './tooltip';
 //# sourceMappingURL=index.d.ts.map

package/scatter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/chart/scatter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/chart/scatter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,cAAc,WAAW,CAAC"}

package/scatter/index.js

@@ -1 +1,2 @@
 export { ScatterChart } from './scatter-chart';
+export * from './tooltip';

package/scatter/scatter-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scatter-chart.d.ts","sourceRoot":"","sources":["../../../../components/chart/scatter/scatter-chart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAS/D,OAAO,KAAqC,MAAM,OAAO,CAAC;AAI1D,qCAAqC;AACrC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAyVlF,eAAO,MAAM,YAAY;;;;;;;CAEvB,CAAC"}
+{"version":3,"file":"scatter-chart.d.ts","sourceRoot":"","sources":["../../../../components/chart/scatter/scatter-chart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAS/D,OAAO,KAAqC,MAAM,OAAO,CAAC;AAY1D,qCAAqC;AACrC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAsZlF,eAAO,MAAM,YAAY;;;;;;;CAEvB,CAAC"}

package/scatter/scatter-chart.js

@@ -5,7 +5,11 @@ import { LineChart as EChartsLineChart, ScatterChart as EChartsScatterChart } fr
 import { GridComponent, LegendComponent, TooltipComponent, } from 'echarts/components';
 import * as echarts from 'echarts/core';
 import React, { useEffect, useMemo, useRef } from 'react';
-import { getAxis } from '../axis';
+import { View } from 'react-native';
+import { getAxis, valueAxisBoundsFromProps, xAxisBoundsFromProps } from '../axis';
+import { echartsLegendLayoutFragment, mergeCartesianGridForLegend, } from '../legend/echarts-legend-layout';
+import { axisTooltipShowContentFlag } from '../cartesian/tooltip';
+import { createScatterTooltipPreset, useScatterItemTooltip } from './tooltip';
 echarts.use([
     TooltipComponent,
     GridComponent,
@@ -31,12 +35,30 @@ function linearRegression(points) {
     const intercept = (sumY - slope * sumX) / n;
     return { slope, intercept };
 }
-const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', symbolSize = 8, showXAxis = true, showXAxisTicks = true, showYAxis = true, showYAxisTicks = true, showXAxisSplitLines = true, showYAxisSplitLines = true, boundaryGap = false, grid, showLegend = false, showHighlighter = true, showRegressionLine = false, xAxisTickLabelFormatter, yAxisTickLabelFormatter, xAxisTicks, xAxisLabel, yAxisLabel, onSelect, ...props }) => {
+const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', symbolSize = 8, showXAxis = true, showXAxisTicks = true, showYAxis = true, showYAxisTicks = true, showXAxisSplitLines = true, showYAxisSplitLines = true, boundaryGap = false, grid, showLegend = true, legendPosition = 'bottom', showHighlighter = true, tooltip = 'card', showRegressionLine = false, xAxisTickLabelFormatter, yAxisTickLabelFormatter, xAxisLabel, yAxisLabel, minX, maxX, intervalX, minY, maxY, intervalY, onSelect, renderTooltip, ...props }) => {
     const { theme } = useChartTheme(props.theme, props.colors);
     const chartRef = useRef(null);
     const onSelectRef = useRef(onSelect);
     onSelectRef.current = onSelect;
     const selectContextRef = useRef({ normalizedSeries: [] });
+    const themeSeriesRef = useRef(theme.series);
+    themeSeriesRef.current = theme.series;
+    const tooltipOverlayActive = renderTooltip != null || tooltip !== 'none';
+    const renderTooltipFn = useMemo(() => {
+        if (renderTooltip != null)
+            return renderTooltip;
+        if (tooltip === 'none')
+            return () => null;
+        return createScatterTooltipPreset(tooltip);
+    }, [renderTooltip, tooltip]);
+    const { attachScatterItemTooltipListeners, renderScatterTooltipOverlay } = useScatterItemTooltip({
+        active: tooltipOverlayActive,
+        renderTooltip: renderTooltipFn,
+        contextRef: selectContextRef,
+        themeSeriesRef,
+        width,
+        height,
+    });
     const normalizedSeries = useMemo(() => {
         if (!Array.isArray(data) || data.length === 0)
             return [];
@@ -51,29 +73,36 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
     }, [data]);
     const hasNamedSeries = useMemo(() => normalizedSeries.some((s) => 'name' in s && s.name), [normalizedSeries]);
     selectContextRef.current = { normalizedSeries };
+    const valueAxisBounds = useMemo(() => valueAxisBoundsFromProps({ minY, maxY, intervalY }), [minY, maxY, intervalY]);
+    const xAxisBounds = useMemo(() => xAxisBoundsFromProps({ minX, maxX, intervalX }), [minX, maxX, intervalX]);
     const option = useMemo(() => {
         const dataPoints = normalizedSeries.map(s => s.data.map(item => item[0])).flat();
-        const xAxisData = xAxisTicks != null && xAxisTicks.length > 0
-            ? xAxisTicks
-            : getAxis(dataPoints).map(String);
-        const tooltipConfig = showHighlighter
+        const xAxisData = getAxis(dataPoints).map(String);
+        const tooltipConfig = tooltipOverlayActive
             ? {
                 trigger: 'item',
-                axisPointer: {
-                    type: 'cross',
-                    lineStyle: {
+                ...axisTooltipShowContentFlag(true),
+                ...(showHighlighter && {
+                    axisPointer: {
                         type: 'line',
-                        width: 1,
-                        color: theme.series[0]?.color ?? '#999',
+                        lineStyle: {
+                            type: 'line',
+                            width: 1,
+                            color: '#00000000',
+                        },
+                        label: {
+                            show: false,
+                        },
                     },
-                },
+                }),
             }
-            : { trigger: 'item' };
-        // Scatter uses value axes for both x and y (data is [x, y] pairs)
+            : { show: false };
+        // X: category from binned coordinates; Y: value (data is [x, y] pairs)
         const xAxisConfig = {
             type: 'category',
             boundaryGap,
             data: xAxisData,
+            ...(xAxisBounds ?? {}),
             ...(xAxisLabel != null && xAxisLabel !== '' && {
                 name: xAxisLabel,
                 nameLocation: 'middle',
@@ -95,7 +124,7 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
                 }
                 : { show: false },
             axisTick: {
-                show: showXAxisTicks,
+                show: showXAxis && showXAxisTicks,
                 lineStyle: {
                     color: theme.axis.x.tickColor,
                     width: theme.axis.x.tickWidth,
@@ -111,6 +140,7 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
         };
         const yAxisConfig = {
             type: 'value',
+            ...(valueAxisBounds ?? {}),
             ...(yAxisLabel != null && yAxisLabel !== '' && {
                 name: yAxisLabel,
                 nameLocation: 'middle',
@@ -132,7 +162,7 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
                 }
                 : { show: false },
             axisTick: {
-                show: showYAxisTicks,
+                show: showYAxis && showYAxisTicks,
                 lineStyle: {
                     color: theme.axis.y.tickColor,
                     width: theme.axis.y.tickWidth,
@@ -151,6 +181,7 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
                 data: normalizedSeries
                     .filter((s) => 'name' in s && s.name)
                     .map((s) => s.name),
+                ...echartsLegendLayoutFragment(legendPosition),
                 textStyle: {
                     color: theme.legend.textColor,
                     fontSize: theme.legend.fontSize,
@@ -171,7 +202,7 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
                 itemStyle: { color: seriesColor },
                 emphasis: showHighlighter
                     ? {
-                        focus: 'self',
+                        focus: 'none',
                         scale: true,
                         symbol: 'circle',
                         symbolSize: 8,
@@ -219,8 +250,10 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
         };
         if (legendConfig)
             config.legend = legendConfig;
-        if (grid)
-            config.grid = grid;
+        const mergedGrid = mergeCartesianGridForLegend(grid, legendPosition, showLegend, hasNamedSeries);
+        if (mergedGrid !== undefined && Object.keys(mergedGrid).length > 0) {
+            config.grid = mergedGrid;
+        }
         return config;
     }, [
         theme,
@@ -236,21 +269,26 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
         boundaryGap,
         grid,
         showLegend,
+        legendPosition,
         hasNamedSeries,
         showHighlighter,
+        tooltipOverlayActive,
         showRegressionLine,
         xAxisTickLabelFormatter,
         yAxisTickLabelFormatter,
-        xAxisTicks,
         xAxisLabel,
         yAxisLabel,
+        valueAxisBounds,
+        xAxisBounds,
     ]);
     useEffect(() => {
         let chart;
+        let detachScatterTooltip = () => { };
         if (chartRef.current) {
             try {
                 chart = echarts.init(chartRef.current, 'light', { width, height });
                 chart.setOption(option);
+                detachScatterTooltip = attachScatterItemTooltipListeners(chart);
                 const handleSeriesClick = (params) => {
                     const cb = onSelectRef.current;
                     if (typeof cb !== 'function')
@@ -292,6 +330,7 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
             }
         }
         return () => {
+            detachScatterTooltip();
             if (chart) {
                 try {
                     chart.dispose();
@@ -301,8 +340,11 @@ const ChartComponent = ({ data, width = 220, height = 350, symbol = 'circle', sy
                 }
             }
         };
-    }, [option, width, height]);
-    return <SkiaChart ref={chartRef} useRNGH/>;
+    }, [option, width, height, attachScatterItemTooltipListeners]);
+    return (<View style={{ width, height, position: 'relative' }}>
+      <SkiaChart ref={chartRef} useRNGH/>
+      {renderScatterTooltipOverlay()}
+    </View>);
 };
 const ScatterChartComponent = withResponsiveContainer(withChartTheme(ChartComponent));
 export const ScatterChart = Object.assign(ScatterChartComponent, {

package/scatter/scatter-chart.props.d.ts

@@ -1,4 +1,6 @@
 import type { CartesianChartProps } from '../props/cartesian';
+import type { ReactNode } from 'react';
+import type { ScatterItemTooltipParams } from './tooltip/scatter-item-tooltip.types';
 /**
  * Scatter data: array of [x, y] pairs per series.
  * - Single series: number[][]
@@ -12,7 +14,7 @@ export type ScatterSeriesData = number[][] | Array<{
  * Props for ScatterChart.
  * common -> cartesian -> scatter
  */
-export interface ScatterChartProps extends CartesianChartProps {
+export interface ScatterChartProps extends Omit<CartesianChartProps, 'renderTooltip'> {
     /**
      * Scatter data: array of [x, y] pairs per series.
      */
@@ -32,5 +34,9 @@ export interface ScatterChartProps extends CartesianChartProps {
      * @default false
      */
     showRegressionLine?: boolean;
+    /**
+     * Overrides the default React Native **item** tooltip body (scatter points; see {@link ScatterItemTooltipParams}).
+     */
+    renderTooltip?: (params: ScatterItemTooltipParams) => ReactNode;
 }
 //# sourceMappingURL=scatter-chart.props.d.ts.map

package/scatter/scatter-chart.props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scatter-chart.props.d.ts","sourceRoot":"","sources":["../../../../components/chart/scatter/scatter-chart.props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,EAAE,EAAE,GACV,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IACtG;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzE;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}
+{"version":3,"file":"scatter-chart.props.d.ts","sourceRoot":"","sources":["../../../../components/chart/scatter/scatter-chart.props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,EAAE,EAAE,GACV,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC;IACnF;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IACtG;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzE;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,SAAS,CAAC;CACjE"}

package/scatter/tooltip/default-scatter-tooltip.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { ChartTheme } from '../../chart-theme.context';
+import type { ScatterItemTooltipParams } from './scatter-item-tooltip.types';
+/**
+ * Themed default scatter/bubble item tooltip (React Native).
+ */
+export declare function createDefaultScatterTooltip(theme: Pick<ChartTheme, 'tooltip'>): (params: ScatterItemTooltipParams) => React.ReactElement;
+//# sourceMappingURL=default-scatter-tooltip.d.ts.map

package/scatter/tooltip/default-scatter-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-scatter-tooltip.d.ts","sourceRoot":"","sources":["../../../../../components/chart/scatter/tooltip/default-scatter-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE7E;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,GACjC,CAAC,MAAM,EAAE,wBAAwB,KAAK,KAAK,CAAC,YAAY,CAuC1D"}