51: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"] 52: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"] 53: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"] 54:T1981,/** biome-ignore-all lint/suspicious/noArrayIndexKey: fixed-size particle pool, never reordered/resized. */ "use client"; import { cn } from "@/lib/utils"; import { animate } from "motion"; import { type ReactNode, type PointerEvent as ReactPointerEvent, type Ref, type RefCallback, useEffect, useRef, } from "react"; import { usePrefersReducedMotion } from "@/hooks/use-prefers-reduced-motion"; const DEFAULT_PARTICLE = ( ); const PARTICLE_CLASS = "-translate-x-1/2 -translate-y-1/2 absolute top-0 left-0 opacity-0 [filter:drop-shadow(0_0_3px_currentColor)] dark:[mix-blend-mode:plus-lighter]"; export interface ParticleHoverButtonClassNames { /** The wrapper around `children` that pulses on hover. */ content?: string; /** Each cloned particle node. */ particle?: string; } export interface ParticleHoverButtonProps { /** The interactive element (or plain label) this wraps — its own attributes/behavior are untouched. */ children: ReactNode; className?: string; /** Per-slot class overrides: `content`, `particle`. */ classNames?: ParticleHoverButtonClassNames; /** * Particle lifetime, in milliseconds. * @default 1200 */ duration?: number; /** * Milliseconds between each particle emission while hovering. * @default 100 */ interval?: number; /** The node cloned for each emitted particle. @default a small filled dot */ particle?: ReactNode; /** * Number of pooled particle nodes reused across emissions — caps how * many can be on screen at once, regardless of how long the pointer * lingers. * @default 24 */ poolSize?: number; ref?: Ref; /** * Horizontal drift jitter per particle, in pixels. * @default 16 */ spread?: number; } function mergeRefs(...refs: (Ref | undefined)[]): RefCallback { return (node) => { for (const ref of refs) { if (!ref) { continue; } if (typeof ref === "function") { ref(node); } else { ref.current = node; } } }; } function clamp(value: number, min: number, max: number) { return Math.min(Math.max(value, min), max); } export function ParticleHoverButton({ children, className, classNames, duration = 1200, interval = 100, particle = DEFAULT_PARTICLE, poolSize = 24, ref, spread = 16, }: ParticleHoverButtonProps) { const prefersReducedMotion = usePrefersReducedMotion(); const rootRef = useRef(null); const contentRef = useRef(null); const particleRefs = useRef<(HTMLSpanElement | null)[]>([]); const inUseRef = useRef([]); const pointerRef = useRef({ x: 0, y: 0 }); const emitIntervalRef = useRef | null>(null); const pulseControlsRef = useRef | null>(null); const activeParticleAnimationsRef = useRef>>( new Set() ); useEffect( () => () => { if (emitIntervalRef.current !== null) { clearInterval(emitIntervalRef.current); } pulseControlsRef.current?.stop(); for (const controls of activeParticleAnimationsRef.current) { controls.stop(); } activeParticleAnimationsRef.current.clear(); }, [] ); const updatePointer = (e: ReactPointerEvent) => { const root = rootRef.current; if (!root) { return; } const rect = root.getBoundingClientRect(); pointerRef.current = { x: clamp(e.clientX - rect.left, 0, rect.width), y: clamp(e.clientY - rect.top, 0, rect.height), }; }; const emitParticle = () => { const index = inUseRef.current.findIndex((inUse) => !inUse); if (index === -1) { return; } const el = particleRefs.current[index]; if (!el) { return; } inUseRef.current[index] = true; el.style.left = `${pointerRef.current.x}px`; el.style.top = `${pointerRef.current.y}px`; const jitterA = (Math.random() * 2 - 1) * spread; const jitterB = (Math.random() * 2 - 1) * spread; const drift = 30 + Math.random() * 20; const controls = animate( el, { opacity: [0, 1, 1, 0], scale: [0, 0.85, 0], x: [0, jitterA, jitterB], y: [0, -drift], }, { duration: duration / 1000, ease: "easeOut" } ); activeParticleAnimationsRef.current.add(controls); controls.then(() => { inUseRef.current[index] = false; activeParticleAnimationsRef.current.delete(controls); }); }; const handlePointerEnter = (e: ReactPointerEvent) => { if (prefersReducedMotion) { return; } updatePointer(e); if (emitIntervalRef.current === null) { emitIntervalRef.current = setInterval(emitParticle, interval); } pulseControlsRef.current?.stop(); if (contentRef.current) { pulseControlsRef.current = animate( contentRef.current, { scale: [1, 1.04, 1] }, { duration: 0.9, ease: "easeInOut", repeat: Number.POSITIVE_INFINITY } ); } }; const handlePointerLeave = () => { if (emitIntervalRef.current !== null) { clearInterval(emitIntervalRef.current); emitIntervalRef.current = null; } pulseControlsRef.current?.stop(); if (contentRef.current) { pulseControlsRef.current = animate( contentRef.current, { scale: 1 }, { duration: 0.3 } ); } }; return ( {children} {prefersReducedMotion ? null : ( )} ); } 4d:["$","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"}]]}]}]]}],["$","$L51",null,{"registryDependencies":["@soralabs/hooks-use-prefers-reduced-motion"]}]]}],["$","$L52",null,{"sourceUrl":"https://ui.soralabs.io.vn/r/particle-hover-button.json","proxyUrl":"https://shadcnregistry.com/r/soralabs/particle-hover-button","itemId":"@soralabs/particle-hover-button"}],["$","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"}],["$","$L53",null,{"files":[{"path":"registry/primitives/buttons/particle-hover-button/index.tsx","content":"$54","type":"registry:ui","target":"components/sora-ui/buttons/particle-hover-button.tsx"}]}]]}],"$L55"]}]

Particle Hover Button

Installation

Files

components

Styles