50:I[707087,["/_next/static/immutable/chunks/2985g-hklwiee.js","/_next/static/immutable/chunks/0qkc3dps_9x_i.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3thksmxn95rly.js","/_next/static/immutable/chunks/15bpbjna9-vr3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/0agonoz1szsjm.js","/_next/static/immutable/chunks/1ynd3dcge2kn1.js","/_next/static/immutable/chunks/0krdn-21gkgjt.js","/_next/static/immutable/chunks/0n9w9riw96l80.js","/_next/static/immutable/chunks/0w75qangey2ys.js","/_next/static/immutable/chunks/1tge7vcvsb70s.js","/_next/static/immutable/chunks/35ju_ac0ysz07.js"],"RegistryDependencies"] 51:I[512940,["/_next/static/immutable/chunks/2985g-hklwiee.js","/_next/static/immutable/chunks/0qkc3dps_9x_i.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3thksmxn95rly.js","/_next/static/immutable/chunks/15bpbjna9-vr3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/0agonoz1szsjm.js","/_next/static/immutable/chunks/1ynd3dcge2kn1.js","/_next/static/immutable/chunks/0krdn-21gkgjt.js","/_next/static/immutable/chunks/0n9w9riw96l80.js","/_next/static/immutable/chunks/0w75qangey2ys.js","/_next/static/immutable/chunks/1tge7vcvsb70s.js","/_next/static/immutable/chunks/35ju_ac0ysz07.js"],"Installation"] 52:I[314491,["/_next/static/immutable/chunks/2985g-hklwiee.js","/_next/static/immutable/chunks/0qkc3dps_9x_i.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3thksmxn95rly.js","/_next/static/immutable/chunks/15bpbjna9-vr3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/0agonoz1szsjm.js","/_next/static/immutable/chunks/1ynd3dcge2kn1.js","/_next/static/immutable/chunks/0krdn-21gkgjt.js","/_next/static/immutable/chunks/0n9w9riw96l80.js","/_next/static/immutable/chunks/0w75qangey2ys.js","/_next/static/immutable/chunks/1tge7vcvsb70s.js","/_next/static/immutable/chunks/35ju_ac0ysz07.js"],"FilesView"] 53:T1c2c,'use client'; import * as React from 'react'; import { AnimatePresence, motion, type Variants, useReducedMotion, type Easing, } from 'motion/react'; import { cn } from '@/lib/utils'; interface StaggerCharsProps { text: string; hoverText?: string; delay?: number; duration?: number; className?: string; hoverClassName?: string; direction?: 'up' | 'down' | 'alternate'; easing?: Easing; disabled?: boolean; onAnimationStart?: () => void; onAnimationComplete?: () => void; } const useProcessedChars = (text: string, hoverText?: string) => React.useMemo(() => { const base = text.split(''); const hover = (hoverText ?? text).split(''); const max = Math.max(base.length, hover.length); return { safeBase: Array.from({ length: max }, (_, i) => base[i] ?? ' '), safeHover: Array.from({ length: max }, (_, i) => hover[i] ?? ' '), }; }, [text, hoverText]); const useIsTouchDevice = () => { const [isTouch, setIsTouch] = React.useState(false); React.useEffect(() => { const check = () => setIsTouch('ontouchstart' in window || navigator.maxTouchPoints > 0); check(); window.addEventListener('resize', check); return () => window.removeEventListener('resize', check); }, []); return isTouch; }; const getInitialY = ( direction: StaggerCharsProps['direction'], isEven: boolean, ) => { switch (direction) { case 'up': return '0%'; case 'down': return '-50%'; case 'alternate': default: return isEven ? '-50%' : '0%'; } }; const getTargetY = ( direction: StaggerCharsProps['direction'], isEven: boolean, ) => { switch (direction) { case 'up': return '-50%'; case 'down': return '0%'; case 'alternate': default: return isEven ? '0%' : '-50%'; } }; const StaggerChars = React.memo( ({ text, hoverText, hoverClassName, delay = 0.05, duration = 1, className, direction = 'alternate', easing = [0.22, 1, 0.36, 1], disabled = false, onAnimationStart, onAnimationComplete, }) => { const { safeBase, safeHover } = useProcessedChars(text, hoverText); const prefersReducedMotion = useReducedMotion(); const isTouchDevice = useIsTouchDevice(); const [isHovered, setIsHovered] = React.useState(false); const [isAutoAnimating, setIsAutoAnimating] = React.useState(false); const intervalRef = React.useRef(undefined); React.useEffect(() => { if (!isTouchDevice || disabled) return; const timeout = setTimeout(() => { setIsAutoAnimating(true); onAnimationStart?.(); intervalRef.current = setInterval( () => setIsAutoAnimating((prev) => !prev), 2000, ); }, 1000); return () => { clearTimeout(timeout); if (intervalRef.current) clearInterval(intervalRef.current); }; }, [isTouchDevice, disabled, onAnimationStart]); const containerVariants: Variants = { initial: {}, hover: { transition: { staggerChildren: prefersReducedMotion ? 0 : delay, }, }, exit: {}, }; const stackVariants: Variants = { initial: ({ isEven }: { index: number; isEven: boolean }) => prefersReducedMotion ? { y: '0%' } : { y: getInitialY(direction, isEven) }, hover: ({ index, isEven }: { index: number; isEven: boolean }) => prefersReducedMotion ? { y: '0%' } : { y: getTargetY(direction, isEven), transition: { duration, delay: index * delay, ease: easing, }, }, exit: ({ isEven }: { index: number; isEven: boolean }) => prefersReducedMotion ? { y: '0%' } : { y: getInitialY(direction, isEven) }, }; const handleHoverStart = () => { if (disabled || isTouchDevice) return; setIsHovered(true); onAnimationStart?.(); }; const handleHoverEnd = () => { if (disabled || isTouchDevice) return; setIsHovered(false); onAnimationComplete?.(); }; return ( {safeBase.map((char, index) => { const nextChar = safeHover[index]; const isSpace = char === ' ' && nextChar === ' '; const isEven = index % 2 === 0; return ( {isEven && ( {isSpace ? '\u00A0' : nextChar} )} {isSpace ? '\u00A0' : char} {!isEven && ( {isSpace ? '\u00A0' : nextChar} )} ); })} ); }, ); StaggerChars.displayName = 'StaggerChars'; export type { StaggerCharsProps }; export default StaggerChars; 4c:["$","div",null,{"className":"flex flex-col gap-12","children":[["$","div",null,{"className":"pt-10 flex flex-col gap-4","children":[["$","ul",null,{"className":"flex gap-2 flex-wrap","children":[["$","li","motion",{"children":["$","a",null,{"href":"https://www.npmjs.com/package/motion","target":"_blank","rel":"noopener noreferrer","className":"rounded-md border p-2 text-sm flex items-center gap-1 ","children":[["$","svg",null,{"viewBox":"0 0 24 24","className":"size-3","children":["$","path",null,{"d":"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","fill":"currentColor"}]}],["$","span",null,{"className":"text-xs font-medium","children":"motion"}]]}]}],["$","li","clsx",{"children":["$","a",null,{"href":"https://www.npmjs.com/package/clsx","target":"_blank","rel":"noopener noreferrer","className":"rounded-md border p-2 text-sm flex items-center gap-1 ","children":[["$","svg",null,{"viewBox":"0 0 24 24","className":"size-3","children":["$","path",null,{"d":"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","fill":"currentColor"}]}],["$","span",null,{"className":"text-xs font-medium","children":"clsx"}]]}]}],["$","li","tailwind-merge",{"children":["$","a",null,{"href":"https://www.npmjs.com/package/tailwind-merge","target":"_blank","rel":"noopener noreferrer","className":"rounded-md border p-2 text-sm flex items-center gap-1 ","children":[["$","svg",null,{"viewBox":"0 0 24 24","className":"size-3","children":["$","path",null,{"d":"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","fill":"currentColor"}]}],["$","span",null,{"className":"text-xs font-medium","children":"tailwind-merge"}]]}]}]]}],["$","$L50",null,{"registryDependencies":[]}]]}],["$","$L51",null,{"sourceUrl":"https://www.scrollxui.dev/registry/stagger-chars.json","proxyUrl":"https://shadcnregistry.com/r/scrollxui/stagger-chars","itemId":"@scrollxui/stagger-chars"}],["$","section",null,{"className":"flex flex-col gap-4","id":"files","children":[["$","h2",null,{"className":"text-lg md:text-2xl font-bold font-mono","children":"Files"}],["$","$L52",null,{"files":[{"path":"components/ui/stagger-chars.tsx","content":"$53","type":"registry:ui"},{"path":"lib/utils.ts","content":"import { clsx, type ClassValue } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs));\n}","type":"registry:lib"}]}]]}],"$L54"]}]

Stagger Chars

Installation

Files

components

lib

Styles