import { FC } from 'react';
export type AvatarSize = 'sm' | 'md' | 'lg';
export interface AvatarProps {
    /**
     * User image URL. Rendered as an `<img>` over the initials. If the
     * image fails to load, the component hides the `<img>` and falls
     * back to the initials underneath — no broken-image indicator is
     * shown.
     */
    src?: string;
    /**
     * User's name. Used for the wrapper's accessible label and (when
     * `initials` is omitted) auto-derived initials — first letter of
     * the first and last word, lowercased; for a single-word name the
     * first two letters of that word.
     */
    name?: string;
    /**
     * Initials to display under the image. Defaults to the first letter
     * of the first and last word in `name` (or the first two letters
     * for a single-word name). Override when the auto-derivation isn't
     * quite right (e.g. "Leo van der Losen" → `ll` by default; pass
     * `'lv'` to keep "van" in there).
     */
    initials?: string;
    /**
     * Visual size — `sm` (30px), `md` (40px), `lg` (44px). Matches the
     * design reference's trigger / default / identity-header sizes.
     */
    size?: AvatarSize;
    /**
     * Override the wrapper's accessible label. Defaults to `name` when
     * provided. Use this when neither `name` nor visible content carries
     * a meaningful label.
     */
    ariaLabel?: string;
    className?: string;
    testId?: string;
}
/**
 * User avatar — circular badge with serif italic initials over a
 * primary-tinted radial gradient. Pass `src` to render a profile
 * image; on load failure the component falls back to the initials
 * underneath without showing a broken-image indicator.
 *
 * Pair with the `Menu.Trigger` (avatar pill in a navbar) and the
 * identity header inside a user-menu dropdown — three sizes cover the
 * common cases.
 *
 * @example
 * ```tsx
 * <Avatar name="Leo Losen" />                  // initials "ll"
 * <Avatar name="Ola" initials="o" size="sm" /> // override + small
 * <Avatar name="Ola" src="/avatar.jpg" size="lg" /> // image + lg
 * ```
 */
export declare const Avatar: FC<AvatarProps>;
//# sourceMappingURL=Avatar.d.ts.map