import type{PropertyValues}from'lit';import{type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraSize,LyraVariant}from'../../../internal/variants.js';import type{LyraAvatar,LyraAvatarShape}from'../avatar/avatar.class.js';export interface LyraAvatarGroupOverflowDetail{readonly hiddenCount:number;readonly hiddenAvatars:readonly LyraAvatar[];}export interface LyraAvatarGroupEventMap{'lr-overflow-click':CustomEvent<LyraAvatarGroupOverflowDetail>;}
/**
* `<lr-avatar-group>` — stacks a set of slotted `<lr-avatar>` children into a single
* overlapping row (negative-margin overlap, ring border so each circle reads as distinct) and,
* past a configurable `max` count, collapses the excess into a "+N" overflow badge. First-party
* invention (no Web Awesome equivalent), composed over `<lr-avatar>` rather than reimplementing
* it — plain light-DOM slotted content is the group's items, the same shape `<lr-multi-split>`'s
* panels / `<lr-source-list>`'s cards / `<lr-chip-group>`'s chips already use, not a
* `.items` array prop.
*
* `size`/`shape`/`variant` provide defaults to assigned avatars that omit the corresponding
* attribute. Explicit child attributes always win; group-owned defaults are removed on disconnect
* or removal without overwriting later author writes.
*
* **Deliberate divergence from `<lr-chip-group>`'s overflow pattern.** Chip-group's overflow
* indicator is a disclosure toggle that reveals the excess children in place (`aria-expanded`,
* a "Show less" relabel). This component's overflow badge does not do that — unstacking N more
* circles back into the row would defeat the entire point of a compact identity stack. Instead,
* `lr-overflow-click` is a pure notification hook: the component keeps rendering the same
* collapsed stack + badge regardless of whether anyone listens, and a consumer typically wires
* the event to open their own popover/dialog/tooltip listing the hidden members (out of scope for
* this component — no popover dependency is introduced here). There is no `expanded` state, no
* `aria-expanded`, and the badge never changes its own text/label on click.
*
* **No roving-tabindex / arrow-key composite-widget behavior applies here, and this is
* intentional, not an oversight.** Avatars are non-interactive per `<lr-avatar>`'s own
* established contract (purely presentational, no built-in interactivity), so this is not a
* listbox/toolbar/grid needing `ArrowLeft`/`ArrowRight` roving focus — the overflow badge is the
* only interactive element, and as a native `<button>` it's automatically part of the normal Tab
* sequence with no custom keyboard handling required.
*
* @customElement lr-avatar-group
* @slot - Direct or forwarded `<lr-avatar>` elements. Other assigned elements are ignored and
* remain untouched.
* @event lr-overflow-click - The overflow badge was activated (click, or Enter/Space while
* focused — native `<button>` behavior). `detail: { hiddenCount, hiddenAvatars }` where
* `hiddenAvatars` is a fresh readonly snapshot of eligible avatars hidden past `max`.
* Non-cancelable — informational hook, no default action to veto.
* @csspart base - The outer inline-flex container (holds the slot and the overflow badge).
* @csspart overflow-badge - The "+N" button. Only rendered while `max` is actively causing an
* overflow.
* @csspart overflow-badge-visual - The avatar-sized painted disc inside the 40px action surface.
* @cssprop [--lr-avatar-group-avatar-size=var(--lr-size-3rem)] - Sizes the overflow badge to
* match the slotted avatars, tier for tier with `<lr-avatar>`'s own `--lr-avatar-size`.
* @cssprop [--lr-avatar-group-overlap=var(--lr-size-neg-6px)] - Horizontal overlap between
* consecutive avatars (a logical `margin-inline-start`, so it auto-mirrors under `dir="rtl"`).
* Setting this to `0` or a positive length is a supported escape hatch that turns the stack into
* normal, non-overlapping spacing.
* @cssprop [--lr-avatar-group-ring-color=var(--lr-color-surface)] - The cutout-style ring
* drawn around every avatar and the overflow badge.
* @cssprop [--lr-avatar-group-ring-width=var(--lr-border-width-medium)] - Ring thickness.
* @cssprop [--lr-avatar-group-badge-bg=var(--lr-color-border)] - Overflow badge background.
* Its private default follows `variant`; the public value remains authoritative.
* @cssprop [--lr-avatar-group-badge-color=var(--lr-color-text)] - Overflow badge text color.
* Its private default follows `variant`; the public value remains authoritative.
* @cssprop [--lr-avatar-group-badge-font-size=var(--lr-font-size-m)] - Font size of the "+N"
* badge label. `size` steps its private default across the same six-step ladder as `<lr-avatar>`'s
* own `--lr-avatar-font-size`, so the badge and the avatars it caps read at the same optical weight.
* @status stable
* @since 4.0.0
*/
export declare class LyraAvatarGroup extends LyraElement<LyraAvatarGroupEventMap>{protected static readonly immutableEventDetails:readonly string[];protected static readonly identityEventDetailProperties:Readonly<{'lr-overflow-click':readonly string[];}>;static styles:import("lit").CSSResultGroup[];private _max?;
/** Maximum number of assigned children shown before the rest collapse behind a "+N" badge.
*  Flattened slot-forwarded children count the same as direct light-DOM children. Unset (the
*  default) means no limit — every child is always shown. Any explicitly assigned value is
*  sanitized to a finite, non-negative integer via `finiteCount` — this feeds the
*  `hasOverflow`/`syncChildVisibility`/`onOverflowClick` index math below directly, so a
*  NaN/negative value must never reach it. */
get max():number|undefined;set max(next:number|undefined|null);
/** Shared size default for the badge and avatars that omit their own `size`. */
size:LyraSize;
/** `'circle'` (the default), `'rounded'`, or `'square'`. Also provides the default to assigned
* avatars that omit their own `shape`. */
shape:LyraAvatarShape;
/** Recolors the overflow badge and defaults avatars that omit their own `variant`.
* `'neutral'` (the default) reads as a plain, unaccented badge. */
variant:LyraVariant;
/** The group's own accessible name (`role="group"`'s `aria-label`). A host-level `aria-label`
*  wins if both are set. Unset (the default) renders no `aria-label` at all — a screen reader
*  announces "group" with no name, then reads each avatar's own accessible name in turn. */
label:string;private eligibleAvatarCount;private overflowHiddenAvatars;private avatarsSlot?;private assignedAvatars;private observedAvatars;private avatarObserver?;private avatarObserverWindow?;private readonly defaultOwnership;private readonly pendingOwnedAttributeWrites;protected willUpdate(changed:PropertyValues<this>):void;protected firstUpdated(changed:PropertyValues):void;connectedCallback():void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;adoptedCallback():void;private get hasOverflow();private get hiddenCount();private isAvatar;private sameAvatars;private reconcileAvatars;private recomputeWindow;private connectAvatarObserver;private disconnectAvatarObserver;private markOwnedAttributeWrite;private consumeOwnedAttributeWrite;private applyGroupDefaults;private applyVisibilityMarkers;private restoreAvatarState;private restoreOwnedState;private onSlotChange;
/**
* Reads the default slot's currently assigned children (flattened through any forwarding
* `<slot>`) and reconciles the avatar list -- wired as the `slotchange` handler (via
* `onSlotChange`) for every later mutation, and called once more from `firstUpdated()` (see
* `collectInitialSlotAssignment`) to cover a slot-forwarding host, or an environment, where the
* default slot's initial assignment never fires `slotchange`. `reconcileAvatars()` is already
* idempotent over an unchanged assigned-element set (it diffs by identity and guards every
* `@state` write with an equality check), so a real browser firing both this and the following
* genuine `slotchange` contributes no duplicate side effect.
*/
private onSlotChangeFromSlot;private onOverflowClick;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-avatar-group':LyraAvatarGroup;}}