# LivaAvatarCard
Package: @dataliva/livalib
Description: @dataliva/livalib kullanıcı avatar kartı bileşeni.

Oturum açan kullanıcıyı temsil eden avatar kartı. Resim kullanmaz; avatar
dairesi, ad soyaddan türetilen baş harflerle çizilir (ör. Ayşe Yılmaz için
AY). Karta bağlı açılır menüde özel eylemler (`cardActions`) ve çıkış
bağlantısı gösterilebilir. Genellikle `LivaLayout` başlığında kullanılır.

```tsx
import { LivaAvatarCard } from "@dataliva/livalib";
```

## Standart Mod

Varsayılan mod avatar, ad soyad ve üç nokta menü butonunu birlikte gösterir.
`showLogout` varsayılan olarak açıktır; kapatıldığında ve eylem de yoksa menü
butonu tamamen gizlenir.

**Örnek — Standart mod — baş harf avatarı, isim ve rol:**

```tsx
<LivaAvatarCard
  user={{ FullName: "Ayşe Yılmaz", Role: "Bütçe Yöneticisi" }}
/>
<LivaAvatarCard
  user={{ FullName: "Mehmet Demir", Role: "Finans Uzmanı" }}
  showLogout={false}
/>
```

## Compact Mod

`mode="compact"` yalnızca avatar dairesini gösterir. Daireye tıklanınca açılan
menünün başlığında ad soyad ve rol yer alır.

**Örnek — Compact mod — yalnızca avatar dairesi:**

```tsx
<LivaAvatarCard
  user={{ FullName: "Zeynep Kaya", Role: "Sistem Yöneticisi" }}
  mode="compact"
/>
<LivaAvatarCard
  user={{ FullName: "Ali Can Öztürk", Role: "Raporlama Sorumlusu" }}
  mode="compact"
/>
```

## Menü Eylemleri

`cardActions` dizisindeki her öğe menüye bir satır ekler; `icon` alanı
DevExtreme simge adlarını kabul eder. `onLogoutClick` menüdeki çıkış
satırına bağlanır. Üç nokta butonuna tıklayıp bir eylem seçin.

**Örnek — Menü eylemleri (cardActions):**

```tsx
const [lastAction, setLastAction] = useState<string>("henüz yok");

<LivaAvatarCard
  user={{ FullName: "Elif Arslan", Role: "Bölge Müdürü" }}
  cardActions={[
    { label: "Profil", icon: "user", onClick: () => setLastAction("Profil") },
    { label: "Ayarlar", icon: "preferences", onClick: () => setLastAction("Ayarlar") },
  ]}
  onLogoutClick={() => setLastAction("Çıkış")}
/>
<span style={{ fontSize: 13 }}>Son tıklanan eylem: {lastAction}</span>
```

## Prop'lar

| Prop | Tip | Varsayılan |
|------|------|---------|
| `user` | `{ FullName: string \| null; Role?: string \| null }` | — (zorunlu) |
| `user.FullName` | `string \| null` | `'User'` (boşsa) |
| `user.Role` | `string \| null` | `'Member'` (boşsa) |
| `mode` | `'compact' \| 'standard'` | `'standard'` |
| `showLogout` | `boolean` | `true` |
| `onLogoutClick` | `() => void` | — |
| `cardActions` | `AvatarCardAction[]` | — |
| `cardActions[].label` | `string` | — (zorunlu) |
| `cardActions[].icon` | `string` | — |
| `cardActions[].onClick` | `() => void` | — (zorunlu) |