/**
 * @fileoverview Button with a sweeping shimmer/shine effect.
 * @author Saasflare™
 * A CTA button with a diagonal light sweep animation that loops infinitely.
 * Self-contained implementation that participates in the Saasflare theming
 * contract (surface / radius / animated).
 * @module packages/ui/components/ui/shimmer-button
 * @package ui
 *
 * @component
 * @example
 * import { ShimmerButton } from '@saasflare/ui';
 * <ShimmerButton>Get Started Free</ShimmerButton>
 *
 * @example
 * // Custom shimmer color and speed
 * <ShimmerButton shimmerColor="var(--primary-foreground)" speed={3}>
 *   Launch Your SaaS
 * </ShimmerButton>
 */
import * as React from "react";
import { type ReactNode } from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the ShimmerButton component. */
export interface ShimmerButtonProps extends Omit<React.ComponentProps<"button">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Button content. */
    children: ReactNode;
    /** Color of the shimmer highlight. Default: `"var(--primary-foreground)"` */
    shimmerColor?: string;
    /** Shimmer cycle duration in seconds. Default: `2.5` */
    speed?: number;
    /** Background color. Default: `"var(--primary)"` */
    background?: string;
}
/**
 * CTA button with a continuously sweeping shimmer effect.
 *
 * - Diagonal light sweep loops infinitely
 * - CSS-only animation (no JS frames)
 * - Falls back to a static button when reduced motion is preferred or
 *   when `animated` is disabled via prop/provider
 * - Inherits standard button props (onClick, disabled, etc.)
 *
 * @component
 * @package ui
 */
export declare function ShimmerButton({ children, shimmerColor, speed, background, className, surface, radius, animated, iconWeight, ...props }: ShimmerButtonProps): import("react/jsx-runtime").JSX.Element;