feat: add hogfetti (#25443)

Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>

frontend/src/lib/components/Hogfetti/Hogfetti.stories.tsx

@@ -0,0 +1,30 @@
+import { LemonBanner, LemonButton } from '@posthog/lemon-ui'
+import { Meta } from '@storybook/react'
+
+import { useHogfetti } from './Hogfetti'
+
+const meta: Meta = {
+    title: 'Components/Hogfetti',
+}
+export default meta
+
+export function Hogfetti(): JSX.Element {
+    const { trigger, HogfettiComponent } = useHogfetti()
+
+    const handleClick = (): void => {
+        trigger()
+    }
+
+    return (
+        <>
+            <HogfettiComponent />
+            <LemonButton type="secondary" onClick={handleClick}>
+                Trigger Hogfetti
+            </LemonButton>
+            <LemonBanner type="warning" className="mt-4">
+                The rendering in Storybook is not the same as in the app so it may appear laggy here but it should be
+                working as expected in the app.
+            </LemonBanner>
+        </>
+    )
+}

frontend/src/lib/components/Hogfetti/Hogfetti.tsx

@@ -0,0 +1,165 @@
+import {
+    BlushingHog,
+    DetectiveHog,
+    ExperimentsHog,
+    ExplorerHog,
+    FeatureFlagHog,
+    HeartHog,
+    HospitalHog,
+    ListHog,
+    MailHog,
+    MicrophoneHog,
+    PoliceHog,
+    ProfessorHog,
+    ReadingHog,
+    RunningHog,
+    SleepingHog,
+    SpaceHog,
+    StarHog,
+    SupportHeroHog,
+    SurprisedHog,
+    TronHog,
+    WavingHog,
+    XRayHog,
+    XRayHog2,
+} from 'lib/components/hedgehogs'
+import React, { useCallback, useEffect, useState } from 'react'
+
+export type HogComponent = React.ComponentType<{ width: number; height: number }>
+
+const images: HogComponent[] = [
+    SurprisedHog,
+    XRayHog,
+    XRayHog2,
+    HospitalHog,
+    BlushingHog,
+    ExplorerHog,
+    RunningHog,
+    SpaceHog,
+    TronHog,
+    HeartHog,
+    StarHog,
+    PoliceHog,
+    SleepingHog,
+    ProfessorHog,
+    SupportHeroHog,
+    DetectiveHog,
+    MailHog,
+    FeatureFlagHog,
+    ExperimentsHog,
+    ListHog,
+    WavingHog,
+    ReadingHog,
+    MicrophoneHog,
+]
+
+interface Particle {
+    x: number
+    y: number
+    vx: number
+    vy: number
+    size: number
+    imageIndex: number
+    opacity: number
+}
+
+interface HogfettiOptions {
+    count?: number
+    power?: number
+    duration?: number
+    maxSize?: number
+}
+
+interface HogfettiHook {
+    trigger: () => void
+    HogfettiComponent: React.FC
+}
+
+export const useHogfetti = (options: HogfettiOptions = {}): HogfettiHook => {
+    const [particleSets, setParticleSets] = useState<Particle[][]>([])
+    const [dimensions, setDimensions] = useState({ width: window.innerWidth, height: window.innerHeight })
+
+    useEffect(() => {
+        const handleResize = (): void => {
+            setDimensions({ width: window.innerWidth, height: window.innerHeight })
+        }
+
+        window.addEventListener('resize', handleResize)
+        return () => window.removeEventListener('resize', handleResize)
+    }, [])
+
+    const { count = 50, power = 5, duration = 2000, maxSize = 60 } = options
+
+    const createParticle = (centerX: number, centerY: number): Particle => {
+        const angle = Math.random() * Math.PI * 2
+        const velocity = Math.random() * power + 2
+        return {
+            x: centerX,
+            y: centerY,
+            vx: Math.cos(angle) * velocity,
+            vy: Math.sin(angle) * velocity,
+            size: Math.random() * (maxSize - 20) + 20,
+            imageIndex: Math.floor(Math.random() * images.length),
+            opacity: 1,
+        }
+    }
+
+    const trigger = useCallback((): void => {
+        const centerX = Math.random() * dimensions.width
+        const centerY = Math.random() * dimensions.height
+
+        const newParticles = Array.from({ length: count }, () => createParticle(centerX, centerY))
+        setParticleSets((prev) => [...prev, newParticles])
+
+        const startTime = Date.now()
+        const animationFrame = (): void => {
+            const elapsed = Date.now() - startTime
+            if (elapsed < duration) {
+                setParticleSets((prevSets) =>
+                    prevSets.map((set) =>
+                        set.map((particle) => ({
+                            ...particle,
+                            x: particle.x + particle.vx,
+                            y: particle.y + particle.vy,
+                            vy: particle.vy + 0.1, // Gravity effect
+                            vx: particle.vx * 0.99, // Air resistance
+                            opacity: 1 - elapsed / duration,
+                        }))
+                    )
+                )
+                requestAnimationFrame(animationFrame)
+            } else {
+                setParticleSets((prev) => prev.slice(1))
+            }
+        }
+        requestAnimationFrame(animationFrame)
+    }, [count, power, duration, maxSize, dimensions])
+
+    const HogfettiComponent: React.FC = () => (
+        // eslint-disable-next-line react/forbid-dom-props
+        <div className="fixed top-0 left-0 w-full h-full pointer-events-none" style={{ zIndex: 9999 }}>
+            {particleSets.flatMap((set, setIndex) =>
+                set.map((particle, particleIndex) => {
+                    const HogComponent = images[particle.imageIndex]
+                    return (
+                        <div
+                            key={`${setIndex}-${particleIndex}`}
+                            className="absolute"
+                            // eslint-disable-next-line react/forbid-dom-props
+                            style={{
+                                left: `${particle.x}px`,
+                                top: `${particle.y}px`,
+                                opacity: particle.opacity,
+                                transition: 'opacity 0.1s linear',
+                            }}
+                        >
+                            <HogComponent width={particle.size} height={particle.size} />
+                        </div>
+                    )
+                })
+            )}
+        </div>
+    )
+
+    return { trigger, HogfettiComponent }
+}