# LivaBreadcrumb
Package: @dataliva/livalib
Description: @dataliva/livalib içerik haritası (breadcrumb) bileşeni.

Kullanıcının sayfa hiyerarşisindeki konumunu gösteren, erişilebilir
(`nav` + `aria-current`) bir içerik haritası bileşeni. Öğeler `href` ile
bağlantı, `onClick` ile buton ya da hiçbiri verilmeden düz metin olarak
işlenir.

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

## Temel kullanım

Son öğeye `current: true` verilir; bu öğe bağlantı yerine
`aria-current="page"` özellikli bir metin olarak gösterilir.

**Örnek — Temel kullanım:**

```tsx
<LivaBreadcrumb
  items={[
    { key: "home", label: "Ana Sayfa", href: "#" },
    { key: "raporlar", label: "Raporlar", href: "#" },
    { key: "satis", label: "Satış Raporu", current: true },
  ]}
/>
```

## Özel ayraç ve onClick

`separator` herhangi bir `ReactNode` alabilir. `href` yerine yalnızca
`onClick` verilen öğeler buton olarak işlenir; yönlendirmeyi kendiniz
yapabilirsiniz (ör. router ile).

**Örnek — Özel ayraç ve onClick:**

```tsx
<LivaBreadcrumb
  separator="/"
  ariaLabel="Sayfa yolu"
  items={[
    { key: "home", label: "Ana Sayfa", onClick: () => alert("Ana Sayfa") },
    { key: "butce", label: "Bütçe", onClick: () => alert("Bütçe") },
    { key: "detay", label: "Gider Detayı", current: true },
  ]}
/>
```

## Statik öğeler

`href` ve `onClick` verilmeyen öğeler tıklanamaz düz metin olarak kalır.

**Örnek — Bağlantısız (statik) öğeler:**

```tsx
<LivaBreadcrumb
  separator="›"
  items={[
    { key: "modul", label: "Bütçe Modülü" },
    { key: "donem", label: "2026 Dönemi" },
    { key: "ozet", label: "Özet", current: true },
  ]}
/>
```

## Prop'lar

| Prop | Tip | Varsayılan |
|------|------|---------|
| `items` | `LivaBreadcrumbItem[]` | — (zorunlu) |
| `separator` | `ReactNode` | `'»'` |
| `className` | `string` | `''` |
| `ariaLabel` | `string` | `'Breadcrumb'` |

### LivaBreadcrumbItem alanları

| Alan | Tip | Varsayılan |
|------|------|---------|
| `label` | `ReactNode` | — (zorunlu) |
| `key` | `string \| number` | dizi indeksi |
| `href` | `string` | — |
| `onClick` | `(event) => void` | — |
| `current` | `boolean` | `false` |