{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "text-scroll-words",
  "type": "registry:component",
  "title": "Text Scroll Words",
  "description": "A paragraph that wakes up word by word, from dim and blurred to bright and sharp, as it scrolls through the viewport.",
  "author": "Hyperblur <hello@hyperblur.dev>",
  "dependencies": [],
  "registryDependencies": [],
  "categories": [
    "text",
    "scroll",
    "words",
    "paragraph",
    "blur",
    "reading",
    "reveal"
  ],
  "docs": "https://hyperblur.dev/effects/text-scroll-words",
  "files": [
    {
      "path": "registry/hyperblur/text-scroll-words.tsx",
      "type": "registry:component",
      "target": "components/hyperblur/text-scroll-words.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nexport interface TextScrollWordsProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  text: string;\n  minOpacity?: number;\n  maxBlur?: number;\n  start?: number;\n  end?: number;\n  loop?: boolean;\n  loopDuration?: number;\n}\n\nconst css = `\n.hb-qt3 {\n  position: relative;\n  box-sizing: border-box;\n  margin: 0;\n  font-family: inherit;\n}\n.hb-qt3-w {\n  display: inline-block;\n  will-change: opacity, filter;\n}\n.hb-qt3-sr {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  margin: -1px;\n  padding: 0;\n  overflow: hidden;\n  clip-path: inset(50%);\n  white-space: nowrap;\n  border: 0;\n}\n@media (prefers-reduced-motion: reduce) {\n  .hb-qt3 .hb-qt3-w { opacity: 1 !important; filter: none !important; will-change: auto; }\n}\n`;\n\nconst WINDOW = 0.22;\n\nfunction clamp(v: number) {\n  return v < 0 ? 0 : v > 1 ? 1 : v;\n}\n\nfunction loopValue(ms: number, period: number) {\n  const u = (ms / 1000 / period) % 1;\n  if (u < 0.55) {\n    const k = u / 0.55;\n    return k * k * (3 - 2 * k);\n  }\n  if (u < 0.78) return 1;\n  if (u < 0.94) {\n    const k = (u - 0.78) / 0.16;\n    return 1 - k * k * (3 - 2 * k);\n  }\n  return 0;\n}\n\nexport function TextScrollWords({\n  text,\n  minOpacity = 0.16,\n  maxBlur = 5,\n  start = 0.9,\n  end = 0.5,\n  loop = false,\n  loopDuration = 7,\n  className = \"\",\n  style,\n  ...rest\n}: TextScrollWordsProps) {\n  const ref = React.useRef<HTMLParagraphElement>(null);\n  const items = React.useRef<HTMLSpanElement[]>([]);\n\n  const words = text.split(/\\s+/).filter((w) => w !== \"\");\n  const count = words.length;\n\n  React.useEffect(() => {\n    const root = ref.current;\n    if (!root) return;\n    const els = items.current;\n    const denom = Math.max(1, count);\n    const floor = clamp(minOpacity);\n    const apply = (p: number) => {\n      for (let i = 0; i < count; i++) {\n        const el = els[i];\n        if (!el) continue;\n        const l = clamp((p - (i / denom) * (1 - WINDOW)) / WINDOW);\n        el.style.opacity = (floor + (1 - floor) * l).toFixed(3);\n        el.style.filter = maxBlur > 0 && l < 1 ? `blur(${((1 - l) * maxBlur).toFixed(2)}px)` : \"none\";\n      }\n    };\n    if (window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches) {\n      apply(1);\n      return;\n    }\n    const period = Math.max(1, loopDuration);\n    const origin = performance.now();\n    let display = 0;\n    let pointer: number | null = null;\n    let seen = true;\n    let raf = 0;\n\n    const tick = (now: number) => {\n      raf = 0;\n      if (!seen) return;\n      let target: number;\n      if (loop && pointer !== null) target = pointer;\n      else if (loop) target = loopValue(now - origin, period);\n      else {\n        const rect = root.getBoundingClientRect();\n        const vh = window.innerHeight;\n        target = clamp((start * vh - rect.top) / (start * vh - end * vh + rect.height));\n      }\n      display += (target - display) * 0.2;\n      const settled = Math.abs(target - display) < 0.0005;\n      apply(settled ? target : display);\n      if (settled && !loop) display = target;\n      if (loop || !settled) raf = requestAnimationFrame(tick);\n    };\n    const schedule = () => {\n      if (!raf && seen) raf = requestAnimationFrame(tick);\n    };\n\n    const io = new IntersectionObserver((entries) => {\n      for (const entry of entries) {\n        seen = entry.isIntersecting;\n        if (seen) schedule();\n      }\n    });\n    io.observe(root);\n\n    const move = (e: PointerEvent) => {\n      const rect = root.getBoundingClientRect();\n      pointer = clamp((e.clientX - rect.left) / Math.max(1, rect.width));\n      schedule();\n    };\n    const leave = () => {\n      pointer = null;\n    };\n    if (loop) {\n      root.addEventListener(\"pointermove\", move);\n      root.addEventListener(\"pointerdown\", move);\n      root.addEventListener(\"pointerleave\", leave);\n      root.addEventListener(\"pointercancel\", leave);\n    } else {\n      window.addEventListener(\"scroll\", schedule, { passive: true });\n      window.addEventListener(\"resize\", schedule);\n    }\n    schedule();\n\n    return () => {\n      if (raf) cancelAnimationFrame(raf);\n      io.disconnect();\n      root.removeEventListener(\"pointermove\", move);\n      root.removeEventListener(\"pointerdown\", move);\n      root.removeEventListener(\"pointerleave\", leave);\n      root.removeEventListener(\"pointercancel\", leave);\n      window.removeEventListener(\"scroll\", schedule);\n      window.removeEventListener(\"resize\", schedule);\n    };\n  }, [count, minOpacity, maxBlur, start, end, loop, loopDuration]);\n\n  const initial = {\n    opacity: clamp(minOpacity).toFixed(3),\n    filter: maxBlur > 0 ? `blur(${maxBlur.toFixed(2)}px)` : \"none\",\n  };\n\n  return (\n    <p ref={ref} className={`hb-qt3 ${className}`} style={style} {...rest}>\n      <style href=\"hb-text-scroll-words\" precedence=\"default\">{css}</style>\n      <span className=\"hb-qt3-sr\">{text}</span>\n      <span aria-hidden=\"true\">\n        {words.map((w, i) => (\n          <React.Fragment key={i}>\n            {i > 0 ? \" \" : null}\n            <span\n              ref={(el) => {\n                if (el) items.current[i] = el;\n              }}\n              className=\"hb-qt3-w\"\n              style={initial}\n            >\n              {w}\n            </span>\n          </React.Fragment>\n        ))}\n      </span>\n    </p>\n  );\n}\n"
    }
  ]
}