Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

4.2 KB
Raw Blame
import { useCallback } from "react";
import { ExternalLink } from "@langfuse/icons";
import { ScoreCombobox, type ScoreOption } from "./charts/ScoreCombobox";
import { ObjectTypeFilter } from "./charts/ObjectTypeFilter";
import { TimeRangePicker } from "@/src/components/date-picker";
import {
  DASHBOARD_AGGREGATION_OPTIONS,
  type TimeRange,
} from "@/src/utils/date-range-utils";
import { useAnalyticsUrlState } from "@/src/features/score-analytics/lib/analytics-url-state";
import { Badge } from "@/src/components/design-system/Badge/Badge";
import { HoverCard } from "@/src/components/design-system/HoverCard/HoverCard";

export interface ScoreAnalyticsHeaderProps {
  scoreOptions: ScoreOption[];
  timeRange: TimeRange;
  onTimeRangeChange: (range: TimeRange) => void;
  compatibleScore2DataTypes?: string | string[];
}

/**
 * ScoreAnalyticsHeader - Header controls for score analytics
 *
 * Provides UI controls for:
 * - Score 1 selector (required)
 * - Score 2 selector (optional, for comparison)
 * - Object type filter (all, trace, session, observation, dataset_run)
 * - Time range picker
 *
 * Uses useAnalyticsUrlState hook to sync selections with URL query params.
 * Automatically clears score2 when score1 is cleared.
 *
 * Layout:
 * - Mobile: Stacked controls
 * - Desktop: Left (score selectors) | Spacer | Right (filters)
 */
export function ScoreAnalyticsHeader({
  scoreOptions,
  timeRange,
  onTimeRangeChange,
  compatibleScore2DataTypes,
}: ScoreAnalyticsHeaderProps) {
  const urlStateHook = useAnalyticsUrlState();
  const { state: urlState, setScore2, setObjectType } = urlStateHook;

  // Wrapper that clears score2 when score1 is cleared
  const setScore1 = useCallback(
    (value: string | undefined) => {
      urlStateHook.setScore1(value);

      // Always clear score2 when clearing score1
      if (value === undefined) {
        urlStateHook.setScore2(undefined);
      }
    },
    [urlStateHook],
  );

  return (
    <div className="border-border flex flex-col gap-1 border-b p-2 lg:flex-row lg:items-center lg:gap-4">
      {/* Left: Score Selectors */}
      <div className="flex items-center gap-2">
        <ScoreCombobox
          value={urlState.score1}
          onChange={setScore1}
          options={scoreOptions}
          placeholder="First score"
          className="h-8 w-[200px]"
        />
        <ScoreCombobox
          value={urlState.score2}
          onChange={setScore2}
          options={scoreOptions}
          placeholder="Second score"
          filterByDataType={compatibleScore2DataTypes}
          disabled={!urlState.score1}
          className="h-8 w-[200px]"
        />
        <HoverCard
          content={
            <div className="w-80 p-3">
              <div className="space-y-2">
                <h4 className="text-sm font-bold">Beta Feature</h4>
                <p className="text-muted-foreground text-sm">
                  Score analytics is currently in beta. We&apos;re actively
                  improving this feature and would love to hear your feedback.
                </p>
                <a
                  href="https://langfuse.com/discussions"
                  target="_blank"
                  rel="noopener noreferrer"
                  className="text-primary inline-flex items-center gap-1 text-sm font-bold hover:underline"
                >
                  Share feedback on GitHub Discussions
                  <ExternalLink size="sm" />
                </a>
              </div>
            </div>
          }
        >
          {({ getTriggerProps }) => (
            <Badge
              color="yellow"
              text="Beta Feature"
              tabIndex={0}
              {...getTriggerProps()}
            />
          )}
        </HoverCard>
      </div>

      {/* Middle: Spacer (hidden on mobile) */}
      <div className="hidden flex-1 lg:block" />

      {/* Right: Filters */}
      <div className="flex items-center gap-2">
        <ObjectTypeFilter
          value={urlState.objectType}
          onChange={setObjectType}
          className="h-8 w-[140px]"
        />
        <TimeRangePicker
          timeRange={timeRange}
          onTimeRangeChange={onTimeRangeChange}
          timeRangePresets={DASHBOARD_AGGREGATION_OPTIONS}
          className="my-0"
        />
      </div>
    </div>
  );
}