{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"event-rail","type":"registry:ui","title":"Event rail","description":"Dated events on a rail you drag sideways. The event in the middle is full size, its neighbours shrink and dim with distance, ticks run beneath the cards and each new year's numeral drifts slowly behind them.","dependencies":["clsx","tailwind-merge"],"registryDependencies":["https://caliperui.site/r/styles.json"],"files":[{"path":"ui/event-rail.tsx","type":"registry:ui","target":"components/ui/event-rail.tsx","content":"\"use client\";\nimport { useEffect, useLayoutEffect, useRef, useState, type ComponentProps, type KeyboardEvent, type PointerEvent } from \"react\";\nimport { cn } from \"./lib/cn\";\nimport \"./event-rail.css\";\n\nexport type RailEvent = { id: string; date: string; year: string | number; title: string; description?: string };\n\nexport type EventRailProps = Omit<ComponentProps<\"div\">, \"defaultValue\" | \"onChange\"> & {\n  /** Names the timeline, e.g. \"Company history\". */\n  label: string;\n  events: RailEvent[];\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (id: string) => void;\n};\n\n/**\n * Dated events on a rail you drag sideways. The event in the middle is full size and its neighbours shrink and dim\n * with distance, ticks run between the cards, and each new year's numeral drifts slowly behind them. It is a list\n * box: arrow keys move to the next event, Home and End to the ends, and a click centres an event. Touch scrolls\n * natively; a mouse can drag. Under reduced motion the rail jumps instead of gliding and the year stays put.\n */\nexport function EventRail({ label, events, value, defaultValue, onValueChange, className, ...props }: EventRailProps) {\n  const [own, setOwn] = useState(defaultValue ?? events[0]?.id);\n  const current = value ?? own;\n  const scroller = useRef<HTMLDivElement>(null);\n  const drag = useRef<{ x: number; left: number; moved: boolean } | null>(null);\n  const lastSent = useRef(current);\n  const dragged = useRef(false);\n\n  const cards = () => [...(scroller.current?.querySelectorAll<HTMLElement>(\"[data-slot='er-card']\") ?? [])];\n  const centre = (id: string, smooth = true) => {\n    const box = scroller.current;\n    const card = cards().find((el) => el.dataset.id === id);\n    if (!box || !card) return;\n    const still = matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n    box.scrollTo({ left: card.offsetLeft + card.offsetWidth / 2 - box.clientWidth / 2, behavior: smooth && !still ? \"smooth\" : \"auto\" });\n  };\n\n  // Each card's distance from the middle drives its size, dimming and the year's drift; the nearest one is chosen.\n  useEffect(() => {\n    const box = scroller.current;\n    if (!box) return;\n    let frame = 0;\n    const update = () => {\n      frame = 0;\n      const mid = box.scrollLeft + box.clientWidth / 2;\n      let best: HTMLElement | null = null,\n        nearest = Infinity;\n      for (const card of cards()) {\n        const d = (card.offsetLeft + card.offsetWidth / 2 - mid) / card.offsetWidth;\n        card.style.setProperty(\"--er-d\", d.toFixed(3));\n        card.style.setProperty(\"--er-a\", Math.min(2, Math.abs(d)).toFixed(3));\n        if (Math.abs(d) < nearest) [nearest, best] = [Math.abs(d), card];\n      }\n      const id = best?.dataset.id;\n      if (id && id !== lastSent.current && !drag.current) {\n        lastSent.current = id;\n        if (value === undefined) setOwn(id);\n        onValueChange?.(id);\n      }\n    };\n    const schedule = () => (frame ||= requestAnimationFrame(update));\n    update();\n    box.addEventListener(\"scroll\", schedule, { passive: true });\n    const observer = new ResizeObserver(schedule);\n    observer.observe(box);\n    return () => {\n      cancelAnimationFrame(frame);\n      box.removeEventListener(\"scroll\", schedule);\n      observer.disconnect();\n    };\n  });\n\n  // An outside change of value brings that event to the middle.\n  useLayoutEffect(() => {\n    if (current !== lastSent.current) {\n      lastSent.current = current;\n      centre(current);\n    }\n  }, [current]); // eslint-disable-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => centre(current, false), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const key = (event: KeyboardEvent<HTMLDivElement>) => {\n    const index = events.findIndex((item) => item.id === current);\n    const next = { ArrowRight: index + 1, ArrowLeft: index - 1, Home: 0, End: events.length - 1 }[event.key];\n    if (next === undefined) return;\n    event.preventDefault();\n    const target = events[Math.max(0, Math.min(events.length - 1, next))];\n    if (value === undefined) setOwn(target.id);\n    lastSent.current = target.id;\n    onValueChange?.(target.id);\n    centre(target.id);\n  };\n\n  const down = (event: PointerEvent<HTMLDivElement>) => {\n    dragged.current = false;\n    if (event.pointerType !== \"mouse\" || event.button !== 0) return;\n    drag.current = { x: event.clientX, left: event.currentTarget.scrollLeft, moved: false };\n  };\n  const move = (event: PointerEvent<HTMLDivElement>) => {\n    const active = drag.current;\n    if (!active) return;\n    if (!active.moved && Math.abs(event.clientX - active.x) > 4) {\n      active.moved = true;\n      event.currentTarget.setPointerCapture(event.pointerId);\n      event.currentTarget.dataset.dragging = \"\";\n    }\n    if (active.moved) event.currentTarget.scrollLeft = active.left - (event.clientX - active.x);\n  };\n  const up = (event: PointerEvent<HTMLDivElement>) => {\n    const active = drag.current;\n    drag.current = null;\n    if (!active) return;\n    const box = event.currentTarget;\n    if (active.moved) {\n      delete box.dataset.dragging;\n      const mid = box.scrollLeft + box.clientWidth / 2;\n      const nearest = cards().sort((a, b) => Math.abs(a.offsetLeft + a.offsetWidth / 2 - mid) - Math.abs(b.offsetLeft + b.offsetWidth / 2 - mid))[0];\n      if (nearest?.dataset.id) centre(nearest.dataset.id);\n      dragged.current = true; // the click that ends a drag does not also choose\n    }\n  };\n\n  return (\n    <div data-slot=\"event-rail\" className={cn(\"relative\", className)} {...props}>\n      <div\n        ref={scroller}\n        role=\"listbox\"\n        tabIndex={0}\n        aria-label={label}\n        aria-activedescendant={`er-${current}`}\n        data-slot=\"er-scroller\"\n        onKeyDown={key}\n        onPointerDown={down}\n        onPointerMove={move}\n        onPointerUp={up}\n        onPointerCancel={up}\n        onClick={(event) => {\n          if (dragged.current) return void (dragged.current = false);\n          const card = (event.target as HTMLElement).closest<HTMLElement>(\"[data-slot='er-card']\");\n          if (card?.dataset.id) centre(card.dataset.id);\n        }}\n      >\n        <ol data-slot=\"er-track\">\n          {events.map((item, i) => {\n            const newYear = i === 0 || String(events[i - 1].year) !== String(item.year);\n            return (\n              <li key={item.id} id={`er-${item.id}`} role=\"option\" aria-selected={item.id === current} data-slot=\"er-card\" data-id={item.id} aria-label={`${item.date}: ${item.title}`}>\n                {newYear && (\n                  <span data-slot=\"er-year\" aria-hidden=\"true\">\n                    {item.year}\n                  </span>\n                )}\n                <span data-slot=\"er-face\">\n                  <span data-slot=\"er-date\">{item.date}</span>\n                  <span data-slot=\"er-title\">{item.title}</span>\n                  {item.description && <span data-slot=\"er-description\">{item.description}</span>}\n                </span>\n              </li>\n            );\n          })}\n        </ol>\n      </div>\n    </div>\n  );\n}\n"},{"path":"ui/lib/cn.ts","type":"registry:ui","target":"components/ui/lib/cn.ts","content":"import { clsx, type ClassValue } from \"clsx\";\nimport { extendTailwindMerge } from \"tailwind-merge\";\n\nconst twMerge = extendTailwindMerge({\n  extend: { theme: { radius: [\"control\", \"surface\", \"overlay\"], shadow: [\"overlay\"] } },\n});\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n"},{"path":"ui/event-rail.css","type":"registry:file","target":"components/ui/event-rail.css","content":"/* event-rail.tsx's styles; it imports this file. Edit freely. */\n@layer theme, base, components, utilities;\n\n@layer components {\n  /* Event rail: distance from the middle sets size and dimming; each new year drifts behind its card. */\n  [data-slot=\"event-rail\"] [data-slot=\"er-scroller\"] { overflow-x: auto; scroll-snap-type: x mandatory; scrollbar-width: none; border-radius: var(--radius-surface); outline: none; cursor: grab; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-scroller\"]::-webkit-scrollbar { display: none; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-scroller\"][data-dragging] { scroll-snap-type: none; cursor: grabbing; user-select: none; -webkit-user-select: none; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-scroller\"]:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-track\"] { --er-w: min(260px, 70vw); display: flex; width: max-content; margin: 0; padding: 48px calc(50% - var(--er-w) / 2) 28px; list-style: none; background: repeating-linear-gradient(90deg, var(--border) 0 1px, transparent 1px 12px) 0 calc(100% - 8px) / 100% 8px no-repeat; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-card\"] { position: relative; isolation: isolate; flex: none; width: var(--er-w); padding: 0 8px; scroll-snap-align: center; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-face\"] { display: grid; gap: 6px; min-height: 132px; align-content: start; padding: 16px; border: 1px solid var(--border); border-radius: var(--radius-surface); background: var(--background); scale: calc(1 - var(--er-a, 0) * 0.08); opacity: calc(1 - var(--er-a, 0) * 0.42); transform-origin: 50% 100%; transition: box-shadow var(--duration-normal) var(--ease-out), border-color var(--duration-normal) var(--ease-out); }\n  [data-slot=\"event-rail\"] [data-slot=\"er-card\"][aria-selected=\"true\"] [data-slot=\"er-face\"] { border-color: var(--border-strong); box-shadow: var(--shadow-resting); }\n  [data-slot=\"event-rail\"] [data-slot=\"er-date\"] { font-size: 12px; font-variant-numeric: tabular-nums; color: var(--muted-foreground); }\n  [data-slot=\"event-rail\"] [data-slot=\"er-title\"] { font-weight: 500; line-height: 1.3; }\n  [data-slot=\"event-rail\"] [data-slot=\"er-description\"] { font-size: 13px; line-height: 1.45; color: var(--muted-foreground); }\n  [data-slot=\"event-rail\"] [data-slot=\"er-year\"] { position: absolute; top: -44px; left: 12px; z-index: -1; font-size: 64px; font-weight: 600; line-height: 1; letter-spacing: -0.04em; font-variant-numeric: tabular-nums; color: color-mix(in oklab, var(--foreground) 8%, transparent); translate: calc(var(--er-d, 0) * -48px) 0; pointer-events: none; }\n  @media (prefers-reduced-motion: reduce) {\n    [data-slot=\"event-rail\"] [data-slot=\"er-year\"] { translate: none; }\n  }\n}\n"}],"categories":["motion"],"meta":{"tier":"free","license":"MIT","family":"browse","docs":"/docs/components/event-rail"}}