[Tracking] Decompose Avatar component

[mountiny]

Objective

Decompose the monolithic Avatar component into focused primitives so call sites use the right API and the legacy Avatar shell (with type forking) can eventually be removed.

Milestones

M1 — Split Avatar into primitives

Extract AvatarUser, AvatarWorkspace, AvatarImage, AvatarIcon, AvatarInitials, source/error hooks, and shared types. Keep Avatar/index.tsx as a backward-compatible facade.

PR: #95050

M2 — Unify avatar sizes

Consolidate CONST.AVATAR_SIZE naming (remove confusing names like LARGE_BORDERED, LARGE_NORMAL, one-off sizes). Apply border styling separately from size enum. Touches ~70+ files.

PR: #95275
Origin: #94682 (comment)

M3 — Migrate Workspace Avatar usages

Replace Avatar + type={CONST.ICON_TYPE_WORKSPACE} call sites with direct AvatarWorkspace usage. Remove workspace branch from facade once migrated (~10 call sites).

M4 — Migrate User Avatar usages

Replace Avatar + type={CONST.ICON_TYPE_AVATAR} call sites with direct AvatarUser usage. Remove user branch and type prop from facade once migrated (~34 call sites).

Sub-issues

• [Due for payment 2026-07-17] [M1] Split Avatar into primitives #95597 — [M1] Split Avatar into primitives
• [M2] Unify avatar sizes #95598 — [M2] Unify avatar sizes
• [M3] Migrate Workspace Avatar usages #95599 — [M3] Migrate Workspace Avatar usages
• [M4] Migrate User Avatar usages #95600 — [M4] Migrate User Avatar usages

Related code

• src/components/Avatar.tsx → src/components/Avatar/ after M1
• src/styles/utils/index.ts (getAvatarSize, getAvatarStyle, getAvatarBorderStyle)
• src/CONST/index.ts (AVATAR_SIZE)

Related tracking

• [Tracking] Decompose ReportActionAvatars into layered avatar components #94584 — ReportActionAvatars layered decomposition (separate scope)
• [Tracking] Decompose Icon component #95157 — Icon decomposition (Avatar depends on Icon)

Issue Owner

Current Issue Owner: @jmusial