# LivaBullet
Package: @dataliva/livalib
Description: @dataliva/livalib hedef karşılaştırmalı mini gösterge (bullet) bileşeni.

DevExtreme'in Bullet bileşenini saran ince bir katman. Tek bir değeri hedef
çizgisiyle birlikte kompakt bir çubukta gösterir; tablo satırlarında KPI
karşılaştırması için tasarlanmıştır. Fareyle üzerine gelindiğinde değer ve
hedefi gösteren ipucu varsayılan olarak açıktır.

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

## Temel kullanım

`value` çubuğun uzunluğunu, `target` dikey hedef çizgisinin konumunu belirler.
Ölçek `startScaleValue` ve `endScaleValue` ile sabitlenir; satırlar arası
karşılaştırma için tüm satırlarda aynı ölçek kullanılmalıdır.

**Örnek — Hedef vs gerçekleşen:**

```tsx
<LivaBullet
  startScaleValue={0}
  endScaleValue={120}
  value={85}
  target={100}
  width={300}
  height={40}
/>
```

## Tablo içinde kullanım

Her satır kendi `value` / `target` çiftini alır; ortak ölçek sayesinde
çubuk uzunlukları satırlar arasında doğrudan karşılaştırılabilir.

**Örnek — Tablo satırlarında mini göstergeler:**

```tsx
<table className="w-full text-sm">
  <thead>
    <tr className="border-b border-zinc-200 text-left dark:border-zinc-800">
      <th className="py-2">Bölge</th>
      <th className="py-2">Hedefe Göre Durum</th>
      <th className="py-2 text-right">Gerçekleşen / Hedef</th>
    </tr>
  </thead>
  <tbody>
    {bolgePerformanslari.map((b) => (
      <tr key={b.bolge} className="border-b border-zinc-100 dark:border-zinc-900">
        <td className="py-2">{b.bolge}</td>
        <td className="py-2">
          <LivaBullet
            startScaleValue={0}
            endScaleValue={120}
            value={b.gerceklesen}
            target={b.hedef}
            width={200}
            height={30}
          />
        </td>
        <td className="py-2 text-right">
          {b.gerceklesen} / {b.hedef}
        </td>
      </tr>
    ))}
  </tbody>
</table>
```

## Prop'lar

| Prop | Tip | Açıklama |
|------|------|---------|
| `value` | `number` | Gerçekleşen değer |
| `target` | `number` | Hedef çizgisinin değeri |
| `startScaleValue` | `number` | Ölçek başlangıcı, varsayılan `0` |
| `endScaleValue` | `number` | Ölçek sonu |
| `showTarget` | `boolean` | Hedef çizgisini gösterir, varsayılan `true` |
| `showZeroLevel` | `boolean` | Sıfır çizgisini gösterir, varsayılan `true` |
| `color` | `string` | Çubuk rengi |
| `targetColor` | `string` | Hedef çizgisi rengi |
| `height` / `width` | `number \| string` | Gösterge boyutları |
| `className` | `string` | livalib'e özgü ek prop |
| `style` | `React.CSSProperties` | livalib'e özgü ek prop |

Geri kalan tüm prop'lar DevExtreme `Bullet`'tan miras alınır.
