import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraSize,LyraVariant}from'../../../internal/variants.js';export type LyraAvatarShape='circle'|'rounded'|'square';export type LyraAvatarLoading='eager'|'lazy';export interface LyraAvatarErrorDetail{image:string;}export interface LyraAvatarEventMap{'lr-error':CustomEvent<LyraAvatarErrorDetail>;}
/**
* `<lr-avatar>` — a small, fixed-size identity marker: an image, an `icon`-slotted fallback
* glyph, or an initials fallback, in that priority order. Mirrors `wa-avatar`'s public surface
* (`image`/`initials`/`loading`/`shape`, the `icon` slot, the image-load error event) and adds
* this library's own `size`/`variant` vocabulary. Purely presentational, no built-in interactivity;
* a consumer wraps it in their own `<button>`/`<lr-menu>` trigger for a user-menu affordance.
*
* @customElement lr-avatar
* @event lr-error - The image failed to load. `detail: { image }` carries the URL that failed, so
*   a consumer can retry or report it; the avatar itself has already fallen back to the `icon`
*   slot or the initials by the time this fires. Never fires when no `image` is set.
* @slot icon - A fallback glyph shown only when there is no loadable `image` — the same role
*   `wa-avatar`'s `icon` slot fills, i.e. a stand-in for the
*   `initials` text rather than an override of the photo. Also decorative (`aria-hidden`), so set
*   `label` alongside it.
* @csspart base - The outer circle/rounded/square container.
* @csspart icon - Wrapper around the named icon fallback while it has assigned content and no
*   image is currently usable.
* @csspart image - The `<img>`, only rendered while `image` is set and has not failed to load (and
*   is safe for a media source).
* @csspart initials - The initials text, only rendered once the image and icon fallbacks ahead of it
*   in the priority order have been ruled out.
* @cssprop [--size=var(--lr-avatar-size)] - Upstream-compatible avatar diameter.
* @cssprop [--lr-avatar-size=var(--lr-size-3rem)] - Inline and block size of the container. `size`
*   steps its private default across the shared six-step ladder, from `var(--lr-size-1-5rem)`
*   (`2xs`) to `var(--lr-size-5rem)` (`xl`); an inherited or direct public value still wins.
* @cssprop [--lr-avatar-bg=var(--lr-color-border)] - Container background. Each non-neutral
*   `variant` changes its private default to that variant's `-quiet` tint.
* @cssprop [--lr-avatar-color=var(--lr-color-text)] - Initials/glyph color. Each non-neutral
*   `variant` changes its private default to that variant's loud color.
* @cssprop [--lr-avatar-font-size=var(--lr-font-size-m)] - Font size of the initials fallback (and
*   of any `em`-sized slotted glyph). `size` steps its private default alongside the diameter, so
*   the initials track the circle instead of staying at one fixed size across every tier.
* @status stable
* @since 4.0.0
*/
export declare class LyraAvatar extends LyraElement<LyraAvatarEventMap>{static styles:import("lit").CSSResultGroup[];
/** Fallback text (typically 1-2 characters) shown when no glyph and no image is set, or the
*  image fails to load and no `icon` slot content is provided. */
initials:string;
/** Image URL. Takes priority over the `icon` slot and `initials` when set and loads successfully
*  and falls back to them on a load error. Named
*  `image` to match `wa-avatar`; it used to be `src`, which a mechanical rename left unset —
*  silently falling back to initials. */
image:string;
/** Accessible description matching the upstream avatar contract. A host `aria-label` wins.
* Attribute removal is consumed as an absent label without changing its null readback. */
label:string;
/** Native `<img loading>` passthrough. `'lazy'` defers the request until the avatar approaches
*  the viewport — worth setting for avatars far down a long list, never for one above the fold. */
loading:LyraAvatarLoading;
/** Visual size, on the shared six-step ladder. `'large'`/`'l'` matches `--lr-icon-button-size`
*  (4rem); `'medium'`/`'m'` (the default) is the mirrored 3rem diameter. */
size:LyraSize;
/** `'circle'` (the default), `'rounded'` (the shared medium corner radius), or `'square'` (no
*  corner radius at all). */
shape:LyraAvatarShape;
/** Recolors the initials-fallback background/text, on the library's shared `variant` vocabulary.
*  `'neutral'` (the default) reads as a plain, unaccented circle. */
variant:LyraVariant;private failedSrc?;private hasIconSlot;
/** Each connection establishes state before later image writes become observable failures. */
private connectionEventBaselinePending;
/**
* A glyph is presentation owned by the avatar, never an independent focus target. Browsers
* normally refuse focus for an unassigned light-DOM child, but WebKit can still honor an
* imperative `focus()` call on one. Restore the previous external focus target in that case;
* the same boundary also protects an accidentally interactive node assigned to `icon` without
* mutating the consumer's node or its authored `inert` state.
*/
private onDecorativeGlyphFocusIn;constructor();private safeImage;private hasIconSlotContent;protected willUpdate(changed:PropertyValues<this>):void;private onImageError;private onNamedIconSlotChange;connectedCallback():void;protected updated(changed:PropertyValues<this>):void;disconnectedCallback():void;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-avatar':LyraAvatar;}}