# LivaCheckBox
Package: @dataliva/livalib
Description: @dataliva/livalib onay kutusu bileşeni.

DevExtreme'in CheckBox bileşeni üzerine kurulu; renk için `variant`, boyut
için `size` ve yanında görünen metin için `text` prop'larıyla genişletilmiş
bir onay kutusu.

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

## Renk varyantları

`variant` prop'u işaretli durumdaki rengi belirler.

**Örnek — Renk varyantları:**

```tsx
<LivaCheckBox text="Primary" variant="primary" defaultValue={true} />
<LivaCheckBox text="Secondary" variant="secondary" defaultValue={true} />
<LivaCheckBox text="Success" variant="success" defaultValue={true} />
<LivaCheckBox text="Warning" variant="warning" defaultValue={true} />
<LivaCheckBox text="Danger" variant="danger" defaultValue={true} />
```

## Boyutlar

**Örnek — Boyutlar:**

```tsx
<LivaCheckBox text="Small" size="small" defaultValue={true} />
<LivaCheckBox text="Medium" size="medium" defaultValue={true} />
<LivaCheckBox text="Large" size="large" defaultValue={true} />
```

## Kontrollü değer

`value` ve `onValueChanged` ile bileşen React state'ine bağlanır.

**Örnek — Kontrollü değer:**

```tsx
const [kabul, setKabul] = useState<boolean>(false);

<LivaCheckBox
  text="Koşulları kabul ediyorum"
  value={kabul}
  onValueChanged={(e: { value: boolean }) => setKabul(e.value)}
/>
<span>{kabul ? "Kabul edildi" : "Onay bekleniyor"}</span>
```

## Durumlar

`disabled` bileşeni kapatır; `hint` üzerine gelindiğinde ipucu gösterir,
`label` ile `required` alan etiketi ve yıldız ekler.

**Örnek — Durumlar:**

```tsx
<LivaCheckBox text="Devre dışı" disabled />
<LivaCheckBox text="Devre dışı (seçili)" defaultValue={true} disabled />
<LivaCheckBox text="İpucu ile" hint="Onaylamak için işaretleyin" />
<LivaCheckBox text="KVKK onayı" label="Sözleşmeler" required />
```

## Prop'lar

| Prop | Tip | Varsayılan |
|------|------|---------|
| `value` | `boolean` | — |
| `text` | `string` | — |
| `onValueChanged` | `(e) => void` | — |
| `variant` | `'primary' \| 'secondary' \| 'success' \| 'warning' \| 'danger'` | `'primary'` |
| `size` | `'small' \| 'medium' \| 'large'` | `'medium'` |
| `label` | `string` | — |
| `labelPosition` | `LabelPosition` | `'top-start'` |
| `labelWidth` | `number \| string` | — |
| `disabled` | `boolean` | `false` |
| `required` | `boolean` | `false` |
| `hint` | `string` | — |
| `className` | `string` | — |

Ayrıca DevExtreme `ICheckBoxOptions`'tan gelen tüm prop'lar (ör.
`defaultValue`, `readOnly`).