# XWUIChatGroup

A group / channel info card showing a group's identity (icon, `name`, `topic`), a stacked-avatar preview of its `members` capped by `maxAvatars` with a "+N" overflow chip, an optional inline member list with role badges, and quick-action buttons (`showActions`: Open / Mute / Settings / Leave). The roster can be toggled open via a Show/Hide-members button or pre-opened with `expandedByDefault`, `private` and `muted` flags add lock/mute glyphs, and `onOpen()` / `onMute()` / `onSettings()` / `onLeave()` / `onMemberClick()` expose the interactions; the group is supplied as `data.group` and replaced via `setGroup()`.

## Basic Usage

A "Design Team" group with `memberCount` 23 and seven members, capped at five stacked avatars so a "+18" overflow chip appears alongside the action row.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Compact group card with a five-avatar stack, overflow chip, and actions.
```

## Private Expanded

A `private`, invite-only leadership group opened with `expandedByDefault` so the full member roster is visible inline with admin/moderator/member role badges, and onOpen/onLeave/onSettings/onMemberClick are logged.

```example
file: examples/PrivateExpanded.ts
html: examples/PrivateExpanded.html
title: Private Expanded
description: Private group rendered expanded, showing the full roster with role badges.
```

## Muted Community

A large public community with an icon image and the muted flag set, capped at three avatars for a big overflow chip, with the Mute action wired to onMute.

```example
file: examples/MutedCommunity.ts
html: examples/MutedCommunity.html
title: Muted Community
description: A 1.2k-member community card with an icon, muted glyph, "+N" overflow chip, and an onMute toggle.
```

## Info Only No Actions

A compact project group rendered with showActions off, presenting just the identity, topic, and roster as an embeddable summary.

```example
file: examples/InfoOnlyNoActions.ts
html: examples/InfoOnlyNoActions.html
title: Info Only No Actions
description: A small group card with the action row hidden - identity, topic, and three avatars only.
```

```api
```