{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "reveal-text",
  "type": "registry:ui",
  "registryDependencies": [],
  "dependencies": ["motion"],
  "devDependencies": [],
  "files": [
    {
      "path": "reveal-text.tsx",
      "content": "\"use client\";\n\nimport {\n  motion,\n  type Transition,\n  useInView,\n  useReducedMotion,\n} from \"motion/react\";\nimport {\n  createElement,\n  type ElementType,\n  type ReactNode,\n  type RefObject,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\ntype SplitMode = \"word\" | \"char\";\n\nconst EASE_OUT = [0.16, 1, 0.3, 1] as const;\nconst DEFAULT_SPRING = { stiffness: 140, damping: 26, mass: 1.2 };\nconst WORD_SPLIT_REGEX = /\\s+/;\nconst IN_VIEW_OPTIONS = {\n  amount: \"some\" as const,\n  margin: \"0px 0px -4% 0px\" as const,\n};\nconst REVEAL_READY_TIMEOUT_MS = 500;\nconst COARSE_POINTER_QUERY = \"(pointer: coarse)\";\n\nexport interface RevealTextProps {\n  text: string | string[];\n  as?: ElementType;\n  className?: string;\n  split?: SplitMode;\n  stagger?: number;\n  delay?: number;\n  blur?: number;\n  yOffset?: string | number;\n  spring?: { stiffness?: number; damping?: number; mass?: number };\n  once?: boolean;\n  whileInView?: boolean;\n  children?: ReactNode;\n}\n\ntype RevealUnit = {\n  lineKey: string;\n  unit: string;\n  unitKey: string;\n  unitDelay: number;\n  showSpaceAfter: boolean;\n};\n\ntype RevealTextUnitProps = {\n  unit: RevealUnit;\n  blur: number;\n  yOffset: string | number;\n  useBlur: boolean;\n  reduceMotion: boolean | null;\n  shouldAnimate: boolean;\n  springConfig: { stiffness: number; damping: number; mass: number };\n};\n\nfunction splitLine(line: string, split: SplitMode) {\n  if (split === \"char\") {\n    return Array.from(line);\n  }\n\n  return line.split(WORD_SPLIT_REGEX).filter(Boolean);\n}\n\nfunction getUnitMotionState({\n  unit,\n  blur,\n  yOffset,\n  useBlur,\n  reduceMotion,\n  shouldAnimate,\n  springConfig,\n}: RevealTextUnitProps) {\n  const initial = reduceMotion\n    ? { opacity: 0 }\n    : {\n        y: yOffset,\n        opacity: 0,\n        ...(useBlur ? { filter: `blur(${blur}px)` } : {}),\n      };\n  const revealed = reduceMotion\n    ? { opacity: 1 }\n    : {\n        y: 0,\n        opacity: 1,\n        ...(useBlur ? { filter: \"blur(0px)\" } : {}),\n      };\n  const animate = shouldAnimate ? revealed : initial;\n  const transition: Transition = reduceMotion\n    ? {\n        opacity: {\n          duration: 0.25,\n          ease: EASE_OUT,\n          delay: unit.unitDelay * 0.3,\n        },\n      }\n    : {\n        y: {\n          type: \"spring\" as const,\n          ...springConfig,\n          delay: unit.unitDelay,\n        },\n        opacity: {\n          duration: 0.7,\n          ease: EASE_OUT,\n          delay: unit.unitDelay,\n        },\n        ...(useBlur\n          ? {\n              filter: {\n                duration: 0.9,\n                ease: EASE_OUT,\n                delay: unit.unitDelay,\n              },\n            }\n          : {}),\n      };\n\n  return { initial, animate, transition };\n}\n\nfunction RevealTextUnit(props: RevealTextUnitProps) {\n  const { unit } = props;\n  const { initial, animate, transition } = getUnitMotionState(props);\n\n  return (\n    <motion.span\n      animate={animate}\n      className={cn(\n        \"inline-block transform-gpu\",\n        props.useBlur\n          ? \"will-change-[transform,opacity,filter]\"\n          : \"will-change-[transform,opacity]\"\n      )}\n      initial={initial}\n      transition={transition}\n    >\n      {unit.unit}\n      {unit.showSpaceAfter ? (\n        <span className=\"inline-block\">&nbsp;</span>\n      ) : null}\n    </motion.span>\n  );\n}\n\nfunction subscribeCoarsePointer(onStoreChange: () => void) {\n  const coarseMedia = window.matchMedia(COARSE_POINTER_QUERY);\n  coarseMedia.addEventListener(\"change\", onStoreChange);\n\n  return () => {\n    coarseMedia.removeEventListener(\"change\", onStoreChange);\n  };\n}\n\nfunction getCoarsePointerSnapshot() {\n  return window.matchMedia(COARSE_POINTER_QUERY).matches;\n}\n\nfunction getCoarsePointerServerSnapshot() {\n  return false;\n}\n\nfunction useCoarsePointer() {\n  return useSyncExternalStore(\n    subscribeCoarsePointer,\n    getCoarsePointerSnapshot,\n    getCoarsePointerServerSnapshot\n  );\n}\n\nfunction isElementVisible(node: HTMLElement) {\n  const rect = node.getBoundingClientRect();\n  if (rect.width === 0 || rect.height === 0) return false;\n\n  const viewHeight =\n    window.innerHeight || document.documentElement.clientHeight;\n  const viewWidth = window.innerWidth || document.documentElement.clientWidth;\n\n  return (\n    rect.bottom > 0 &&\n    rect.right > 0 &&\n    rect.top < viewHeight &&\n    rect.left < viewWidth\n  );\n}\n\nfunction useRevealReady(\n  ref: RefObject<HTMLElement | null>,\n  enabled: boolean,\n  inView: boolean\n) {\n  const [ready, setReady] = useState(!enabled);\n\n  useEffect(() => {\n    if (!enabled) {\n      setReady(true);\n      return;\n    }\n\n    if (inView) {\n      setReady(true);\n    }\n  }, [enabled, inView]);\n\n  useEffect(() => {\n    if (!enabled || ready) return;\n\n    const node = ref.current;\n    if (!node) return;\n\n    if (isElementVisible(node)) {\n      setReady(true);\n      return;\n    }\n\n    const frame = requestAnimationFrame(() => {\n      if (node && isElementVisible(node)) {\n        setReady(true);\n      }\n    });\n\n    const timeout = window.setTimeout(() => {\n      if (node && isElementVisible(node)) {\n        setReady(true);\n      }\n    }, REVEAL_READY_TIMEOUT_MS);\n\n    return () => {\n      cancelAnimationFrame(frame);\n      window.clearTimeout(timeout);\n    };\n  }, [enabled, ready, ref]);\n\n  return ready;\n}\n\nfunction buildRevealUnits(\n  lines: string[],\n  split: SplitMode,\n  delay: number,\n  stagger: number\n) {\n  const units: RevealUnit[] = [];\n  const lineCounts = new Map<string, number>();\n  let unitIndex = 0;\n\n  for (const line of lines) {\n    if (!line) continue;\n\n    const lineCount = lineCounts.get(line) ?? 0;\n    lineCounts.set(line, lineCount + 1);\n    const lineKey = `${line}-${lineCount}`;\n    const lineUnits = splitLine(line, split);\n    const unitCounts = new Map<string, number>();\n\n    lineUnits.forEach((unit, index) => {\n      const unitCount = unitCounts.get(unit) ?? 0;\n      unitCounts.set(unit, unitCount + 1);\n\n      units.push({\n        lineKey,\n        unit,\n        unitKey: `${lineKey}-${unit}-${unitCount}`,\n        unitDelay: delay + unitIndex * stagger,\n        showSpaceAfter: split === \"word\" && index < lineUnits.length - 1,\n      });\n\n      unitIndex += 1;\n    });\n  }\n\n  return units;\n}\n\nexport function RevealText({\n  text,\n  as: Comp = \"span\",\n  className,\n  split = \"word\",\n  stagger = 0.09,\n  delay = 0,\n  blur = 12,\n  yOffset = \"40%\",\n  spring,\n  once = true,\n  whileInView = false,\n  children,\n}: RevealTextProps) {\n  const ref = useRef<HTMLElement>(null);\n  const wasInView = useRef(false);\n  const reduceMotion = useReducedMotion();\n  const isCoarsePointer = useCoarsePointer();\n  const useBlur = !(isCoarsePointer || reduceMotion) && blur > 0;\n  const inView = useInView(ref, { ...IN_VIEW_OPTIONS, once });\n  const inViewReady = useRevealReady(ref, whileInView, inView);\n  const [replayKey, setReplayKey] = useState(0);\n\n  const lines = useMemo(\n    () => (Array.isArray(text) ? text : [text]).filter(Boolean),\n    [text]\n  );\n  const accessibleText = useMemo(() => lines.join(\" \"), [lines]);\n  const revealUnits = useMemo(\n    () => buildRevealUnits(lines, split, delay, stagger),\n    [delay, lines, split, stagger]\n  );\n  const unitsByLine = useMemo(() => {\n    const grouped = new Map<string, RevealUnit[]>();\n\n    for (const unit of revealUnits) {\n      const lineUnits = grouped.get(unit.lineKey) ?? [];\n      lineUnits.push(unit);\n      grouped.set(unit.lineKey, lineUnits);\n    }\n\n    return grouped;\n  }, [revealUnits]);\n  const lineKeys = useMemo(() => [...unitsByLine.keys()], [unitsByLine]);\n\n  useEffect(() => {\n    if (!(whileInView && inView)) return;\n\n    if (!once && wasInView.current) {\n      setReplayKey((current) => current + 1);\n    }\n\n    wasInView.current = true;\n  }, [inView, once, whileInView]);\n\n  const shouldAnimate = whileInView ? inViewReady : true;\n  const springConfig = { ...DEFAULT_SPRING, ...spring };\n  const unitMotionProps = {\n    blur,\n    yOffset,\n    useBlur,\n    reduceMotion,\n    shouldAnimate,\n    springConfig,\n  };\n\n  if (!accessibleText) {\n    return children\n      ? createElement(Comp, { className: cn(\"block\", className) }, children)\n      : null;\n  }\n\n  const animatedContent = (\n    <span key={`${replayKey}-${isCoarsePointer ? \"touch\" : \"fine\"}`}>\n      {lineKeys.map((lineKey) => (\n        <span className=\"block\" key={lineKey}>\n          {(unitsByLine.get(lineKey) ?? []).map((unit) => (\n            <RevealTextUnit\n              key={unit.unitKey}\n              unit={unit}\n              {...unitMotionProps}\n            />\n          ))}\n        </span>\n      ))}\n    </span>\n  );\n\n  return (\n    <>\n      <span className=\"sr-only\">{accessibleText}</span>\n      {createElement(\n        Comp,\n        {\n          ref,\n          className: cn(\"block\", className),\n          \"aria-hidden\": true,\n        },\n        animatedContent\n      )}\n      {children}\n    </>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "title": "Reveal Text",
  "description": "Staggered word or character reveal with spring lift, blur fade, and optional scroll-triggered playback."
}
