import { ProviderInstanceIcon } from "../chat/ProviderInstanceIcon"; import type { UsageProviderKind } from "@t3tools/contracts"; import { T, useGT, useLocale, useMessages } from "gt-react"; import { useLayoutEffect, useRef, useState } from "react"; import type { DailyTotals, HourlyTotals } from "@t3tools/shared/usageMerge"; import { formatDayShort, formatHourShort, formatTokens, formatUsd, } from "@t3tools/shared/usageFormat"; import { formatRelativeHourShort } from "@t3tools/shared/usageFormatCopy"; import { cn } from "~/lib/utils"; import { PROVIDER_ORDER, PROVIDER_PRESENTATION } from "./usageProviders"; import { observeResize } from "~/lib/observeResize"; const VIEW_WIDTH = 960; const VIEW_HEIGHT = 260; const TICK_COUNT = 4; const PLOT_TOP = 8; const NONE_LOADING: ReadonlySet = new Set(); export type UsageChartMetric = "tokens" | "cost"; interface UsageProviderChartProps { readonly providers: readonly UsageProviderKind[]; readonly loadingProviders?: ReadonlySet; readonly days: readonly string[]; readonly daily: readonly DailyTotals[]; readonly hours: readonly string[]; readonly hourly: readonly HourlyTotals[]; readonly metric: UsageChartMetric; readonly resolution: "day" | "hour"; readonly timeZone: string; readonly hour12: boolean; } export interface DayColumn { readonly bands: readonly { readonly provider: UsageProviderKind; readonly value: number; }[]; readonly total: number; } interface Point { readonly x: number; readonly y: number; } function valueFor( totals: DailyTotals | HourlyTotals | undefined, provider: UsageProviderKind, metric: UsageChartMetric, ): number { const entry = totals?.byProvider.get(provider); if (entry === undefined) return 0; return metric === "tokens" ? entry.totalTokens : entry.costUsd; } export function buildPeriodColumns( periods: readonly string[], byPeriod: ReadonlyMap, metric: UsageChartMetric, ): readonly DayColumn[] { return periods.map((period) => { const entry = byPeriod.get(period); const bands = PROVIDER_ORDER.map((provider) => ({ provider, value: valueFor(entry, provider, metric), })); return { bands, total: bands.reduce((sum, band) => sum + band.value, 0) }; }); } function monotoneTangents(points: readonly Point[]): readonly number[] { const count = points.length; if (count < 2) return [0]; const slopes: number[] = []; for (let index = 0; index < count - 1; index += 1) { const dx = (points[index + 1]?.x ?? 0) - (points[index]?.x ?? 0); const dy = (points[index + 1]?.y ?? 0) - (points[index]?.y ?? 0); slopes.push(dx === 0 ? 0 : dy / dx); } const tangents: number[] = Array.from({ length: count }, () => 0); tangents[0] = slopes[0] ?? 0; tangents[count - 1] = slopes[count - 2] ?? 0; for (let index = 1; index < count - 1; index += 1) { const previous = slopes[index - 1] ?? 0; const next = slopes[index] ?? 0; tangents[index] = previous * next <= 0 ? 0 : (previous + next) / 2; } for (let index = 0; index < count - 1; index += 1) { const slope = slopes[index] ?? 0; if (slope === 0) { tangents[index] = 0; tangents[index + 1] = 0; continue; } const a = (tangents[index] ?? 0) / slope; const b = (tangents[index + 1] ?? 0) / slope; const magnitude = a * a + b * b; if (magnitude > 9) { const scale = 3 / Math.sqrt(magnitude); tangents[index] = scale * a * slope; tangents[index + 1] = scale * b * slope; } } return tangents; } interface CurveSegment { readonly from: Point; readonly c1: Point; readonly c2: Point; readonly to: Point; } function smoothCurve(points: readonly Point[]): readonly CurveSegment[] { if (points.length < 2) return []; const tangents = monotoneTangents(points); const segments: CurveSegment[] = []; for (let index = 0; index < points.length - 1; index += 1) { const from = points[index]; const to = points[index + 1]; if (from === undefined || to === undefined) continue; const dx = to.x - from.x; segments.push({ from, c1: { x: from.x + dx / 3, y: from.y + ((tangents[index] ?? 0) * dx) / 3 }, c2: { x: to.x - dx / 3, y: to.y - ((tangents[index + 1] ?? 0) * dx) / 3 }, to, }); } return segments; } function curvePath(segments: readonly CurveSegment[]): string { const first = segments[0]; if (first === undefined) return ""; let path = `M${first.from.x.toFixed(2)},${first.from.y.toFixed(2)}`; for (const segment of segments) { path += ` C${segment.c1.x.toFixed(2)},${segment.c1.y.toFixed(2)} ${segment.c2.x.toFixed(2)},${segment.c2.y.toFixed(2)} ${segment.to.x.toFixed(2)},${segment.to.y.toFixed(2)}`; } return path; } function areaPath(line: string) { return line === "" ? "" : `${line} L${VIEW_WIDTH},${VIEW_HEIGHT} L0,${VIEW_HEIGHT} Z`; } function niceScale(peak: number, count: number): { max: number; ticks: readonly number[] } { if (peak <= 0) return { max: 0, ticks: [0] }; const rawStep = peak / count; const magnitude = 10 ** Math.floor(Math.log10(rawStep)); const normalized = rawStep / magnitude; const step = (normalized > 5 ? 10 : normalized > 2 ? 5 : normalized > 1 ? 2 : 1) * magnitude; const max = Math.ceil(peak / step) * step; const ticks: number[] = []; for (let value = 0; value <= max + step * 1e-6; value += step) ticks.push(value); return { max, ticks }; } const PLACEHOLDER_TICKS = Array.from({ length: TICK_COUNT + 1 }, (_, index) => index); function chartScale( columns: readonly DayColumn[], loadingProviders: ReadonlySet, ) { // Layered series each start at zero; summing peaks would waste plot height. const peak = columns.reduce( (max, column) => column.bands.reduce((inner, band) => Math.max(inner, band.value), max), 0, ); return peak === 0 && loadingProviders.size > 0 ? { max: TICK_COUNT, ticks: PLACEHOLDER_TICKS, labeled: false } : { ...niceScale(peak, TICK_COUNT), labeled: true }; } function valueToY(value: number, max: number) { return max === 0 ? VIEW_HEIGHT : VIEW_HEIGHT - (value / max) * (VIEW_HEIGHT - PLOT_TOP); } function buildChart( periods: readonly string[], byPeriod: ReadonlyMap, metric: UsageChartMetric, providers: readonly UsageProviderKind[], loadingProviders: ReadonlySet, ) { const columns = buildPeriodColumns(periods, byPeriod, metric); const scale = chartScale(columns, loadingProviders); const stepX = periods.length < 2 ? 0 : VIEW_WIDTH / (periods.length - 1); const paths = providers.map((provider) => { const slot = PROVIDER_ORDER.indexOf(provider); const line = curvePath( smoothCurve( columns.map((column, periodIndex) => ({ x: periodIndex * stepX, y: valueToY(column.bands[slot]?.value ?? 0, scale.max), })), ), ); return { provider, loading: loadingProviders.has(provider), total: columns.reduce((sum, column) => sum + (column.bands[slot]?.value ?? 0), 0), line, area: areaPath(line), }; }); return { columns, scale, stepX, paths: paths.toSorted((a, b) => b.total - a.total) }; } function UsageChartTooltip({ tooltipRef, label, column, providers, loadingProviders, format, }: { readonly tooltipRef: React.Ref; readonly label: string; readonly column: DayColumn | undefined; readonly providers: readonly UsageProviderKind[]; readonly loadingProviders: ReadonlySet; readonly format: (value: number) => string; }) { const partial = providers.some((provider) => loadingProviders.has(provider)); return (
{label}
{providers.map((provider) => { const { label: providerLabel, driverKind } = PROVIDER_PRESENTATION[provider]; return (
{providerLabel} {format(column?.bands.find((band) => band.provider === provider)?.value ?? 0)}
); })}
Total {format(column?.total ?? 0)}
); } function UsageChartPlot({ periods, columns, stepX, providers, loadingProviders, format, formatTooltipPeriod, children, }: { readonly periods: readonly string[]; readonly columns: readonly DayColumn[]; readonly stepX: number; readonly providers: readonly UsageProviderKind[]; readonly loadingProviders: ReadonlySet; readonly format: (value: number) => string; readonly formatTooltipPeriod: (period: string) => string; readonly children: React.ReactNode; }) { const [hoverIndex, setHoverIndex] = useState(null); const plotRef = useRef(null); const tooltipRef = useRef(null); const hoverPositionRef = useRef<{ x: number; y: number } | null>(null); const positionTooltip = () => { const plot = plotRef.current; const tooltip = tooltipRef.current; const hoverPosition = hoverPositionRef.current; if (plot === null || tooltip === null || hoverPosition === null) return; const gap = 12; const tooltipWidth = tooltip.offsetWidth; const tooltipHeight = tooltip.offsetHeight; const plotWidth = plot.clientWidth; const plotHeight = plot.clientHeight; const preferredLeft = hoverPosition.x + gap + tooltipWidth <= plotWidth ? hoverPosition.x + gap : hoverPosition.x - gap - tooltipWidth; const preferredTop = hoverPosition.y + gap + tooltipHeight <= plotHeight ? hoverPosition.y + gap : hoverPosition.y - gap - tooltipHeight; const left = Math.min(Math.max(0, preferredLeft), Math.max(0, plotWidth - tooltipWidth)); const top = Math.min(Math.max(0, preferredTop), Math.max(0, plotHeight - tooltipHeight)); plot.style.setProperty("--usage-tooltip-left", `${left}px`); plot.style.setProperty("--usage-tooltip-top", `${top}px`); }; // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- positions the hover tooltip through plot CSS variables before paint and on ResizeObserver useLayoutEffect(() => { if (hoverIndex === null) return; positionTooltip(); const plot = plotRef.current; const tooltip = tooltipRef.current; if (plot === null || tooltip === null) return; return observeResize([plot, tooltip], positionTooltip); }, [hoverIndex, positionTooltip]); const handleMove = (event: React.MouseEvent) => { const plot = plotRef.current; if (plot === null || periods.length === 0) return; const bounds = plot.getBoundingClientRect(); if (bounds.width === 0) return; const localX = Math.min(bounds.width, Math.max(0, event.clientX - bounds.left)); const localY = Math.min(bounds.height, Math.max(0, event.clientY - bounds.top)); const fraction = localX / bounds.width; const index = Math.round(fraction * (periods.length - 1)); hoverPositionRef.current = { x: localX, y: localY }; positionTooltip(); setHoverIndex(Math.min(periods.length - 1, Math.max(0, index))); }; const hoveredPeriod = hoverIndex === null ? undefined : periods[hoverIndex]; return (
{ hoverPositionRef.current = null; setHoverIndex(null); }} > {children} {hoverIndex === null ? null : ( )} {hoverIndex === null || hoveredPeriod === undefined ? null : ( )}
); } export function UsageProviderChart({ providers, loadingProviders = NONE_LOADING, days, daily, hours, hourly, metric, resolution, timeZone, hour12, }: UsageProviderChartProps) { const gt = useGT(); const locale = useLocale(); const m = useMessages(); const periods = resolution === "hour" ? hours : days; const totals: readonly (DailyTotals | HourlyTotals)[] = resolution === "hour" ? hourly : daily; const byPeriod = new Map( totals.map((entry) => ["hourStart" in entry ? entry.hourStart : entry.day, entry]), ); // An hourly window ends with the hour in progress. const latestHour = resolution === "hour" ? periods.at(-1) : undefined; const { columns, scale, paths, stepX } = buildChart( periods, byPeriod, metric, providers, loadingProviders, ); const toY = (value: number) => valueToY(value, scale.max); const seriesClassName = (loading: boolean) => cn("transition-opacity", loading && "opacity-40 delay-150"); const format = metric === "tokens" ? formatTokens : (value: number) => formatUsd(value, locale); const formatPeriod = (period: string) => resolution === "hour" ? formatHourShort(period, timeZone, hour12, locale) : formatDayShort(period, locale); const formatTooltipPeriod = (period: string) => latestHour !== undefined ? formatRelativeHourShort(period, latestHour, timeZone, hour12, m, locale) : formatPeriod(period); return (
{scale.labeled ? scale.ticks.map((tick) => ( {tick === 0 ? "0" : format(tick)} )) : null}
{scale.ticks.map((tick) => { const y = toY(tick); return ( ); })} {paths.map(({ provider, loading, area }) => ( ))} {paths.map(({ provider, loading, line }) => ( ))}
{periods[0] === undefined ? "" : formatPeriod(periods[0])} {periods[Math.floor(periods.length / 2)] === undefined ? "" : formatPeriod(periods[Math.floor(periods.length / 2)] ?? "")} {periods[periods.length - 1] === undefined ? "" : formatPeriod(periods[periods.length - 1] ?? "")}
{/* The plot and its axes are hover-only; this carries the same figures for screen readers. sr-only sits on a wrapper: Firefox does not clip a table's caption by the table's own box. */}
{providers.map((provider) => ( ))} {providers.length > 1 ? ( ) : null} {periods.map((period, index) => { const column = columns[index]; return ( {providers.map((provider) => ( ))} {providers.length > 1 ? : null} ); })}
{resolution === "hour" ? metric === "tokens" ? gt("Hourly processed tokens by provider") : gt("Hourly cost by provider") : metric === "tokens" ? gt("Daily processed tokens by provider") : gt("Daily cost by provider")}
{resolution === "hour" ? gt("Hour") : gt("Day")} {PROVIDER_PRESENTATION[provider].label} Total
{formatTooltipPeriod(period)} {format(column?.bands.find((band) => band.provider === provider)?.value ?? 0)} {format(column?.total ?? 0)}
); }