import { type VariantProps } from 'class-variance-authority';
import * as React from 'react';
declare const featuredIconVariants: (props?: ({
    size?: "xs" | "sm" | "md" | "lg" | null | undefined;
    shape?: "round" | "rounded" | null | undefined;
    intent?: "info" | "success" | "warning" | "default" | "error" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
export interface FeaturedIconProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof featuredIconVariants> {
    /** Icon element (preferred) */
    icon?: React.ReactNode;
    /** Fallback for icon */
    children?: React.ReactNode;
    /** Accessible label — when provided, sets role="img" instead of aria-hidden */
    'aria-label'?: string;
}
/**
 * FeaturedIcon displays an icon within a styled container with customizable size, shape, and color.
 * Useful for highlighting actions, statuses, or categories in cards, lists, and navigation.
 *
 * @llms Styled icon container with size (xs-lg), shape (rounded/round), and color variants
 * @example
 * ```tsx
 * <FeaturedIcon icon={<Settings />} size="md" shape="rounded" />
 * ```
 */
export declare const FeaturedIcon: React.ForwardRefExoticComponent<FeaturedIconProps & React.RefAttributes<HTMLDivElement>>;
export { featuredIconVariants };
