{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "text-scroll-float",
  "type": "registry:component",
  "title": "Text Scroll Float",
  "description": "Lines of text whose letters float up into place in a wave as the element scrolls into view. Progress follows the scroll position.",
  "author": "Hyperblur <hello@hyperblur.dev>",
  "dependencies": [],
  "registryDependencies": [],
  "categories": [
    "text",
    "scroll",
    "float",
    "wave",
    "letters",
    "heading",
    "reveal"
  ],
  "docs": "https://hyperblur.dev/effects/text-scroll-float",
  "files": [
    {
      "path": "registry/hyperblur/text-scroll-float.tsx",
      "type": "registry:component",
      "target": "components/hyperblur/text-scroll-float.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nexport interface TextScrollFloatProps extends React.HTMLAttributes<HTMLDivElement> {\n  lines?: string[];\n  distance?: number;\n  spread?: number;\n  start?: number;\n  end?: number;\n  loop?: boolean;\n  loopDuration?: number;\n}\n\nconst css = `\n.hb-qt2 {\n  position: relative;\n  box-sizing: border-box;\n  font-family: inherit;\n}\n.hb-qt2-l { display: block; }\n.hb-qt2-w { display: inline-block; white-space: nowrap; }\n.hb-qt2-i {\n  display: inline-block;\n  will-change: transform, opacity;\n}\n.hb-qt2-sp { display: inline-block; width: 0.28em; }\n.hb-qt2-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-qt2 .hb-qt2-i { opacity: 1 !important; transform: none !important; will-change: auto; }\n}\n`;\n\nfunction clamp(v: number) {\n  return v < 0 ? 0 : v > 1 ? 1 : v;\n}\n\nfunction letterStyle(l: number, distance: number) {\n  const e = 1 - Math.pow(1 - l, 3);\n  return {\n    transform: `translate3d(0, ${((1 - e) * distance).toFixed(3)}em, 0)`,\n    opacity: clamp(l * 2.2).toFixed(3),\n  };\n}\n\nfunction loopValue(ms: number, period: number) {\n  const u = (ms / 1000 / period) % 1;\n  if (u < 0.45) {\n    const k = u / 0.45;\n    return k * k * (3 - 2 * k);\n  }\n  if (u < 0.75) return 1;\n  if (u < 0.95) {\n    const k = (u - 0.75) / 0.2;\n    return 1 - k * k * (3 - 2 * k);\n  }\n  return 0;\n}\n\nfunction build(lines: string[]) {\n  let n = 0;\n  const built = lines.map((line) =>\n    line.split(/(\\s+)/).filter((t) => t !== \"\").map((value) =>\n      /^\\s+$/.test(value)\n        ? { space: true, letters: [] as { ch: string; i: number }[] }\n        : { space: false, letters: Array.from(value).map((ch) => ({ ch, i: n++ })) }\n    )\n  );\n  return { built, count: n };\n}\n\nexport function TextScrollFloat({\n  lines = [\"Rise with\", \"the scroll.\"],\n  distance = 0.9,\n  spread = 0.7,\n  start = 0.9,\n  end = 0.6,\n  loop = false,\n  loopDuration = 6,\n  className = \"\",\n  style,\n  ...rest\n}: TextScrollFloatProps) {\n  const ref = React.useRef<HTMLDivElement>(null);\n  const items = React.useRef<HTMLSpanElement[]>([]);\n\n  const { built, count } = build(lines);\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 - 1);\n    const sp = Math.min(1, Math.max(0, spread));\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 * (1 + sp) - (i / denom) * sp);\n        const s = letterStyle(l, distance);\n        el.style.transform = s.transform;\n        el.style.opacity = s.opacity;\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, distance, spread, start, end, loop, loopDuration]);\n\n  const initial = letterStyle(0, distance);\n\n  return (\n    <div ref={ref} className={`hb-qt2 ${className}`} style={style} {...rest}>\n      <style href=\"hb-text-scroll-float\" precedence=\"default\">{css}</style>\n      <span className=\"hb-qt2-sr\">{lines.join(\" \")}</span>\n      <div aria-hidden=\"true\">\n        {built.map((words, li) => (\n          <span key={li} className=\"hb-qt2-l\">\n            {words.map((w, wi) =>\n              w.space ? (\n                <span key={wi} className=\"hb-qt2-sp\" />\n              ) : (\n                <span key={wi} className=\"hb-qt2-w\">\n                  {w.letters.map((l) => (\n                    <span\n                      key={l.i}\n                      ref={(el) => {\n                        if (el) items.current[l.i] = el;\n                      }}\n                      className=\"hb-qt2-i\"\n                      style={initial}\n                    >\n                      {l.ch}\n                    </span>\n                  ))}\n                </span>\n              )\n            )}\n          </span>\n        ))}\n      </div>\n    </div>\n  );\n}\n"
    }
  ]
}