/**
 * @fileoverview Animated gradient text component.
 * @author Saasflare™
 * Applies an animated linear gradient to text via background-clip.
 * Supports static and animated modes with configurable colors and speed.
 * @module packages/ui/components/ui/gradient-text
 * @package ui
 *
 * @component
 * @example
 * import { GradientText } from '@saasflare/ui';
 * <h1>
 *   Build with <GradientText>Saasflare</GradientText>
 * </h1>
 *
 * @example
 * // Custom gradient and animation
 * <GradientText
 *   colors={["var(--chart-1)", "var(--chart-3)", "var(--chart-5)"]}
 *   speed={4}
 * >
 *   Premium Feature
 * </GradientText>
 */
import { type ReactNode } from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the GradientText component. */
export interface GradientTextProps extends Omit<React.ComponentProps<"span">, keyof SaasflareComponentProps | "color">, SaasflareComponentProps {
    /** Text content to apply the gradient to. */
    children: ReactNode;
    /** Gradient color stops. Default: `--primary` → `--chart-1` → `--chart-2` design tokens (OKLCH). */
    colors?: string[];
    /**
     * Per-instance toggle for the gradient-position animation. Default: `true`.
     * Layered on top of the design-system `animated` axis — the gradient only
     * shifts when both this and the resolved `animated` flag are enabled.
     */
    animate?: boolean;
    /** Animation cycle duration in seconds. Default: `6` */
    speed?: number;
    /** Gradient direction in degrees. Default: `90` */
    angle?: number;
    /** Additional class names. */
    className?: string;
}
/**
 * Text with a vibrant gradient fill, optionally animated.
 *
 * - Uses `background-clip: text` for the gradient effect
 * - Animates via CSS `@keyframes` (no JS frames); honors the `animated` axis
 * - Falls back to a static gradient when reduced motion is preferred
 * - Renders as an inline `<span>` to nest inside any heading or paragraph
 *
 * @component
 * @package ui
 */
export declare function GradientText({ children, colors, animate, speed, angle, className, surface, radius, animated, iconWeight, style, ...props }: GradientTextProps): import("react/jsx-runtime").JSX.Element;