{
  "id": "avatar-group",
  "name": "AvatarGroup",
  "level": "molecule",
  "status": "stable",
  "purpose": "A few people at a glance, overlapping, with a count for the rest.",
  "description": "Overlapping cluster of avatars with a `+N` overflow chip. The first `max` entries render overlapped and ringed; the remainder collapse into a decorative `+N` chip (aria-hidden). The container is role=group — pass `label` to name it. Size mirrors the Avatar atom scale. Patterns consulted: Patterns/Information Architecture · MetadataAndActions, Patterns/Density & Growth · MetadataCompression.",
  "role": "content",
  "import": "@rrios-forge/ui/molecules/avatar-group",
  "exports": [
    "AvatarGroup",
    "avatarGroupItemVariants",
    "avatarGroupOverflowVariants",
    "AVATAR_GROUP_SIZES"
  ],
  "source": "packages/ui/src/molecules/avatar-group",
  "axes": [
    {
      "axis": "size",
      "part": null,
      "values": [
        "sm",
        "md",
        "lg",
        "xl"
      ],
      "default": "md",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    },
    {
      "axis": "lead",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "AvatarGroup leading avatar emphasis."
    }
  ],
  "needs": [],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-avatargroup--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-avatargroup--playground",
      "frame": "/iframe.html?id=components-molecules-avatargroup--playground&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-molecules-avatargroup--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-avatargroup--sizes",
      "frame": "/iframe.html?id=components-molecules-avatargroup--sizes&viewMode=story"
    },
    {
      "name": "Overflow chip",
      "id": "components-molecules-avatargroup--overflow",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-avatargroup--overflow",
      "frame": "/iframe.html?id=components-molecules-avatargroup--overflow&viewMode=story"
    },
    {
      "name": "No overflow",
      "id": "components-molecules-avatargroup--no-overflow",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-avatargroup--no-overflow",
      "frame": "/iframe.html?id=components-molecules-avatargroup--no-overflow&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/avatar-group.stories.tsx"
}