{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "avatar-group",
  "title": "Avatar Group",
  "description": "A stacked group of avatars with photo or initials, an overflow +N bubble, hover lift with name tooltips, a spread-on-hover animation, 5 sizes and adjustable overlap.",
  "dependencies": [
    "motion",
    "clsx",
    "tailwind-merge"
  ],
  "files": [
    {
      "path": "registry/new-york/avatar-group/avatar-group.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { motion, AnimatePresence } from \"motion/react\";\nimport { clsx, type ClassValue } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nfunction cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n\nexport type AvatarGroupSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\nexport type AvatarGroupShape = \"circle\" | \"rounded\";\n\nexport interface AvatarGroupUser {\n  name: string;\n  src?: string;\n}\n\nexport interface AvatarGroupProps {\n  users?: AvatarGroupUser[];\n  max?: number;\n  size?: AvatarGroupSize | number;\n  shape?: AvatarGroupShape;\n  overlap?: number;\n  expandOnHover?: boolean;\n  showTooltip?: boolean;\n  theme?: \"dark\" | \"light\";\n  onOverflowClick?: () => void;\n  className?: string;\n}\n\nconst SIZE_PX: Record<AvatarGroupSize, number> = { xs: 24, sm: 32, md: 44, lg: 56, xl: 72 };\nconst FALLBACK_COLORS = [\"#87FFE3\", \"#F2A841\", \"#FF7A6B\", \"#8FB8FF\", \"#B8A6FF\", \"#F59EC5\", \"#C4F26B\"];\n\nconst DEFAULT_USERS: AvatarGroupUser[] = [\n  { name: \"Ada Lovelace\" },\n  { name: \"Grace Hopper\" },\n  { name: \"Alan Turing\" },\n  { name: \"Katherine Johnson\" },\n  { name: \"Margaret Hamilton\" },\n  { name: \"Linus Torvalds\" },\n];\n\nfunction hash(str: string) {\n  let h = 0;\n  for (let i = 0; i < str.length; i++) h = (h * 31 + str.charCodeAt(i)) | 0;\n  return Math.abs(h);\n}\n\nfunction initialsOf(name: string) {\n  const parts = name.trim().split(/\\s+/).filter(Boolean);\n  if (parts.length === 0) return \"\";\n  if (parts.length === 1) return parts[0].slice(0, 2).toUpperCase();\n  return (parts[0][0] + parts[parts.length - 1][0]).toUpperCase();\n}\n\nfunction Face({ user, px, radius, cut }: { user: AvatarGroupUser; px: number; radius: string | number; cut: string }) {\n  const [failed, setFailed] = React.useState(false);\n  const [loaded, setLoaded] = React.useState(false);\n  const [prevSrc, setPrevSrc] = React.useState(user.src);\n  if (user.src !== prevSrc) {\n    setPrevSrc(user.src);\n    setFailed(false);\n    setLoaded(false);\n  }\n  const showImage = Boolean(user.src) && !failed;\n  return (\n    <span\n      className=\"relative flex items-center justify-center overflow-hidden font-semibold\"\n      style={{ width: px, height: px, borderRadius: radius, background: showImage && loaded ? \"transparent\" : FALLBACK_COLORS[hash(user.name) % FALLBACK_COLORS.length], color: \"#0A0A0A\", fontSize: px * 0.36, fontFamily: \"Inter, sans-serif\", boxShadow: `0 0 0 ${Math.max(2, px * 0.06)}px ${cut}` }}\n    >\n      {showImage && (\n        // eslint-disable-next-line @next/next/no-img-element\n        <img\n          ref={(el) => {\n            if (el?.complete) {\n              if (el.naturalWidth > 0) setLoaded(true);\n              else setFailed(true);\n            }\n          }}\n          src={user.src}\n          alt={user.name}\n          draggable={false}\n          onLoad={() => setLoaded(true)}\n          onError={() => setFailed(true)}\n          className=\"absolute inset-0 h-full w-full object-cover\"\n          style={{ opacity: loaded ? 1 : 0, transition: \"opacity 0.3s ease\" }}\n        />\n      )}\n      {(!showImage || !loaded) && initialsOf(user.name)}\n    </span>\n  );\n}\n\nexport function AvatarGroup({ users = DEFAULT_USERS, max = 4, size = \"md\", shape = \"circle\", overlap = 0.2, expandOnHover = true, showTooltip = true, theme = \"dark\", onOverflowClick, className }: AvatarGroupProps) {\n  const px = typeof size === \"number\" ? size : SIZE_PX[size];\n  const cut = theme === \"dark\" ? \"#0E0E0E\" : \"#FFFFFF\";\n  const radius = shape === \"circle\" ? \"50%\" : px * 0.28;\n  const visible = users.slice(0, max);\n  const extra = users.length - visible.length;\n  const [groupHover, setGroupHover] = React.useState(false);\n  const [hoverIdx, setHoverIdx] = React.useState<number | null>(null);\n  const gap = -px * overlap;\n  const spread = expandOnHover && groupHover ? gap * 0.35 : gap;\n  const tipBg = theme === \"dark\" ? \"#F5F4F1\" : \"#0A0A0A\";\n  const tipText = theme === \"dark\" ? \"#0A0A0A\" : \"#F5F4F1\";\n\n  return (\n    <div\n      role=\"group\"\n      aria-label={`${users.length} people`}\n      className={cn(\"inline-flex items-center\", className)}\n      style={{ padding: 4 }}\n      onMouseEnter={() => setGroupHover(true)}\n      onMouseLeave={() => {\n        setGroupHover(false);\n        setHoverIdx(null);\n      }}\n    >\n      {visible.map((user, i) => (\n        <motion.div\n          key={`${user.name}-${i}`}\n          className=\"relative\"\n          style={{ zIndex: hoverIdx === i ? visible.length + 2 : visible.length - i }}\n          animate={{ marginLeft: i === 0 ? 0 : spread, y: hoverIdx === i ? -4 : 0, scale: hoverIdx === i ? 1.08 : 1 }}\n          transition={{ type: \"spring\", stiffness: 420, damping: 28 }}\n          onMouseEnter={() => setHoverIdx(i)}\n          onMouseLeave={() => setHoverIdx(null)}\n          title={showTooltip ? undefined : user.name}\n        >\n          <Face user={user} px={px} radius={radius} cut={cut} />\n          <AnimatePresence>\n            {showTooltip && hoverIdx === i && (\n              <motion.span\n                className=\"pointer-events-none absolute left-1/2 rounded-md font-semibold whitespace-nowrap\"\n                style={{ bottom: \"100%\", marginBottom: 8, x: \"-50%\", padding: \"4px 8px\", background: tipBg, color: tipText, fontSize: 12, fontFamily: \"Inter, sans-serif\", zIndex: 50 }}\n                initial={{ opacity: 0, y: 4, scale: 0.9 }}\n                animate={{ opacity: 1, y: 0, scale: 1 }}\n                exit={{ opacity: 0, y: 4, scale: 0.9 }}\n                transition={{ duration: 0.14 }}\n              >\n                {user.name}\n              </motion.span>\n            )}\n          </AnimatePresence>\n        </motion.div>\n      ))}\n\n      {extra > 0 && (\n        <motion.button\n          type=\"button\"\n          aria-label={`${extra} more`}\n          onClick={onOverflowClick}\n          className=\"relative flex shrink-0 items-center justify-center border-none font-semibold outline-none focus-visible:ring-2\"\n          style={{ zIndex: 0, width: px, height: px, borderRadius: radius, cursor: onOverflowClick ? \"pointer\" : \"default\", background: theme === \"dark\" ? \"#1C1C1C\" : \"#F0F0F0\", color: theme === \"dark\" ? \"rgba(245,244,241,0.75)\" : \"rgba(10,10,10,0.65)\", fontSize: px * 0.34, fontFamily: \"Inter, sans-serif\", boxShadow: `0 0 0 ${Math.max(2, px * 0.06)}px ${cut}` }}\n          animate={{ marginLeft: spread }}\n          transition={{ type: \"spring\", stiffness: 420, damping: 28 }}\n          whileHover={onOverflowClick ? { scale: 1.06 } : undefined}\n        >\n          +{extra}\n        </motion.button>\n      )}\n    </div>\n  );\n}\n",
      "type": "registry:component"
    }
  ],
  "type": "registry:component"
}