# LivaChart
Package: @dataliva/livalib
Description: @dataliva/livalib kartezyen grafik (bar, line, area) bileşeni.

DevExtreme'in Chart bileşenini saran ince bir katman. Bar, çizgi, alan gibi
kartezyen serileri `Series` alt bileşenleriyle çizer; eksen, lejant ve ipucu
yapılandırması da alt bileşenlerle yapılır. Sarmalayıcı yalnızca `className`
ve `style` prop'larını ekler, geri kalan tüm API DevExtreme Chart ile birebir
aynıdır.

```tsx
import {
  LivaChart,
  Series,
  CommonSeriesSettings,
  ArgumentAxis,
  ValueAxis,
  Legend,
  Title,
  Tooltip,
} from "@dataliva/livalib";
```

## Bar serisi

Tek bir seri için `Series` üzerinde `argumentField`, `valueField` ve `type`
belirtmek yeterlidir. Tek serili grafiklerde lejantı kapatmak iyi bir
alışkanlıktır; serinin adını başlık veya `name` taşır.

**Örnek — Bar serisi — aylık satış:**

```tsx
<LivaChart dataSource={aylikSatislar} height={320}>
  <Series argumentField="ay" valueField="satis" name="Satış (bin ₺)" type="bar" />
  <Legend visible={false} />
  <Tooltip enabled />
</LivaChart>
```

## Çizgi serileri ve lejant

Birden fazla seri çizerken ortak ayarlar `CommonSeriesSettings` ile bir kez
tanımlanır; her `Series` yalnızca kendi `valueField` ve `name` değerini verir.
`Legend` alt bileşeni lejantın konumunu belirler.

**Örnek — Çizgi serileri — iki bölge karşılaştırması:**

```tsx
<LivaChart dataSource={bolgeSatislari} height={320} palette="Soft Blue">
  <CommonSeriesSettings argumentField="ay" type="line" />
  <Series valueField="istanbul" name="İstanbul" />
  <Series valueField="ankara" name="Ankara" />
  <Legend verticalAlignment="bottom" horizontalAlignment="center" />
  <Tooltip enabled />
</LivaChart>
```

## Prop'lar

| Prop | Tip | Açıklama |
|------|------|---------|
| `dataSource` | `object[]` | Grafiğin veri kaynağı |
| `height` / `width` | `number \| string` | Grafik boyutları |
| `palette` | `string \| string[]` | Seri renk paleti (ör. `'Soft Blue'`) |
| `rotated` | `boolean` | Eksenleri döndürür (yatay bar için) |
| `className` | `string` | livalib'e özgü ek prop |
| `style` | `React.CSSProperties` | livalib'e özgü ek prop |

`Series`, `ArgumentAxis`, `ValueAxis`, `Legend`, `Title`, `Tooltip` ve
`CommonSeriesSettings` alt bileşenleri doğrudan `@dataliva/livalib`'den
alınır. Geri kalan tüm prop'lar DevExtreme `Chart`'tan miras alınır.