Skip to content

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

1.9 KB
Raw Blame
// Pure presentational constants + helpers shared by the live composer and
// the autocomplete popover. A separate module (not a component file) so the
// component files keep Fast Refresh eligibility.

import type { ComposerSegment } from "@/src/features/search-bar/lib/composer-segments";
import type { FieldRegistry } from "@/src/features/search-bar/lib/fields";

/** Per-view: the examples have to name fields the view actually has. */
export function composerPlaceholder(registry: FieldRegistry): string {
  if (registry.searchPlaceholder) return registry.searchPlaceholder;
  return registry.searchExamples.length > 0
    ? `Search — e.g. ${registry.searchExamples.join(", ")}`
    : "Search";
}

/** DOM id for an option row — referenced by aria-activedescendant. Option ids
 *  embed observed values (`value:My Test Trace`) and recent queries, which can
 *  contain whitespace; an id with whitespace is invalid HTML and breaks the
 *  aria-activedescendant IDREF. encodeURIComponent escapes whitespace (→ `%20`)
 *  while leaving underscore literal, so it is injective — distinct option ids
 *  always map to distinct DOM ids (a `\s+ → _` collapse would alias
 *  `My Test`/`My_Test` to the same duplicate id). */
export function optionDomId(listboxId: string, optionId: string): string {
  return `${listboxId}-opt-${encodeURIComponent(optionId)}`;
}

/**
 * Why this token is NOT applied on the current surface (e.g. a column the chart
 * view can't filter on), or null when it is. Shared by the token styling (dim +
 * strike) and the hover tooltip so both read the same source.
 */
export function deactivationReason(
  segment: ComposerSegment,
  fieldReason?: (field: string) => string | null,
  freeTextReason?: string | null,
): string | null {
  if (segment.kind === "filter")
    return fieldReason?.(segment.displayField) ?? null;
  if (segment.kind === "freeText") return freeTextReason ?? null;
  return null;
}