{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "span-timeline-chart",
  "title": "Span Timeline Chart",
  "description": "See where the time goes in one request: every step as a bar on a shared time axis, nested under the step that started it, with a click to focus one branch.",
  "dependencies": [
    "clsx",
    "tailwind-merge"
  ],
  "files": [
    {
      "path": "registry/new-york/span-timeline-chart/span-timeline-chart.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nexport interface TimelineSpan {\n  id: string;\n  name: string;\n  /** Groups spans by colour, e.g. \"api\" or \"db\". */\n  service: string;\n  /** Milliseconds from the start of the run. */\n  start: number;\n  /** Milliseconds. */\n  duration: number;\n  /** id of the span that started this one. */\n  parent?: string;\n}\n\nexport interface TimelineRun {\n  label: string;\n  spans: TimelineSpan[];\n}\n\nexport interface SpanTimelineChartProps extends Omit<\n  React.ComponentPropsWithoutRef<\"section\">,\n  \"title\"\n> {\n  theme?: \"dark\" | \"light\";\n  title?: string;\n  subtitle?: string;\n  runs?: TimelineRun[];\n  /** Colour per service. Services not listed get the neutral colour. */\n  colors?: Record<string, string>;\n  /** Height of each row, in px. */\n  rowHeight?: number;\n  formatTime?: (ms: number) => string;\n  onSpanSelect?: (span: TimelineSpan | null) => void;\n}\n\nconst PALETTES = {\n  dark: {\n    card: \"#08090A\",\n    border: \"rgba(255,255,255,0.08)\",\n    grid: \"rgba(255,255,255,0.05)\",\n    text: \"#F7F8F8\",\n    soft: \"#D0D6E0\",\n    sub: \"#8A8F98\",\n    faint: \"#62666D\",\n    chip: \"rgba(255,255,255,0.05)\",\n    chipOn: \"rgba(255,255,255,0.1)\",\n    neutral: \"#8A8F98\",\n    rowOn: \"rgba(255,255,255,0.04)\",\n  },\n  light: {\n    card: \"#FFFFFF\",\n    border: \"rgba(8,9,10,0.08)\",\n    grid: \"rgba(8,9,10,0.06)\",\n    text: \"#08090A\",\n    soft: \"#3C3F44\",\n    sub: \"#62666D\",\n    faint: \"#8A8F98\",\n    chip: \"rgba(8,9,10,0.04)\",\n    chipOn: \"#FFFFFF\",\n    neutral: \"#8A8F98\",\n    rowOn: \"rgba(8,9,10,0.03)\",\n  },\n};\n\ntype Palette = (typeof PALETTES)[\"dark\"];\n\nconst CARD_FONT =\n  '\"Inter Variable\", Inter, \"SF Pro Display\", -apple-system, BlinkMacSystemFont, sans-serif';\nconst EASE = \"cubic-bezier(0.22, 1, 0.36, 1)\";\nconst RING = \"outline-none focus-visible:ring-2 focus-visible:ring-[#5E6AD2]\";\n\nconst COLORS: Record<string, string> = {\n  web: \"#5E6AD2\",\n  api: \"#4EA7FC\",\n  db: \"#A2A9F4\",\n  queue: \"#FC7840\",\n};\n\nconst RUNS: TimelineRun[] = [\n  {\n    label: \"Checkout\",\n    spans: [\n      {\n        id: \"a\",\n        name: \"POST /checkout\",\n        service: \"web\",\n        start: 0,\n        duration: 486,\n      },\n      {\n        id: \"b\",\n        name: \"auth.verify\",\n        service: \"api\",\n        start: 8,\n        duration: 34,\n        parent: \"a\",\n      },\n      {\n        id: \"c\",\n        name: \"cart.load\",\n        service: \"api\",\n        start: 46,\n        duration: 92,\n        parent: \"a\",\n      },\n      {\n        id: \"d\",\n        name: \"select cart_items\",\n        service: \"db\",\n        start: 52,\n        duration: 58,\n        parent: \"c\",\n      },\n      {\n        id: \"e\",\n        name: \"payments.charge\",\n        service: \"api\",\n        start: 146,\n        duration: 248,\n        parent: \"a\",\n      },\n      {\n        id: \"f\",\n        name: \"fraud.score\",\n        service: \"api\",\n        start: 152,\n        duration: 86,\n        parent: \"e\",\n      },\n      {\n        id: \"g\",\n        name: \"insert payment\",\n        service: \"db\",\n        start: 312,\n        duration: 44,\n        parent: \"e\",\n      },\n      {\n        id: \"h\",\n        name: \"email.receipt\",\n        service: \"queue\",\n        start: 398,\n        duration: 62,\n        parent: \"a\",\n      },\n      {\n        id: \"i\",\n        name: \"update order\",\n        service: \"db\",\n        start: 404,\n        duration: 38,\n        parent: \"a\",\n      },\n    ],\n  },\n  {\n    label: \"Search\",\n    spans: [\n      { id: \"a\", name: \"GET /search\", service: \"web\", start: 0, duration: 212 },\n      {\n        id: \"b\",\n        name: \"auth.verify\",\n        service: \"api\",\n        start: 6,\n        duration: 22,\n        parent: \"a\",\n      },\n      {\n        id: \"c\",\n        name: \"query.parse\",\n        service: \"api\",\n        start: 30,\n        duration: 18,\n        parent: \"a\",\n      },\n      {\n        id: \"d\",\n        name: \"index.lookup\",\n        service: \"api\",\n        start: 50,\n        duration: 104,\n        parent: \"a\",\n      },\n      {\n        id: \"e\",\n        name: \"select products\",\n        service: \"db\",\n        start: 58,\n        duration: 72,\n        parent: \"d\",\n      },\n      {\n        id: \"f\",\n        name: \"rank.results\",\n        service: \"api\",\n        start: 158,\n        duration: 34,\n        parent: \"a\",\n      },\n      {\n        id: \"g\",\n        name: \"log.query\",\n        service: \"queue\",\n        start: 196,\n        duration: 12,\n        parent: \"a\",\n      },\n    ],\n  },\n  {\n    label: \"Sign in\",\n    spans: [\n      {\n        id: \"a\",\n        name: \"POST /session\",\n        service: \"web\",\n        start: 0,\n        duration: 318,\n      },\n      {\n        id: \"b\",\n        name: \"rate.limit\",\n        service: \"api\",\n        start: 4,\n        duration: 10,\n        parent: \"a\",\n      },\n      {\n        id: \"c\",\n        name: \"select user\",\n        service: \"db\",\n        start: 18,\n        duration: 26,\n        parent: \"a\",\n      },\n      {\n        id: \"d\",\n        name: \"password.check\",\n        service: \"api\",\n        start: 48,\n        duration: 182,\n        parent: \"a\",\n      },\n      {\n        id: \"e\",\n        name: \"session.create\",\n        service: \"api\",\n        start: 236,\n        duration: 46,\n        parent: \"a\",\n      },\n      {\n        id: \"f\",\n        name: \"insert session\",\n        service: \"db\",\n        start: 244,\n        duration: 30,\n        parent: \"e\",\n      },\n      {\n        id: \"g\",\n        name: \"audit.write\",\n        service: \"queue\",\n        start: 288,\n        duration: 22,\n        parent: \"a\",\n      },\n    ],\n  },\n];\n\nconst FORMAT = (ms: number) =>\n  ms >= 1000 ? `${(ms / 1000).toFixed(2)} s` : `${Math.round(ms)} ms`;\n\nfunction useWidth<T extends HTMLElement>(fallback: number) {\n  const ref = React.useRef<T>(null);\n  const [width, setWidth] = React.useState(fallback);\n  React.useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const ro = new ResizeObserver(([entry]) => {\n      setWidth(Math.round(entry.contentRect.width));\n    });\n    ro.observe(el);\n    return () => ro.disconnect();\n  }, []);\n  return [ref, width] as const;\n}\n\n/** Drawn as SVG, because a tiny border-radius circle turns lumpy on 1x screens. */\nfunction Dot({ size, color }: { size: number; color: string }) {\n  const r = size / 2;\n  return (\n    <svg\n      aria-hidden=\"true\"\n      width={size}\n      height={size}\n      viewBox={`0 0 ${size} ${size}`}\n      className=\"block shrink-0\"\n    >\n      <circle cx={r} cy={r} r={r} style={{ fill: color }} />\n    </svg>\n  );\n}\n\nfunction Stat({\n  value,\n  label,\n  pal,\n}: {\n  value: string;\n  label: string;\n  pal: Palette;\n}) {\n  return (\n    <div className=\"min-w-0 text-left sm:text-right\">\n      <p className=\"m-0 truncate text-[18px] leading-[1.2] font-[510] tracking-[-0.018em] tabular-nums\">\n        {value}\n      </p>\n      <p\n        className=\"m-0 mt-0.5 text-[12px] tracking-[-0.011em] whitespace-nowrap\"\n        style={{ color: pal.sub }}\n      >\n        {label}\n      </p>\n    </div>\n  );\n}\n\nfunction Pills({\n  label,\n  options,\n  value,\n  onChange,\n  pal,\n}: {\n  label: string;\n  options: string[];\n  value: number;\n  onChange: (index: number) => void;\n  pal: Palette;\n}) {\n  return (\n    <div\n      className=\"flex rounded-full p-0.5\"\n      style={{ background: pal.chip }}\n      role=\"radiogroup\"\n      aria-label={label}\n    >\n      {options.map((option, i) => (\n        <button\n          key={option}\n          type=\"button\"\n          role=\"radio\"\n          aria-checked={i === value}\n          data-run={option}\n          onClick={() => onChange(i)}\n          className={`h-7 cursor-pointer rounded-full border-0 px-3 text-[13px] font-[510] tracking-[-0.011em] whitespace-nowrap transition-colors ${RING}`}\n          style={{\n            background: i === value ? pal.chipOn : \"transparent\",\n            color: i === value ? pal.text : pal.sub,\n          }}\n        >\n          {option}\n        </button>\n      ))}\n    </div>\n  );\n}\n\n/** Dark or light text, whichever reads better on the bar. */\nconst ink = (hex: string) => {\n  const n = parseInt(hex.replace(\"#\", \"\").slice(0, 6), 16);\n  if (Number.isNaN(n)) return \"#FFFFFF\";\n  const [r, g, b] = [n >> 16, (n >> 8) & 255, n & 255];\n  return 0.299 * r + 0.587 * g + 0.114 * b > 150 ? \"#08090A\" : \"#FFFFFF\";\n};\n\nconst niceStep = (span: number, count: number) => {\n  const raw = span / Math.max(count, 1);\n  const p = 10 ** Math.floor(Math.log10(raw));\n  const n = raw / p;\n  return (n <= 1 ? 1 : n <= 2 ? 2 : n <= 5 ? 5 : 10) * p;\n};\n\nexport function SpanTimelineChart({\n  theme = \"dark\",\n  title = \"Request timeline\",\n  subtitle = \"Where the time goes in one request, span by span.\",\n  runs = RUNS,\n  colors = COLORS,\n  rowHeight = 30,\n  formatTime = FORMAT,\n  onSpanSelect,\n  className,\n  style,\n  ...props\n}: SpanTimelineChartProps) {\n  const pal = PALETTES[theme];\n  const [runIndex, setRunIndex] = React.useState(0);\n  const [selected, setSelected] = React.useState<string | null>(null);\n  const [hover, setHover] = React.useState<string | null>(null);\n  const [seen, setSeen] = React.useState(false);\n  const [plotRef, width] = useWidth<HTMLDivElement>(520);\n\n  React.useEffect(() => {\n    const el = plotRef.current;\n    if (!el) return;\n    const io = new IntersectionObserver(\n      ([entry]) => {\n        if (!entry.isIntersecting) return;\n        io.disconnect();\n        setSeen(true);\n      },\n      { threshold: 0.2 },\n    );\n    io.observe(el);\n    return () => io.disconnect();\n  }, [plotRef]);\n\n  const run = runs[runIndex] ?? runs[0];\n  const spans = run?.spans ?? [];\n  const rows = Math.max(1, ...runs.map((r) => r.spans.length));\n  const end = Math.max(1, ...spans.map((s) => s.start + s.duration));\n  const step = niceStep(end, width < 360 ? 3 : 5);\n  const ticks: number[] = [];\n  for (let t = 0; t <= end; t += step) ticks.push(t);\n\n  const byId = new Map(spans.map((s) => [s.id, s]));\n  const depthOf = (s: TimelineSpan) => {\n    let d = 0;\n    let p = s.parent ? byId.get(s.parent) : undefined;\n    while (p && d < 8) {\n      d += 1;\n      p = p.parent ? byId.get(p.parent) : undefined;\n    }\n    return d;\n  };\n  const isInside = (s: TimelineSpan, root: string) => {\n    let cur: TimelineSpan | undefined = s;\n    while (cur) {\n      if (cur.id === root) return true;\n      cur = cur.parent ? byId.get(cur.parent) : undefined;\n    }\n    return false;\n  };\n  const selfTime = (s: TimelineSpan) => {\n    const kids = spans.filter((k) => k.parent === s.id);\n    // Children can overlap, so merge their ranges before taking them away.\n    const ranges = kids\n      .map((k) => [k.start, k.start + k.duration] as [number, number])\n      .sort((a, b) => a[0] - b[0]);\n    let covered = 0;\n    let to = -Infinity;\n    for (const [a, b] of ranges) {\n      const from = Math.max(a, to);\n      if (b > from) covered += b - from;\n      to = Math.max(to, b);\n    }\n    return Math.max(0, s.duration - covered);\n  };\n\n  const root = spans.find((s) => !s.parent) ?? spans[0];\n  const children = spans.filter((s) => s.parent);\n  const slowest = [...children].sort((a, b) => b.duration - a.duration)[0];\n  const focus = selected ? byId.get(selected) : undefined;\n  const pointed = hover ? byId.get(hover) : undefined;\n  const readout = pointed ?? focus;\n\n  const pick = (id: string | null) => {\n    setSelected(id);\n    onSpanSelect?.(id ? (byId.get(id) ?? null) : null);\n  };\n\n  // Every run's services, so the legend doesn't reflow when the run changes.\n  const services = Array.from(\n    new Set(runs.flatMap((r) => r.spans.map((s) => s.service))),\n  );\n\n  return (\n    <section\n      className={`w-full rounded-2xl p-5 sm:p-6 ${className ?? \"\"}`}\n      style={{\n        background: pal.card,\n        boxShadow: `inset 0 0 0 1px ${pal.border}`,\n        color: pal.text,\n        fontFamily: CARD_FONT,\n        ...style,\n      }}\n      onKeyDown={(e) => {\n        if (e.key === \"Escape\" && selected) pick(null);\n      }}\n      {...props}\n    >\n      <div className=\"flex flex-wrap items-start justify-between gap-x-8 gap-y-3\">\n        <div>\n          <h3 className=\"m-0 text-[17px] leading-[1.33] font-[590] tracking-[-0.012em]\">\n            {title}\n          </h3>\n          <p\n            className=\"m-0 mt-0.5 text-[13px] tracking-[-0.011em]\"\n            style={{ color: pal.sub }}\n          >\n            {subtitle}\n          </p>\n        </div>\n        <div className=\"grid grid-cols-3 gap-7\">\n          <Stat\n            value={formatTime(root ? root.duration : end)}\n            label=\"Total\"\n            pal={pal}\n          />\n          <Stat value={String(spans.length)} label=\"Spans\" pal={pal} />\n          <Stat\n            value={slowest ? formatTime(slowest.duration) : \"–\"}\n            label={\n              slowest ? `Slowest, ${slowest.name.split(/[ .]/)[0]}` : \"Slowest\"\n            }\n            pal={pal}\n          />\n        </div>\n      </div>\n\n      <div className=\"mt-5 grid grid-cols-[112px_minmax(0,1fr)] gap-x-3 sm:grid-cols-[168px_minmax(0,1fr)]\">\n        <div />\n        <div ref={plotRef} className=\"relative h-5\">\n          {ticks.map((t) => (\n            <span\n              key={t}\n              className=\"absolute top-0 text-[11px] leading-[16px] tabular-nums\"\n              style={{\n                left: `${(t / end) * 100}%`,\n                transform: t === 0 ? \"none\" : \"translateX(-50%)\",\n                color: pal.faint,\n              }}\n            >\n              {formatTime(t)}\n            </span>\n          ))}\n        </div>\n\n        <ul\n          className=\"relative col-span-2 m-0 list-none p-0\"\n          style={{ height: rows * rowHeight }}\n          aria-label={`${title}, ${run?.label}. ${spans.length} spans over ${formatTime(end)}.`}\n        >\n          <li\n            aria-hidden=\"true\"\n            className=\"pointer-events-none absolute inset-y-0 right-0 left-[124px] sm:left-[180px]\"\n          >\n            {ticks.map((t) => (\n              <span\n                key={t}\n                className=\"absolute inset-y-0 w-px\"\n                style={{ left: `${(t / end) * 100}%`, background: pal.grid }}\n              />\n            ))}\n          </li>\n          {spans.map((s, i) => {\n            const depth = depthOf(s);\n            const color = colors[s.service] ?? pal.neutral;\n            const dim =\n              (focus && !isInside(s, focus.id)) ||\n              (pointed && pointed.id !== s.id && !focus);\n            const left = (s.start / end) * 100;\n            const w = Math.max(0.6, (s.duration / end) * 100);\n            // Past the edge, a wide bar holds its label and a short one puts it in front.\n            const place =\n              left + w <= 78 ? \"after\" : w >= 16 ? \"inside\" : \"before\";\n            return (\n              <li\n                key={`${run?.label}-${s.id}`}\n                className=\"absolute inset-x-0 top-0\"\n                style={{\n                  height: rowHeight,\n                  transform: `translateY(${i * rowHeight}px)`,\n                }}\n              >\n                <button\n                  type=\"button\"\n                  data-span={s.id}\n                  aria-pressed={selected === s.id}\n                  aria-label={`${s.name}, ${s.service}, ${formatTime(s.duration)}, starts at ${formatTime(s.start)}`}\n                  onClick={() => pick(selected === s.id ? null : s.id)}\n                  onPointerEnter={() => setHover(s.id)}\n                  onPointerLeave={() => setHover(null)}\n                  onFocus={() => setHover(s.id)}\n                  onBlur={() => setHover(null)}\n                  className={`grid size-full cursor-pointer grid-cols-[112px_minmax(0,1fr)] items-center gap-x-3 rounded-md border-0 p-0 text-left sm:grid-cols-[168px_minmax(0,1fr)] ${RING}`}\n                  style={{\n                    background:\n                      selected === s.id || hover === s.id\n                        ? pal.rowOn\n                        : \"transparent\",\n                    color: pal.text,\n                  }}\n                >\n                  <span\n                    className=\"flex min-w-0 items-center gap-1.5 text-[12.5px] leading-[18px] tracking-[-0.008em] transition-opacity duration-200\"\n                    style={{\n                      paddingLeft: Math.min(depth, 3) * 10,\n                      opacity: dim ? 0.4 : 1,\n                    }}\n                  >\n                    <Dot size={6} color={color} />\n                    <span\n                      className=\"truncate\"\n                      style={{ color: depth === 0 ? pal.text : pal.soft }}\n                    >\n                      {s.name}\n                    </span>\n                  </span>\n                  <span className=\"relative block h-full\">\n                    <span\n                      className=\"absolute top-1/2 block -translate-y-1/2 rounded-[3px] transition-[left,width,opacity] duration-700\"\n                      style={{\n                        left: `${seen ? left : 0}%`,\n                        width: `${seen ? w : 0}%`,\n                        height: 14,\n                        background: color,\n                        opacity: dim ? 0.25 : 1,\n                        transitionTimingFunction: EASE,\n                      }}\n                    />\n                    <span\n                      className=\"absolute top-1/2 -translate-y-1/2 text-[11px] leading-[16px] whitespace-nowrap tabular-nums transition-[left,opacity] duration-700\"\n                      style={{\n                        left: `${seen ? (place === \"before\" ? left : left + w) : 0}%`,\n                        transform:\n                          place === \"after\"\n                            ? \"translate(6px, -50%)\"\n                            : \"translate(calc(-100% - 6px), -50%)\",\n                        color: place === \"inside\" ? ink(color) : pal.sub,\n                        fontWeight: place === \"inside\" ? 510 : 400,\n                        opacity: dim ? 0.35 : seen ? 1 : 0,\n                        transitionTimingFunction: EASE,\n                      }}\n                    >\n                      {formatTime(s.duration)}\n                    </span>\n                  </span>\n                </button>\n              </li>\n            );\n          })}\n        </ul>\n      </div>\n\n      <p\n        aria-live=\"polite\"\n        className=\"m-0 mt-2 flex h-5 min-w-0 items-center gap-2 text-[12.5px] leading-[20px] tracking-[-0.008em]\"\n        style={{ color: pal.sub }}\n      >\n        {readout ? (\n          <>\n            <Dot size={6} color={colors[readout.service] ?? pal.neutral} />\n            <span className=\"truncate\">\n              <span style={{ color: pal.text }} className=\"font-[510]\">\n                {readout.name}\n              </span>\n              {`, ${formatTime(readout.duration)}, ${Math.round((readout.duration / end) * 100)}% of the run, ${formatTime(selfTime(readout))} on its own`}\n            </span>\n          </>\n        ) : (\n          <span className=\"truncate\">\n            Point at a span to read it. Click to focus its children.\n          </span>\n        )}\n      </p>\n\n      <div className=\"mt-3 flex flex-wrap items-center justify-between gap-x-4 gap-y-2\">\n        <Pills\n          label=\"Request\"\n          options={runs.map((r) => r.label)}\n          value={runIndex}\n          onChange={(i) => {\n            setRunIndex(i);\n            setHover(null);\n            pick(null);\n          }}\n          pal={pal}\n        />\n        <ul className=\"m-0 flex list-none flex-wrap gap-x-3 gap-y-1 p-0\">\n          {services.map((s) => (\n            <li\n              key={s}\n              className=\"flex items-center gap-1.5 text-[12px] leading-[16px]\"\n              style={{ color: pal.sub }}\n            >\n              <Dot size={6} color={colors[s] ?? pal.neutral} />\n              {s}\n            </li>\n          ))}\n        </ul>\n      </div>\n    </section>\n  );\n}\n",
      "type": "registry:component"
    }
  ],
  "type": "registry:component"
}