/**
 * @fileoverview Rotating word animation — "Build [websites/apps/products] faster".
 * @author Saasflare™
 * Cycles through an array of words with a vertical flip animation.
 * The container auto-sizes to the longest word to prevent layout shifts.
 * @module packages/ui/components/ui/flip-words
 * @package ui
 *
 * @component
 * @example
 * import { FlipWords } from '@saasflare/ui';
 * <h1>
 *   Build <FlipWords words={["websites", "apps", "products"]} /> faster
 * </h1>
 *
 * @example
 * // Custom interval and color
 * <FlipWords
 *   words={["scalable", "reliable", "beautiful"]}
 *   interval={3000}
 *   className="text-primary"
 * />
 *
 * @example
 * // Freeze the flip via the provider kill-switch or per-instance
 * <FlipWords words={["websites", "apps"]} animated={false} />
 */
import * as React from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the FlipWords component. */
export interface FlipWordsProps extends Omit<React.ComponentProps<"span">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Array of words to cycle through. */
    words: string[];
    /** Cycle interval in milliseconds. Default: `2500` */
    interval?: number;
    /** Additional class names. */
    className?: string;
}
/**
 * Inline word rotator with vertical flip animation.
 *
 * - Words flip upward with a spring transition
 * - Container width matches the longest word to prevent layout shifts
 * - Falls back to showing the first word statically when motion is disabled
 *   (reduced-motion preference or `animated={false}` from prop/provider)
 * - Renders inline, so it can be placed mid-sentence
 *
 * @component
 * @package ui
 */
export declare function FlipWords({ words, interval, className, surface, radius, animated, iconWeight, ...rest }: FlipWordsProps): import("react/jsx-runtime").JSX.Element;