{
  "id": "avatar",
  "name": "Avatar",
  "level": "atom",
  "status": "stable",
  "purpose": "A person or entity at a glance — a photo, or initials when there is none.",
  "description": "Image-with-fallback identity primitive. Composes `@radix-ui/react-avatar` so the fallback shows while the image loads (and stays if the image errors). `alt` is required; pass `alt=\"\"` only when the avatar is decorative and the surrounding text already names the entity.",
  "role": "content",
  "import": "@rrios-forge/ui/atoms/avatar",
  "exports": [
    "Avatar",
    "avatarKindFromShape",
    "avatarVariants",
    "AVATAR_KINDS",
    "AVATAR_SHAPES",
    "AVATAR_SIZES"
  ],
  "source": "packages/ui/src/atoms/avatar",
  "axes": [
    {
      "axis": "size",
      "part": null,
      "values": [
        "sm",
        "md",
        "lg",
        "xl"
      ],
      "default": "md",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    },
    {
      "axis": "kind",
      "part": null,
      "values": [
        "person",
        "entity"
      ],
      "default": null,
      "meaning": "What an avatar stands for — a person (round) or an entity such as a workspace or brand (rounded square) (ADR-039)."
    },
    {
      "axis": "shape",
      "part": null,
      "values": [
        "circle",
        "rounded"
      ],
      "default": null,
      "meaning": "Geometry, where geometry is the meaning."
    }
  ],
  "needs": [
    {
      "need": "Avatar / badge / separator / icon",
      "answer": "`Avatar` / `Badge` / `Separator` / `Icon`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-013",
      "title": "PageShell: mobile-nav polymorphism"
    },
    {
      "id": "ADR-014",
      "title": "PageShell: Apple Mail / macOS Big Sur visual register"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-atoms-avatar--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-avatar--playground",
      "frame": "/iframe.html?id=components-atoms-avatar--playground&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-atoms-avatar--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-avatar--sizes",
      "frame": "/iframe.html?id=components-atoms-avatar--sizes&viewMode=story"
    },
    {
      "name": "Kinds",
      "id": "components-atoms-avatar--kinds",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-avatar--kinds",
      "frame": "/iframe.html?id=components-atoms-avatar--kinds&viewMode=story"
    },
    {
      "name": "With image",
      "id": "components-atoms-avatar--with-image",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-avatar--with-image",
      "frame": "/iframe.html?id=components-atoms-avatar--with-image&viewMode=story"
    },
    {
      "name": "Fallback",
      "id": "components-atoms-avatar--fallback",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-avatar--fallback",
      "frame": "/iframe.html?id=components-atoms-avatar--fallback&viewMode=story"
    },
    {
      "name": "Group",
      "id": "components-atoms-avatar--group",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-avatar--group",
      "frame": "/iframe.html?id=components-atoms-avatar--group&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/atoms/avatar.stories.tsx"
}