# XWUICheckbox

Checkbox input with an optional label and description, three sizes (`sm`/`md`/`lg`), four color variants (`primary`/`success`/`warning`/`error`), plus disabled and tri-state `indeterminate` support. Exposes `setChecked`, `toggle`, `setIndeterminate`, `setDisabled` and an `onChange` callback for form and selection interfaces.

## Basic Usage

Standard labelled checkbox.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Standard labelled checkbox.
```

## Colors

The primary, success, warning and error color variants.

```example
file: examples/Colors.ts
html: examples/Colors.html
title: Colors
description: primary / success / warning / error.
```

## Disabled

A checked but non-interactive checkbox.

```example
file: examples/Disabled.ts
html: examples/Disabled.html
title: Disabled
description: Non-interactive state.
```

## Indeterminate

Tri-state "select all" indicator showing partial selection.

```example
file: examples/Indeterminate.ts
html: examples/Indeterminate.html
title: Indeterminate
description: Tri-state "select all" indicator.
```

## Checkbox Group

A managed group of related checkboxes.

```example
file: examples/CheckboxGroup.ts
html: examples/CheckboxGroup.html
title: Checkbox Group
description: A managed group backed by a single value set, reporting the live selection.
```

## Select All

A parent "select all" with indeterminate state driven by its children.

```example
file: examples/SelectAll.ts
html: examples/SelectAll.html
title: Select All
description: Parent reflects children as checked / unchecked / indeterminate and cascades on click.
```

## Consent Form

Consent checkboxes gating a submit button.

```example
file: examples/ConsentForm.ts
html: examples/ConsentForm.html
title: Consent Form
description: Submit stays disabled until both the terms and privacy boxes are checked.
```

## Card Choice

Checkboxes styled as selectable cards.

```example
file: examples/CardChoice.ts
html: examples/CardChoice.html
title: Card Choice
description: Add-on checkboxes as a responsive grid of cards that highlight when checked.
```

```api
```