import { HTMLAttributes } from 'react';
export type AvatarSize = "sm" | "md" | "lg" | "xl";
/**
 * Named color palette for the initials fallback.
 * Mirrors libadwaita's avatar color set.
 */
export type AvatarColor = "blue" | "green" | "yellow" | "orange" | "red" | "purple" | "brown" | "teal" | "slate";
export interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
    /**
     * Full name used to generate initials and — when `color` is omitted —
     * to deterministically pick a background color.
     */
    name?: string;
    /** Image URL. When provided the initials fallback is hidden. */
    src?: string;
    /** Alt text for the image. Defaults to `name`. */
    alt?: string;
    /** Size of the avatar. Defaults to `"md"`. */
    size?: AvatarSize;
    /**
     * Override the auto-derived background color for the initials fallback.
     * When omitted a color is derived from `name` via a stable hash.
     */
    color?: AvatarColor;
}
/**
 * Circular avatar with image or initials fallback.
 *
 * Follows the Adwaita `AdwAvatar` pattern — deterministic color from name,
 * up to two initials when no image is supplied.
 *
 * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.Avatar.html
 */
export declare function Avatar({ name, src, alt, size, color, className, ...props }: AvatarProps): import("react/jsx-runtime").JSX.Element;
