# LivaLoadPanel
Package: @dataliva/livalib
Description: @dataliva/livalib tam sayfa yükleme göstergesi bileşeni.

Uzun süren işlemler sırasında ekranı kaplayan yükleme göstergesi. `visible`
prop'u ile kontrol edilir; varsayılan olarak yarı saydam bir gölgeleme ve
dönen bir gösterge (spinner) içerir. `position.of` ile belirli bir elemanın
üzerine de konumlandırılabilir.

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

## Temel Kullanım

Butona basıldığında panel görünür olur; `setTimeout` tıklama işleyicisinin
içinde kurulur ve 2 saniye sonra paneli kapatır. Gerçek uygulamada bu süre,
bir API çağrısının tamamlanmasına karşılık gelir.

**Örnek — 2 saniyelik yükleme göstergesi:**

```tsx
const [loading, setLoading] = useState<boolean>(false);

<LivaButton
  text="Yüklemeyi Başlat"
  onClick={() => {
    setLoading(true);
    setTimeout(() => setLoading(false), 2000);
  }}
/>

{loading && <LivaLoadPanel visible />}
```

## Bulanık Arka Plan

`blurBackground` arka plandaki içeriği bulanıklaştırır; `blurAmount`
bulanıklık şiddetini (piksel), `blurTintColor` ise bulanık katmanın renk
tonunu belirler.

**Örnek — Bulanık arka plan:**

```tsx
const [loading, setLoading] = useState<boolean>(false);

<LivaButton
  text="Bulanık Yükleme (2 sn)"
  variant="outlined"
  onClick={() => {
    setLoading(true);
    setTimeout(() => setLoading(false), 2000);
  }}
/>

{loading && (
  <LivaLoadPanel
    visible
    blurBackground
    blurAmount={8}
    blurTintColor="rgba(15, 23, 42, 0.15)"
  />
)}
```

## Prop'lar

| Prop | Tip | Varsayılan |
|------|------|---------|
| `visible` | `boolean` | `false` |
| `shading` | `boolean` | `true` |
| `shadingColor` | `string` | `'rgba(0,0,0,0.4)'` |
| `showPane` | `boolean` | `true` |
| `showIndicator` | `boolean` | `true` |
| `hideOnOutsideClick` | `boolean` | `false` |
| `position` | `PanelPosition` | tüm pencere |
| `indicator` | `ReactNode` | — |
| `blurBackground` | `boolean` | `false` |
| `blurAmount` | `number` | `6` |
| `blurTintColor` | `string` | `'rgba(0,0,0,0.06)'` |
| `onShown` | `() => void` | — |
| `onHiding` | `() => void` | — |
| `onHidden` | `() => void` | — |

`PanelPosition` alanları: `of` (hedef eleman ya da seçici), `my`, `at`,
`offsetX`, `offsetY`. `hideOnOutsideClick` açıkken gölgelemeye tıklanınca
`onHiding` tetiklenir.