"use client"; /** * @author: @kokonutui * @description: AI Text Loading * @version: 2.0.0 * @date: 2026-10-14 * @license: MIT * @website: https://kokonutui.com * @github: https://github.com/kokonut-labs/kokonutui */ import { AnimatePresence, MotionConfig, motion, type Variants, } from "motion/react"; import { useEffect, useState } from "react"; import { cn } from "@/lib/utils"; interface AITextLoadingProps { texts?: string[]; className?: string; interval?: number; /** Stable status for screen readers; the cycling words are hidden from them. */ label?: string; /** Show the seconds spent so far next to the words. */ showElapsed?: boolean; } const EASE_OUT = [0.23, 1, 0.32, 1] as const; // Gap between neighbouring letters in the wave, and one wave's length. const WAVE_STEP = 0.07; const WAVE_CSS = ` @keyframes kokonut-ai-wave { 50% { opacity: 0.3; } } .kokonut-ai-wave { animation: kokonut-ai-wave 1.6s ease-in-out infinite both; } @media (prefers-reduced-motion: reduce) { .kokonut-ai-wave { animation: none; } } `; const wordVariants = { enter: {}, shown: { transition: { staggerChildren: 0.018 } }, exit: { opacity: 0, y: -6, filter: "blur(3px)", transition: { duration: 0.15, ease: EASE_OUT }, }, } satisfies Variants; const letterVariants = { enter: { opacity: 0, y: 8, filter: "blur(4px)" }, shown: { opacity: 1, y: 0, filter: "blur(0px)", transition: { duration: 0.28, ease: EASE_OUT }, }, } satisfies Variants; export default function AITextLoading({ texts = [ "Thinking...", "Processing...", "Analyzing...", "Computing...", "Almost...", ], className, interval = 1500, label = "Loading", showElapsed = false, }: AITextLoadingProps) { const [currentTextIndex, setCurrentTextIndex] = useState(0); const [seconds, setSeconds] = useState(0); // Clamped, so a shorter (or empty) `texts` never reads past the end. const textIndex = texts.length > 0 ? currentTextIndex % texts.length : 0; const text = texts[textIndex] ?? ""; useEffect(() => { if (texts.length < 2) { return; } const timer = setInterval(() => { setCurrentTextIndex((prevIndex) => (prevIndex + 1) % texts.length); }, interval); return () => clearInterval(timer); }, [interval, texts.length]); useEffect(() => { if (!showElapsed) { return; } const startedAt = Date.now(); const timer = setInterval( () => setSeconds(Math.floor((Date.now() - startedAt) / 1000)), 500 ); return () => clearInterval(timer); }, [showElapsed]); return ( {/* React hoists and dedupes this, so several loaders share one copy. */} {label} {/* With reduced motion the words swap with a fade only, and the letters hold still instead of waving. */} {Array.from(text).map((char, i) => ( {/* A soft brightness wave runs through the letters, left to right, in place of a gradient shimmer. CSS keeps the endless loop off the main thread. */} {char} ))} {showElapsed && ( )} ); }

AI Text Loading

On this page