import type { JsxElementProps } from '@ecopages/jsx';
export type RuiAvatarSize = 'sm' | 'md' | 'lg';
export type RuiAvatarProps = JsxElementProps<HTMLSpanElement> & {
    /** Image URL. When omitted or broken, initials from `alt` / `fallback` are shown. */
    src?: string;
    /** Accessible name for the image. Also used to derive initials when `fallback` is omitted. */
    alt?: string;
    /** Explicit fallback initials / text when there is no image. */
    fallback?: string;
    size?: RuiAvatarSize;
};
/**
 * Image avatar with initials fallback.
 *
 * @remarks When `src` is omitted or fails to load, initials derived from `alt`
 * (or the explicit `fallback`) are shown in a `role="img"` span. There is no
 * runtime image-error listener — pass `fallback` for reliable SSR of the
 * fallback state.
 *
 * @cssclass rui-avatar - Avatar root; `role="img"` when image-less.
 * @cssclass rui-avatar--sm - Small size.
 * @cssclass rui-avatar--md - Default size.
 * @cssclass rui-avatar--lg - Large size.
 * @cssclass rui-avatar__image - `<img>` fill.
 * @cssclass rui-avatar__fallback - Initials / text fallback.
 */
export declare function RuiAvatar({ src, alt, fallback, size, class: className, children, role, aria, ...props }: RuiAvatarProps): import("@ecopages/jsx").JsxRenderable;