import { SVGAttributes } from "react";
import { SizeToken } from "../../utilities/tokens/index.js";
import { AllowedIcons } from "./icons.js";
import { VariantNames } from "./variantNames.js";
export interface IconProps<TIcon extends AllowedIcons> extends Omit<SVGAttributes<SVGElement>, "width" | "height"> {
    /**
     * The icon type
     */
    icon: TIcon;
    /**
     * Accessible title. Will be read by screen readers and shown as a tooltip. Only use this for icons
     * that convey meaning in the user interface and don't have adjacent descriptive text.
     *
     * If you absolutely don't want a tooltip for sighted users, but want something read by screen readers,
     * use `aria-label` instead.
     *
     * If neither `title` nor `aria-label` is supplied, the icon will be considered decorative and
     * hidden from screen readers unless you explicitly set `aria-hidden={false}` (not recommended!)
     */
    title?: string;
    /**
     * Icon size, including whitespace. The icon's largest dimension and defined whitespace will scale to fit this size.
     * @default l
     */
    size?: SizeToken | "1em";
    /** Override the default icon variant for this icon. To change the default icon variant, use IconVariantProvider */
    variantOverride?: VariantNames;
}
/**
TODO: Usage documentation
 */
export declare const Icon: import("@gnist/component-utils").VanillaComponent<import("react").ElementType, import("react").FC<IconProps<AllowedIcons>>>;
//# sourceMappingURL=Icon.d.ts.map