{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "how-timeline-vertical",
  "type": "registry:component",
  "title": "How It Works: Vertical Timeline",
  "description": "A light, editorial timeline with serif titles and cards that alternate sides. The line fills and the current dot pulses as you scroll; on narrow screens every card sits on the right.",
  "author": "Hyperblur <hello@hyperblur.dev>",
  "dependencies": [],
  "registryDependencies": [],
  "categories": [
    "how-it-works",
    "timeline",
    "process",
    "how it works",
    "light",
    "serif",
    "agency"
  ],
  "docs": "https://hyperblur.dev/effects/how-timeline-vertical",
  "files": [
    {
      "path": "registry/hyperblur/how-timeline-vertical.tsx",
      "type": "registry:component",
      "target": "components/hyperblur/how-timeline-vertical.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nexport interface HowTimelineVerticalItem {\n  label: string;\n  title: string;\n  description: string;\n  duration?: string;\n  deliverables?: string[];\n  owner?: string;\n}\n\nexport interface HowTimelineVerticalAction {\n  label: string;\n  href: string;\n}\n\nexport interface HowTimelineVerticalProps extends Omit<React.HTMLAttributes<HTMLElement>, \"title\"> {\n  eyebrow?: string;\n  title?: string;\n  subtitle?: string;\n  items?: HowTimelineVerticalItem[];\n  cta?: HowTimelineVerticalAction | null;\n  note?: string;\n  accent?: string;\n  onItemActive?: (index: number) => void;\n}\n\nconst css = `\n@keyframes hb-kh3-pulse {\n  0% { transform: scale(1); opacity: 0.6; }\n  100% { transform: scale(2.6); opacity: 0; }\n}\n.hb-kh3 {\n  --hb-kh3-accent: #e5533d;\n  --hb-kh3-ink: #1b1915;\n  --hb-kh3-muted: #6f6a61;\n  --hb-kh3-line: rgba(27, 25, 21, 0.12);\n  --hb-kh3-serif: var(--font-sans, ui-sans-serif, system-ui, sans-serif);\n  position: relative;\n  box-sizing: border-box;\n  width: 100%;\n  overflow: hidden;\n  container-type: inline-size;\n  background: #f7f5ef;\n  color: var(--hb-kh3-ink);\n  font-family: inherit;\n  -webkit-font-smoothing: antialiased;\n}\n.hb-kh3 *, .hb-kh3 *::before, .hb-kh3 *::after { box-sizing: border-box; }\n.hb-kh3::before {\n  content: \"\";\n  position: absolute;\n  inset: 0;\n  pointer-events: none;\n  background:\n    radial-gradient(40% 30% at 50% 0%, color-mix(in srgb, var(--hb-kh3-accent) 10%, transparent), transparent 70%),\n    radial-gradient(rgba(27, 25, 21, 0.06) 1px, transparent 1px) 0 0 / 22px 22px;\n  mask-image: linear-gradient(180deg, #000, transparent 60%);\n  -webkit-mask-image: linear-gradient(180deg, #000, transparent 60%);\n}\n.hb-kh3-in {\n  position: relative;\n  max-width: 1120px;\n  margin: 0 auto;\n  padding: 72px 20px 84px;\n}\n.hb-kh3-head {\n  max-width: 660px;\n  margin: 0 auto;\n  text-align: center;\n}\n.hb-kh3-eyebrow {\n  display: inline-flex;\n  align-items: center;\n  gap: 10px;\n  color: var(--hb-kh3-muted);\n  font-size: 12px;\n  font-weight: 600;\n  letter-spacing: 0.14em;\n  text-transform: uppercase;\n}\n.hb-kh3-eyebrow::before, .hb-kh3-eyebrow::after {\n  content: \"\";\n  width: 22px;\n  height: 1px;\n  background: currentColor;\n  opacity: 0.5;\n}\n.hb-kh3-title {\n  margin: 16px 0 0;\n  font-family: var(--font-sans, ui-sans-serif, system-ui, sans-serif);\n  font-size: clamp(36px, 5.6cqw, 58px);\n  font-weight: 400;\n  line-height: 1.02;\n  letter-spacing: -0.02em;\n  text-wrap: balance;\n}\n.hb-kh3-title em { font-style: normal; color: var(--hb-kh3-accent); }\n.hb-kh3-sub {\n  max-width: 500px;\n  margin: 16px auto 0;\n  color: var(--hb-kh3-muted);\n  font-size: 16px;\n  line-height: 1.6;\n  text-wrap: pretty;\n}\n.hb-kh3-list {\n  margin: 52px 0 0;\n  padding: 0;\n  list-style: none;\n}\n.hb-kh3-item {\n  position: relative;\n  display: grid;\n  grid-template-columns: 34px minmax(0, 1fr);\n  column-gap: 14px;\n  padding-bottom: 20px;\n}\n.hb-kh3-item:last-child { padding-bottom: 0; }\n.hb-kh3-rail {\n  position: relative;\n  grid-column: 1;\n  grid-row: 1;\n}\n.hb-kh3-seg {\n  position: absolute;\n  top: 34px;\n  bottom: -34px;\n  left: 50%;\n  width: 2px;\n  margin-left: -1px;\n  background: var(--hb-kh3-line);\n  overflow: hidden;\n}\n.hb-kh3-item:last-child .hb-kh3-seg { display: none; }\n.hb-kh3-seg::after {\n  content: \"\";\n  position: absolute;\n  inset: 0;\n  background: var(--hb-kh3-accent);\n  transform: scaleY(0);\n  transform-origin: top;\n  transition: transform 0.7s cubic-bezier(0.65, 0, 0.35, 1);\n}\n.hb-kh3-item[data-state=\"done\"] .hb-kh3-seg::after { transform: none; }\n.hb-kh3-dot {\n  position: absolute;\n  top: 26px;\n  left: 50%;\n  width: 16px;\n  height: 16px;\n  margin-left: -8px;\n  border: 2px solid rgba(27, 25, 21, 0.25);\n  border-radius: 50%;\n  background: #f7f5ef;\n  transition: border-color 0.35s ease, background-color 0.35s ease;\n}\n.hb-kh3-dot::before {\n  content: \"\";\n  position: absolute;\n  inset: -2px;\n  border-radius: 50%;\n  background: var(--hb-kh3-accent);\n  opacity: 0;\n}\n.hb-kh3-item[data-state=\"done\"] .hb-kh3-dot { border-color: var(--hb-kh3-accent); background: var(--hb-kh3-accent); }\n.hb-kh3-item[data-state=\"active\"] .hb-kh3-dot { border-color: var(--hb-kh3-accent); background: #ffffff; box-shadow: inset 0 0 0 3px #ffffff, inset 0 0 0 8px var(--hb-kh3-accent); }\n.hb-kh3-item[data-state=\"active\"] .hb-kh3-dot::before { animation: hb-kh3-pulse 1.8s ease-out infinite; }\n.hb-kh3-aside { display: none; }\n.hb-kh3-card {\n  grid-column: 2;\n  grid-row: 1;\n  position: relative;\n  padding: 22px 22px 22px;\n  border: 1px solid rgba(27, 25, 21, 0.08);\n  border-radius: 20px;\n  background: #ffffff;\n  box-shadow: 0 1px 0 rgba(255, 255, 255, 0.9) inset, 0 1px 2px rgba(27, 25, 21, 0.04), 0 18px 40px -28px rgba(27, 25, 21, 0.28);\n  opacity: 0.62;\n  transform: translate3d(0, 6px, 0);\n  transition: opacity 0.45s ease, transform 0.45s cubic-bezier(0.2, 0.8, 0.2, 1), box-shadow 0.45s ease, border-color 0.45s ease;\n}\n.hb-kh3-item[data-state=\"done\"] .hb-kh3-card { opacity: 0.88; transform: none; }\n.hb-kh3-item[data-state=\"active\"] .hb-kh3-card {\n  opacity: 1;\n  transform: none;\n  border-color: color-mix(in srgb, var(--hb-kh3-accent) 30%, rgba(27, 25, 21, 0.08));\n  box-shadow: 0 1px 0 rgba(255, 255, 255, 0.9) inset, 0 1px 2px rgba(27, 25, 21, 0.05), 0 26px 50px -26px color-mix(in srgb, var(--hb-kh3-accent) 40%, rgba(27, 25, 21, 0.3));\n}\n.hb-kh3-card:hover { opacity: 1; }\n.hb-kh3-top {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: space-between;\n  gap: 6px 12px;\n}\n.hb-kh3-label {\n  color: var(--hb-kh3-accent);\n  font-size: 12px;\n  font-weight: 700;\n  letter-spacing: 0.1em;\n  text-transform: uppercase;\n}\n.hb-kh3-dur {\n  color: var(--hb-kh3-muted);\n  font-size: 12.5px;\n  font-variant-numeric: tabular-nums;\n}\n.hb-kh3-name {\n  margin: 10px 0 0;\n  font-family: var(--font-sans, ui-sans-serif, system-ui, sans-serif);\n  font-size: clamp(26px, 3cqw, 32px);\n  font-weight: 400;\n  line-height: 1.08;\n  letter-spacing: -0.01em;\n}\n.hb-kh3-desc {\n  margin: 10px 0 0;\n  color: #4d4943;\n  font-size: 15px;\n  line-height: 1.6;\n  text-wrap: pretty;\n}\n.hb-kh3-chips {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 6px;\n  margin: 16px 0 0;\n  padding: 0;\n  list-style: none;\n}\n.hb-kh3-chip {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 26px;\n  padding: 0 10px;\n  border: 1px solid rgba(27, 25, 21, 0.1);\n  border-radius: 999px;\n  background: #faf9f5;\n  color: #3b3833;\n  font-size: 12.5px;\n}\n.hb-kh3-chip svg { width: 13px; height: 13px; fill: none; stroke: var(--hb-kh3-accent); stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; }\n.hb-kh3-owner {\n  display: flex;\n  align-items: center;\n  gap: 10px;\n  margin-top: 16px;\n  padding-top: 14px;\n  border-top: 1px dashed rgba(27, 25, 21, 0.12);\n  color: var(--hb-kh3-muted);\n  font-size: 13px;\n}\n.hb-kh3-av {\n  display: grid;\n  place-items: center;\n  width: 26px;\n  height: 26px;\n  border-radius: 50%;\n  color: #ffffff;\n  font-size: 10.5px;\n  font-weight: 700;\n}\n.hb-kh3-owner strong { color: var(--hb-kh3-ink); font-weight: 600; }\n.hb-kh3-foot {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: center;\n  gap: 12px 20px;\n  margin-top: 52px;\n  color: var(--hb-kh3-muted);\n  font-size: 14px;\n}\n.hb-kh3-cta {\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n  height: 44px;\n  padding: 0 20px;\n  border-radius: 999px;\n  background: var(--hb-kh3-ink);\n  color: #f7f5ef;\n  font-size: 14px;\n  font-weight: 600;\n  text-decoration: none;\n  box-shadow: 0 10px 24px -12px rgba(27, 25, 21, 0.6);\n  transition: transform 0.2s ease, background-color 0.2s ease;\n}\n.hb-kh3-cta:hover { transform: translateY(-1px); background: #000000; }\n.hb-kh3-cta:focus-visible { outline: 2px solid var(--hb-kh3-accent); outline-offset: 3px; }\n.hb-kh3-cta i {\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n  background: var(--hb-kh3-accent);\n}\n.hb-kh3-foot b { color: var(--hb-kh3-ink); font-weight: 600; }\n@container (min-width: 760px) {\n  .hb-kh3-in { padding: 92px 40px 108px; }\n  .hb-kh3-list { margin-top: 64px; }\n  .hb-kh3-item {\n    grid-template-columns: minmax(0, 1fr) 72px minmax(0, 1fr);\n    column-gap: 0;\n    padding-bottom: 8px;\n  }\n  .hb-kh3-rail { grid-column: 2; }\n  .hb-kh3-card { grid-column: 3; }\n  .hb-kh3-item[data-side=\"left\"] .hb-kh3-card { grid-column: 1; }\n  .hb-kh3-aside {\n    grid-column: 1;\n    grid-row: 1;\n    display: flex;\n    flex-direction: column;\n    align-items: flex-end;\n    padding: 14px 8px 0 0;\n    color: rgba(27, 25, 21, 0.2);\n    transition: color 0.45s ease;\n  }\n  .hb-kh3-item[data-side=\"left\"] .hb-kh3-aside { grid-column: 3; align-items: flex-start; padding: 14px 0 0 8px; }\n  .hb-kh3-item[data-state=\"active\"] .hb-kh3-aside, .hb-kh3-item[data-state=\"done\"] .hb-kh3-aside { color: rgba(27, 25, 21, 0.55); }\n  .hb-kh3-num {\n    font-family: var(--font-sans, ui-sans-serif, system-ui, sans-serif);\n    font-size: 64px;\n        line-height: 1;\n  }\n  .hb-kh3-item[data-state=\"active\"] .hb-kh3-num { color: var(--hb-kh3-accent); }\n  .hb-kh3-asidetxt {\n    margin-top: 6px;\n    font-size: 13px;\n    letter-spacing: 0.02em;\n  }\n}\n@media (prefers-reduced-motion: reduce) {\n  .hb-kh3 *, .hb-kh3 *::before, .hb-kh3 *::after { animation: none !important; transition: none !important; }\n}\n`;\n\nconst defaultItems: HowTimelineVerticalItem[] = [\n  {\n    label: \"Week 1\",\n    title: \"Discovery call\",\n    description: \"A ninety-minute session with your founders and leads to map goals, constraints and what success looks like in numbers.\",\n    duration: \"Nov 3 to Nov 7\",\n    deliverables: [\"Project brief\", \"Success metrics\"],\n    owner: \"Priya Raman, Strategy lead\",\n  },\n  {\n    label: \"Week 2\",\n    title: \"Research sprint\",\n    description: \"Twelve customer interviews and a pass through your analytics. We come back with the three problems worth solving first.\",\n    duration: \"Nov 10 to Nov 14\",\n    deliverables: [\"Interview notes\", \"Opportunity map\"],\n    owner: \"Tomás Varga, Research\",\n  },\n  {\n    label: \"Weeks 3 and 4\",\n    title: \"Prototype and test\",\n    description: \"Clickable prototypes go in front of real customers every Thursday. What fails gets cut, what works gets sharper.\",\n    duration: \"Nov 17 to Nov 28\",\n    deliverables: [\"Interactive prototype\", \"Test reports\"],\n    owner: \"Ines Okafor, Product design\",\n  },\n  {\n    label: \"Week 5\",\n    title: \"Launch and handoff\",\n    description: \"Production-ready files, a component library and a recorded walkthrough, so your team owns every decision we made.\",\n    duration: \"Dec 1 to Dec 5\",\n    deliverables: [\"Design system\", \"Handoff video\"],\n    owner: \"Priya Raman, Strategy lead\",\n  },\n];\n\nconst avatarColors = [\"#e5533d\", \"#3d6be5\", \"#2f9e6e\", \"#b0752a\", \"#8a4fd8\"];\n\nfunction hashName(name: string) {\n  let h = 0;\n  for (let i = 0; i < name.length; i++) h = (h * 31 + name.charCodeAt(i)) | 0;\n  return Math.abs(h);\n}\n\nfunction initials(name: string) {\n  return name\n    .split(\",\")[0]\n    .split(\" \")\n    .map((p) => p[0])\n    .slice(0, 2)\n    .join(\"\");\n}\n\nexport function HowTimelineVertical({\n  eyebrow = \"The process\",\n  title = \"Five weeks from first call to launch\",\n  subtitle = \"A fixed schedule with a named lead at every stage. You always know what happens this week and what lands next.\",\n  items = defaultItems,\n  cta = { label: \"Book a discovery call\", href: \"#\" },\n  note = \"Fixed price from $24,000\",\n  accent = \"#e5533d\",\n  onItemActive,\n  className,\n  style,\n  ...rest\n}: HowTimelineVerticalProps) {\n  const [active, setActive] = React.useState(0);\n  const refs = React.useRef<(HTMLLIElement | null)[]>([]);\n  const cb = React.useRef(onItemActive);\n  const last = React.useRef(0);\n\n  React.useEffect(() => {\n    cb.current = onItemActive;\n  }, [onItemActive]);\n\n  React.useEffect(() => {\n    if (last.current === active) return;\n    last.current = active;\n    cb.current?.(active);\n  }, [active]);\n\n  React.useEffect(() => {\n    if (typeof IntersectionObserver === \"undefined\") return;\n    const io = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (!entry.isIntersecting) continue;\n          const i = Number((entry.target as HTMLElement).dataset.index);\n          if (!Number.isNaN(i)) setActive(i);\n        }\n      },\n      { rootMargin: \"-38% 0px -52% 0px\", threshold: 0 },\n    );\n    refs.current.forEach((n) => {\n      if (n) io.observe(n);\n    });\n    return () => io.disconnect();\n  }, [items.length]);\n\n  return (\n    <section\n      className={[\"hb-kh3\", className].filter(Boolean).join(\" \")}\n      style={{ [\"--hb-kh3-accent\" as string]: accent, ...style } as React.CSSProperties}\n      {...rest}\n    >\n      <style href=\"hb-how-timeline-vertical\" precedence=\"default\">{css}</style>\n      <div className=\"hb-kh3-in\">\n        <header className=\"hb-kh3-head\">\n          {eyebrow ? <div className=\"hb-kh3-eyebrow\">{eyebrow}</div> : null}\n          <h2 className=\"hb-kh3-title\">{title}</h2>\n          {subtitle ? <p className=\"hb-kh3-sub\">{subtitle}</p> : null}\n        </header>\n        <ol className=\"hb-kh3-list\">\n          {items.map((item, i) => {\n            const state = i < active ? \"done\" : i === active ? \"active\" : \"upcoming\";\n            return (\n              <li\n                key={item.title + i}\n                ref={(el) => {\n                  refs.current[i] = el;\n                }}\n                className=\"hb-kh3-item\"\n                data-index={i}\n                data-state={state}\n                data-side={i % 2 === 0 ? \"right\" : \"left\"}\n                aria-current={state === \"active\" ? \"step\" : undefined}\n              >\n                <div className=\"hb-kh3-rail\" aria-hidden=\"true\">\n                  <span className=\"hb-kh3-seg\" />\n                  <span className=\"hb-kh3-dot\" />\n                </div>\n                <div className=\"hb-kh3-aside\" aria-hidden=\"true\">\n                  <span className=\"hb-kh3-num\">{String(i + 1).padStart(2, \"0\")}</span>\n                  {item.duration ? <span className=\"hb-kh3-asidetxt\">{item.duration}</span> : null}\n                </div>\n                <article className=\"hb-kh3-card\" tabIndex={-1} onFocus={() => setActive(i)} onMouseEnter={() => setActive(i)}>\n                  <div className=\"hb-kh3-top\">\n                    <span className=\"hb-kh3-label\">{item.label}</span>\n                    {item.duration ? <span className=\"hb-kh3-dur\">{item.duration}</span> : null}\n                  </div>\n                  <h3 className=\"hb-kh3-name\">{item.title}</h3>\n                  <p className=\"hb-kh3-desc\">{item.description}</p>\n                  {item.deliverables && item.deliverables.length ? (\n                    <ul className=\"hb-kh3-chips\" aria-label=\"Deliverables\">\n                      {item.deliverables.map((d) => (\n                        <li key={d} className=\"hb-kh3-chip\">\n                          <svg viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n                            <path d=\"M4 2.5h5.5L12.5 5.5V13a.5.5 0 0 1-.5.5H4a.5.5 0 0 1-.5-.5V3a.5.5 0 0 1 .5-.5zM9 2.5v3.5h3.5\" />\n                          </svg>\n                          {d}\n                        </li>\n                      ))}\n                    </ul>\n                  ) : null}\n                  {item.owner ? (\n                    <div className=\"hb-kh3-owner\">\n                      <span className=\"hb-kh3-av\" style={{ background: avatarColors[hashName(item.owner) % avatarColors.length] }}>\n                        {initials(item.owner)}\n                      </span>\n                      <span>\n                        Led by <strong>{item.owner.split(\",\")[0]}</strong>\n                        {item.owner.includes(\",\") ? `, ${item.owner.split(\",\").slice(1).join(\",\").trim()}` : \"\"}\n                      </span>\n                    </div>\n                  ) : null}\n                </article>\n              </li>\n            );\n          })}\n        </ol>\n        {cta || note ? (\n          <div className=\"hb-kh3-foot\">\n            {cta ? (\n              <a className=\"hb-kh3-cta\" href={cta.href}>\n                <i aria-hidden=\"true\" />\n                {cta.label}\n              </a>\n            ) : null}\n            {note ? <span>{note}</span> : null}\n          </div>\n        ) : null}\n      </div>\n    </section>\n  );\n}\n"
    }
  ]
}