{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "avatar",
  "title": "Avatar",
  "description": "Six sizes and four shapes including squircle, status dots with pulse, solid, gradient and rotating story rings, image fade-in with name-based gradient initials, and groups that cap with +N and fan out on hover.",
  "dependencies": [
    "lucide-react"
  ],
  "registryDependencies": [
    "https://goodui.dev/r/goodui-motion.json",
    "https://goodui.dev/r/locale.json"
  ],
  "files": [
    {
      "path": "registry/components/core/avatar.tsx",
      "content": "\"use client\"\r\n\r\nimport * as React from \"react\"\r\nimport { User } from \"lucide-react\"\r\nimport { cn } from \"@/lib/utils\"\r\nimport { useLabels } from \"@/lib/goodui-locale\"\r\nimport { GooduiTokens } from \"@/lib/goodui-motion\"\r\n\r\n/*\r\n * One avatar, independent layers: every axis combines with every other.\r\n *   size      xs–2xl                     shape     circle / rounded / square / squircle\r\n *   status    online / away / busy / offline dot (optional pulse)\r\n *   ring      none / solid (tone) / gradient / story, with a gap that follows the shape\r\n *   animation none / spin (rotating ring) / pulse / pop-in        shadow\r\n * Without an image (or when it fails) it shows initials on a gradient derived from the name, so the same\r\n * person always gets the same colors. AvatarGroup overlaps, caps with \"+N\" and spreads on hover.\r\n */\r\n\r\nexport type AvatarSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\"\r\nexport type AvatarShape = \"circle\" | \"rounded\" | \"square\" | \"squircle\"\r\nexport type AvatarStatus = \"none\" | \"online\" | \"away\" | \"busy\" | \"offline\"\r\nexport type AvatarRing = \"none\" | \"solid\" | \"gradient\" | \"story\"\r\nexport type AvatarTone = \"primary\" | \"neutral\" | \"success\" | \"warning\" | \"danger\" | \"info\"\r\nexport type AvatarAnimation = \"none\" | \"spin\" | \"pulse\" | \"pop-in\"\r\nexport type AvatarShadow = \"none\" | \"sm\" | \"md\" | \"lg\"\r\n\r\nexport type AvatarLabels = { online: string; away: string; busy: string; offline: string }\r\nconst DEFAULT_LABELS: AvatarLabels = { online: \"online\", away: \"away\", busy: \"busy\", offline: \"offline\" }\r\n\r\nexport type AvatarGroupLabels = { showMore: (count: number) => string; more: (count: number) => string }\r\nconst DEFAULT_GROUP_LABELS: AvatarGroupLabels = { showMore: (count) => `Show ${count} more`, more: (count) => `${count} more` }\r\n\r\nexport type AvatarProps = Omit<React.ComponentProps<\"span\">, \"children\"> & {\r\n  /** Image URL. While it loads, or if it fails, the initials or fallback show. */\r\n  src?: string\r\n  /** Accessible name; defaults to name. */\r\n  alt?: string\r\n  /** Used for the initials, the fallback gradient and the default alt text. */\r\n  name?: string\r\n  /** 24, 32, 40, 48, 64 or 80px. Inherits from AvatarGroup, else md. */\r\n  size?: AvatarSize\r\n  /** Inherits from AvatarGroup, else circle. */\r\n  shape?: AvatarShape\r\n  /** Presence dot in the bottom corner, with screen-reader text. */\r\n  status?: AvatarStatus\r\n  /** Pings the status dot. */\r\n  statusPulse?: boolean\r\n  /** Ring around the avatar with a gap: solid (tone color), gradient (tone based) or story (Instagram-style). */\r\n  ring?: AvatarRing\r\n  /** Color of the solid ring and the status-free accents. */\r\n  tone?: AvatarTone\r\n  /** spin rotates a gradient or story ring; pulse breathes the ring; pop-in plays on mount. */\r\n  animation?: AvatarAnimation\r\n  /** Drop shadow that follows the shape. */\r\n  shadow?: AvatarShadow\r\n  /** Content shown when there is no image and no name. */\r\n  fallback?: React.ReactNode\r\n  /** Text for built-in controls and screen readers; pass translations here. */\r\n  labels?: Partial<AvatarLabels>\r\n}\r\n\r\nconst PX: Record<AvatarSize, number> = { xs: 24, sm: 32, md: 40, lg: 48, xl: 64, \"2xl\": 80 }\r\n\r\nconst SQUIRCLE = `url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'%3E%3Cpath d='M50 0C12 0 0 12 0 50s12 50 50 50 50-12 50-50S88 0 50 0Z'/%3E%3C/svg%3E\") center/100% 100% no-repeat`\r\n\r\nconst CSS = `\r\n.pc-avatar{--pc-c:var(--primary);--pc-fg:var(--primary-foreground);--pc-rw:max(1.5px,calc(var(--pc-av-s) * .045));--pc-rg:max(1.5px,calc(var(--pc-av-s) * .04))}\r\n.pc-avatar[data-tone=neutral]{--pc-c:var(--foreground);--pc-fg:var(--background)}\r\n.pc-avatar[data-tone=success]{--pc-c:oklch(0.53 0.13 155);--pc-fg:#fff}\r\n.pc-avatar[data-tone=warning]{--pc-c:oklch(0.75 0.16 70);--pc-fg:oklch(0.25 0.05 70)}\r\n.pc-avatar[data-tone=danger]{--pc-c:oklch(0.56 0.21 27);--pc-fg:#fff}\r\n.pc-avatar[data-tone=info]{--pc-c:oklch(0.55 0.17 250);--pc-fg:#fff}\r\n.dark .pc-avatar[data-tone=success]{--pc-c:oklch(0.7 0.16 155);--pc-fg:oklch(0.2 0.05 155)}\r\n.dark .pc-avatar[data-tone=danger]{--pc-c:oklch(0.68 0.2 25);--pc-fg:oklch(0.2 0.05 25)}\r\n.dark .pc-avatar[data-tone=info]{--pc-c:oklch(0.7 0.15 245);--pc-fg:oklch(0.2 0.05 245)}\r\n.pc-avatar{--pc-tint:color-mix(in oklab,var(--pc-c) 14%,transparent);--pc-ink:color-mix(in oklab,var(--pc-c) 82%,var(--foreground))}\r\n.pc-avatar[data-tone=warning]{--pc-ink:color-mix(in oklab,var(--pc-c) 62%,var(--foreground))}\r\n\r\n.pc-avatar-face,.pc-avatar-ring,.pc-avatar-gap{border-radius:9999px}\r\n.pc-avatar[data-shape=rounded] :is(.pc-avatar-face,.pc-avatar-ring,.pc-avatar-gap){border-radius:24%}\r\n.pc-avatar[data-shape=square] :is(.pc-avatar-face,.pc-avatar-ring,.pc-avatar-gap){border-radius:9%}\r\n.pc-avatar[data-shape=squircle] :is(.pc-avatar-face,.pc-avatar-ring,.pc-avatar-gap){border-radius:0;-webkit-mask:${SQUIRCLE};mask:${SQUIRCLE}}\r\n\r\n.pc-avatar-face{position:relative;display:flex;align-items:center;justify-content:center;width:100%;height:100%;overflow:hidden;background:var(--muted);color:var(--muted-foreground);font-weight:600;font-size:calc(var(--pc-av-s) * .38);line-height:1;letter-spacing:-.01em;user-select:none}\r\n.pc-avatar-face[data-initials]{color:#fff;text-shadow:0 1px 1px rgb(0 0 0/.12)}\r\n.pc-avatar-face svg{width:55%;height:55%}\r\n.pc-avatar-img{position:absolute;inset:0;width:100%;height:100%;object-fit:cover;opacity:0;transition:opacity .35s ease}\r\n.pc-avatar-img[data-loaded]{opacity:1}\r\n\r\n.pc-avatar-ring{position:absolute;inset:calc(-1 * (var(--pc-rw) + var(--pc-rg)));background:var(--pc-c)}\r\n.pc-avatar-gap{position:absolute;inset:calc(-1 * var(--pc-rg));background:var(--pc-av-gap,var(--background))}\r\n.pc-avatar[data-ring=gradient] .pc-avatar-ring{background:conic-gradient(from var(--pc-avatar-a,0deg),var(--pc-c),color-mix(in oklab,var(--pc-c) 40%,#d946ef),color-mix(in oklab,var(--pc-c) 30%,#f59e0b),var(--pc-c))}\r\n.pc-avatar[data-ring=story] .pc-avatar-ring{background:conic-gradient(from var(--pc-avatar-a,0deg),#f59e0b,#ef4444,#d946ef,#8b5cf6,#f59e0b)}\r\n@property --pc-avatar-a{syntax:\"<angle>\";inherits:false;initial-value:0deg}\r\n.pc-avatar[data-anim=spin] .pc-avatar-ring{animation:pc-avatar-spin 3s linear infinite}\r\n@keyframes pc-avatar-spin{to{--pc-avatar-a:360deg}}\r\n/* A round ring looks the same whether its gradient turns or the ring itself does, and turning the ring costs the page nothing per frame. */\r\n.pc-avatar[data-shape=circle][data-anim=spin] .pc-avatar-ring{animation-name:pc-avatar-turn}\r\n@keyframes pc-avatar-turn{to{transform:rotate(360deg)}}\r\n.pc-avatar[data-anim=pulse] .pc-avatar-ring{animation:pc-avatar-breathe 2s ease-in-out infinite}\r\n.pc-avatar[data-anim=pulse][data-ring=none]::before{content:\"\";position:absolute;inset:0;border-radius:9999px;animation:pc-avatar-halo 2s var(--pc-ease-out) infinite;pointer-events:none}\r\n.pc-avatar[data-anim=pulse][data-ring=none][data-shape=rounded]::before{border-radius:24%}\r\n.pc-avatar[data-anim=pulse][data-ring=none][data-shape=square]::before{border-radius:9%}\r\n.pc-avatar[data-anim=pulse][data-ring=none][data-shape=squircle]::before{border-radius:32%}\r\n@keyframes pc-avatar-breathe{50%{transform:scale(1.07);opacity:.75}}\r\n@keyframes pc-avatar-halo{0%{box-shadow:0 0 0 0 color-mix(in oklab,var(--pc-c) 50%,transparent)}100%{box-shadow:0 0 0 calc(var(--pc-av-s) * .22) transparent}}\r\n.pc-avatar[data-anim=pop-in]{animation:pc-avatar-in .5s var(--pc-ease-spring) both}\r\n@keyframes pc-avatar-in{0%{transform:scale(.4);opacity:0}100%{transform:scale(1);opacity:1}}\r\n\r\n.pc-avatar[data-shadow=sm]{filter:drop-shadow(0 1px 2px rgb(0 0 0/.18))}\r\n.pc-avatar[data-shadow=md]{filter:drop-shadow(0 4px 8px rgb(0 0 0/.2))}\r\n.pc-avatar[data-shadow=lg]{filter:drop-shadow(0 10px 18px rgb(0 0 0/.28))}\r\n\r\n.pc-avatar-status{position:absolute;inset-inline-end:0;bottom:0;z-index:2;width:max(8px,calc(var(--pc-av-s) * .27));height:max(8px,calc(var(--pc-av-s) * .27));border-radius:9999px;background:var(--pc-st);box-shadow:0 0 0 max(1.5px,calc(var(--pc-av-s) * .05)) var(--pc-av-gap,var(--background))}\r\n.pc-avatar:not([data-shape=circle]) .pc-avatar-status{transform:translate(28%,28%)}\r\n.pc-avatar:not([data-shape=circle]) .pc-avatar-status:dir(rtl){transform:translate(-28%,28%)}\r\n.pc-avatar-status[data-status=online]{--pc-st:oklch(0.68 0.17 152)}\r\n.pc-avatar-status[data-status=away]{--pc-st:oklch(0.78 0.16 75)}\r\n.pc-avatar-status[data-status=busy]{--pc-st:oklch(0.62 0.22 25)}\r\n.pc-avatar-status[data-status=offline]{--pc-st:oklch(0.7 0 0)}\r\n.pc-avatar-status[data-pulse]::after{content:\"\";position:absolute;inset:0;border-radius:inherit;background:var(--pc-st);animation:pc-avatar-ping 1.6s var(--pc-ease-out) infinite}\r\n@keyframes pc-avatar-ping{75%,100%{transform:scale(2.4);opacity:0}}\r\n\r\n.pc-avatar-group{display:inline-flex;align-items:center;isolation:isolate;--pc-dir:1}\r\n.pc-avatar-group:dir(rtl){--pc-dir:-1}\r\n.pc-avatar-item{position:relative;display:inline-flex;transition:transform .3s var(--pc-ease-out)}\r\n.pc-avatar-item .pc-avatar{--pc-rg:max(2px,calc(var(--pc-av-s) * .06))}\r\n.pc-avatar-item+.pc-avatar-item{margin-inline-start:calc(var(--pc-av-s) * var(--pc-ov) * -1)}\r\n.pc-avatar-group[data-spread]:hover .pc-avatar-item{transform:translateX(calc(var(--i) * var(--pc-av-s) * var(--pc-ov) * .85 * var(--pc-dir)))}\r\n.pc-avatar-group[data-spread] .pc-avatar-item:hover{z-index:50;transform:translateX(calc(var(--i) * var(--pc-av-s) * var(--pc-ov) * .85 * var(--pc-dir))) translateY(-3px)}\r\n.pc-avatar-group[data-tooltips] .pc-avatar-item[data-name]::after{content:attr(data-name);position:absolute;left:50%;bottom:calc(100% + 8px);padding:3px 8px;border-radius:6px;font-size:12px;font-weight:500;white-space:nowrap;background:var(--foreground);color:var(--background);opacity:0;transform:translate(-50%,4px) scale(.96);transition:opacity .15s,transform .15s;pointer-events:none}\r\n.pc-avatar-group[data-tooltips] .pc-avatar-item[data-name]:hover{z-index:50}\r\n.pc-avatar-group[data-tooltips] .pc-avatar-item[data-name]:hover::after{opacity:1;transform:translate(-50%,0) scale(1)}\r\n.pc-avatar-more{display:inline-flex;align-items:center;justify-content:center;width:var(--pc-av-s);height:var(--pc-av-s);flex:none;background:var(--muted);color:var(--foreground);font-size:calc(var(--pc-av-s) * .34);font-weight:600;box-shadow:0 0 0 var(--pc-rg) var(--pc-av-gap,var(--background))}\r\nbutton.pc-avatar-more{cursor:pointer}\r\nbutton.pc-avatar-more:hover{background:color-mix(in oklab,var(--muted) 80%,var(--foreground))}\r\n@media (prefers-reduced-motion:reduce){\r\n  .pc-avatar,.pc-avatar *,.pc-avatar-item{animation:none!important;transition:none!important}\r\n  .pc-avatar::before,.pc-avatar-status::after{display:none}\r\n  .pc-avatar-group[data-spread] .pc-avatar-item{transform:none!important}\r\n}\r\n`\r\n\r\n/** Deterministic hash, so a name always maps to the same gradient (SSR-safe). */\r\nfunction hue(name: string) {\r\n  let h = 0\r\n  for (let i = 0; i < name.length; i++) h = (h * 31 + name.charCodeAt(i)) >>> 0\r\n  return h % 360\r\n}\r\n\r\n/** \"Maya Chen\" → \"MC\", \"Maya Lin Chen\" → \"MC\" (first + last word), \"Maya\" → \"M\". Emoji-safe. */\r\nexport function initials(name: string) {\r\n  const parts = name.trim().split(/\\s+/).filter(Boolean)\r\n  if (!parts.length) return \"\"\r\n  const first = Array.from(parts[0] ?? \"\")[0] ?? \"\"\r\n  const last = parts.length > 1 ? (Array.from(parts[parts.length - 1] ?? \"\")[0] ?? \"\") : \"\"\r\n  return (first + last).toUpperCase()\r\n}\r\n\r\nexport function avatarGradient(name: string) {\r\n  const h = hue(name)\r\n  // Dark enough for the white initials to reach 4.5:1 across the middle of the tile on every hue.\r\n  return `linear-gradient(135deg, oklch(0.56 0.14 ${h}), oklch(0.44 0.17 ${(h + 45) % 360}))`\r\n}\r\n\r\ntype GroupCtx = { size?: AvatarSize; shape?: AvatarShape; inGroup: boolean }\r\nconst AvatarGroupContext = React.createContext<GroupCtx>({ inGroup: false })\r\n\r\nexport function Avatar({\r\n  src,\r\n  alt,\r\n  name,\r\n  size,\r\n  shape,\r\n  status = \"none\",\r\n  statusPulse,\r\n  ring = \"none\",\r\n  tone = \"primary\",\r\n  animation = \"none\",\r\n  shadow = \"none\",\r\n  fallback,\r\n  labels,\r\n  className,\r\n  style,\r\n  ...props\r\n}: AvatarProps) {\r\n  const l = useLabels(\"avatar\", DEFAULT_LABELS, labels)\r\n  const group = React.useContext(AvatarGroupContext)\r\n  const s = size ?? group.size ?? \"md\"\r\n  const sh = shape ?? group.shape ?? \"circle\"\r\n  const [loaded, setLoaded] = React.useState(false)\r\n  const [failed, setFailed] = React.useState(false)\r\n  const imgRef = React.useRef<HTMLImageElement>(null)\r\n\r\n  React.useEffect(() => {\r\n    setFailed(false)\r\n    setLoaded(false)\r\n    const img = imgRef.current\r\n    // Already in cache before hydration: onLoad will not fire again.\r\n    if (img?.complete && img.naturalWidth > 0) setLoaded(true)\r\n  }, [src])\r\n\r\n  const showImg = !!src && !failed\r\n  const text = name ? initials(name) : \"\"\r\n  const label = alt ?? name\r\n\r\n  return (\r\n    <>\r\n      <style href=\"pc-avatar\" precedence=\"default\">\r\n        {CSS}\r\n      </style>\r\n      <span\r\n        data-slot=\"avatar\"\r\n        data-shape={sh}\r\n        data-ring={ring}\r\n        data-tone={tone}\r\n        data-anim={animation}\r\n        data-shadow={shadow}\r\n        role={showImg ? undefined : \"img\"}\r\n        aria-label={showImg ? undefined : label}\r\n        className={cn(\"pc-avatar relative inline-flex size-[var(--pc-av-s)] shrink-0 align-middle\", className)}\r\n        style={{ \"--pc-av-s\": `${PX[s]}px`, ...style } as React.CSSProperties}\r\n        {...props}\r\n      >\r\n        {ring !== \"none\" && <span className=\"pc-avatar-ring\" aria-hidden=\"true\" />}\r\n        {(ring !== \"none\" || group.inGroup) && <span className=\"pc-avatar-gap\" aria-hidden=\"true\" />}\r\n        <span\r\n          className=\"pc-avatar-face\"\r\n          data-initials={!showImg && text ? \"\" : undefined}\r\n          style={!showImg && text && name ? { background: avatarGradient(name) } : undefined}\r\n        >\r\n          {showImg ? (\r\n            // eslint-disable-next-line @next/next/no-img-element\r\n            <img\r\n              ref={imgRef}\r\n              src={src}\r\n              alt={label ?? \"\"}\r\n              className=\"pc-avatar-img\"\r\n              data-loaded={loaded ? \"\" : undefined}\r\n              onLoad={() => setLoaded(true)}\r\n              onError={() => setFailed(true)}\r\n              draggable={false}\r\n            />\r\n          ) : text ? (\r\n            <span aria-hidden=\"true\">{text}</span>\r\n          ) : (\r\n            (fallback ?? <User aria-hidden=\"true\" />)\r\n          )}\r\n        </span>\r\n        {status !== \"none\" && (\r\n          <span className=\"pc-avatar-status\" data-status={status} data-pulse={statusPulse ? \"\" : undefined}>\r\n            <span className=\"sr-only\">{l[status]}</span>\r\n          </span>\r\n        )}\r\n      </span>\r\n    </>\r\n  )\r\n}\r\n\r\nexport type AvatarGroupProps = React.ComponentProps<\"div\"> & {\r\n  /** Size for every avatar in the group. */\r\n  size?: AvatarSize\r\n  /** Shape for every avatar and the \"+N\" chip. */\r\n  shape?: AvatarShape\r\n  /** How much neighbours overlap. */\r\n  overlap?: \"none\" | \"sm\" | \"md\" | \"lg\"\r\n  /** Show at most this many avatars, then a \"+N\" chip. */\r\n  max?: number\r\n  /** Avatars fan out when the group is hovered. */\r\n  spread?: boolean\r\n  /** Shows each avatar's name above it on hover. */\r\n  tooltips?: boolean\r\n  /** Makes the \"+N\" chip a button. */\r\n  onMoreClick?: () => void\r\n  /** Text for built-in controls and screen readers; pass translations here. */\r\n  labels?: Partial<AvatarGroupLabels>\r\n}\r\n\r\nconst OVERLAP = { none: 0, sm: 0.18, md: 0.3, lg: 0.45 }\r\nconst SHAPE_RADIUS: Record<AvatarShape, string> = { circle: \"9999px\", rounded: \"24%\", square: \"9%\", squircle: \"30%\" }\r\n\r\nexport function AvatarGroup({\r\n  size = \"md\",\r\n  shape = \"circle\",\r\n  overlap = \"md\",\r\n  max,\r\n  spread = true,\r\n  tooltips,\r\n  onMoreClick,\r\n  labels,\r\n  className,\r\n  style,\r\n  children,\r\n  ...props\r\n}: AvatarGroupProps) {\r\n  const gl = useLabels(\"avatar-group\", DEFAULT_GROUP_LABELS, labels)\r\n  const all = React.Children.toArray(children).filter(React.isValidElement)\r\n  const shown = max !== undefined && all.length > max ? all.slice(0, max) : all\r\n  const extra = all.length - shown.length\r\n  const ctx = React.useMemo(() => ({ size, shape, inGroup: true }), [size, shape])\r\n  const moreStyle = { borderRadius: SHAPE_RADIUS[shape] }\r\n\r\n  return (\r\n    <AvatarGroupContext.Provider value={ctx}>\r\n      <GooduiTokens />\r\n      <style href=\"pc-avatar\" precedence=\"default\">\r\n        {CSS}\r\n      </style>\r\n      <div\r\n        data-slot=\"avatar-group\"\r\n        data-spread={spread ? \"\" : undefined}\r\n        data-tooltips={tooltips ? \"\" : undefined}\r\n        className={cn(\"pc-avatar-group\", className)}\r\n        style={{ \"--pc-av-s\": `${PX[size]}px`, \"--pc-ov\": OVERLAP[overlap], \"--pc-rg\": `${Math.max(1.5, PX[size] * 0.06)}px`, ...style } as React.CSSProperties}\r\n        {...props}\r\n      >\r\n        {shown.map((child, i) => {\r\n          const n = (child.props as { name?: string }).name\r\n          return (\r\n            <span key={child.key ?? i} className=\"pc-avatar-item\" data-name={tooltips ? n : undefined} style={{ \"--i\": i } as React.CSSProperties}>\r\n              {child}\r\n            </span>\r\n          )\r\n        })}\r\n        {extra > 0 && (\r\n          <span className=\"pc-avatar-item\" style={{ \"--i\": shown.length } as React.CSSProperties}>\r\n            {onMoreClick ? (\r\n              <button type=\"button\" className=\"pc-press pc-avatar-more outline-none focus-visible:ring-3 focus-visible:ring-ring/50\" style={moreStyle} onClick={onMoreClick} aria-label={gl.showMore(extra)}>\r\n                +{extra}\r\n              </button>\r\n            ) : (\r\n              <span className=\"pc-avatar-more\" style={moreStyle} aria-label={gl.more(extra)} role=\"img\">\r\n                +{extra}\r\n              </span>\r\n            )}\r\n          </span>\r\n        )}\r\n      </div>\r\n    </AvatarGroupContext.Provider>\r\n  )\r\n}\r\n",
      "type": "registry:component",
      "target": "components/goodui/avatar.tsx"
    }
  ],
  "categories": [
    "components",
    "core"
  ],
  "type": "registry:component"
}