Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

3.1 KB
Raw Blame
import { type ReactElement, useMemo, useState } from 'react'

import { emptyStateIllustration } from '@posthog/mcp-ui'
import { Empty, EmptyDescription, EmptyHeader, EmptyMedia } from '@posthog/quill'
import { TimeSeriesBarChart, TimeSeriesLineChart, type TooltipConfig } from '@posthog/quill-charts'

import { buildRetentionChartModel } from 'products/product_analytics/frontend/insights/retention/shared/retentionChartTransforms'

import { ChartHeader } from './ChartHeader'
import { Select } from './charts'
import { colorAt, useMcpChartTheme } from './charts/theme'
import type { RetentionVisualizerProps } from './types'

type ChartMode = 'line' | 'bar'

const TITLE = 'Retention'

const CHART_MODE_OPTIONS = [
    { value: 'line' as const, label: 'Line' },
    { value: 'bar' as const, label: 'Bar' },
]

const TOOLTIP_CONFIG: TooltipConfig = { pinnable: true, placement: 'top' }

export function RetentionVisualizer({ query, results }: RetentionVisualizerProps): ReactElement {
    const [chartMode, setChartMode] = useState<ChartMode>(
        query?.retentionFilter?.display === 'ActionsBar' ? 'bar' : 'line'
    )
    const theme = useMcpChartTheme()

    // No cohort cap — mirrors the web, which renders every cohort and lets colors wrap past the palette.
    const { series, labels, lineConfig, barConfig } = useMemo(
        () =>
            buildRetentionChartModel(results ?? [], {
                aggregationType: query?.retentionFilter?.aggregationType ?? 'count',
                reference: query?.retentionFilter?.retentionReference ?? 'total',
                period: query?.retentionFilter?.period ?? 'Day',
                showTrendLines: query?.retentionFilter?.showTrendLines ?? false,
                getColor: colorAt,
                tooltip: TOOLTIP_CONFIG,
            }),
        [
            results,
            query?.retentionFilter?.aggregationType,
            query?.retentionFilter?.retentionReference,
            query?.retentionFilter?.period,
            query?.retentionFilter?.showTrendLines,
        ]
    )

    if (!results || results.length === 0 || series.length === 0 || labels.length === 0) {
        return (
            <div>
                <ChartHeader title={TITLE} />
                <Empty>
                    <EmptyHeader>
                        <EmptyMedia>{emptyStateIllustration('chart')}</EmptyMedia>
                        <EmptyDescription>No retention data available</EmptyDescription>
                    </EmptyHeader>
                </Empty>
            </div>
        )
    }

    return (
        <div>
            <ChartHeader title={TITLE}>
                {/* eslint-disable-next-line react/forbid-elements */}
                <Select value={chartMode} onChange={setChartMode} options={CHART_MODE_OPTIONS} />
            </ChartHeader>
            <div className="flex flex-col w-full h-[400px]">
                {chartMode === 'bar' ? (
                    <TimeSeriesBarChart series={series} labels={labels} theme={theme} config={barConfig} />
                ) : (
                    <TimeSeriesLineChart series={series} labels={labels} theme={theme} config={lineConfig} />
                )}
            </div>
        </div>
    )
}