# XWUISelect

Dropdown select with single/multi modes, search, grouping and clear support.

## Basic Usage

Single-select country picker.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Single-select country picker.
```

## Searchable

Type-to-filter combobox.

```example
file: examples/Searchable.ts
html: examples/Searchable.html
title: Searchable
description: Type-to-filter combobox.
```

## Grouped

Options grouped into sections.

```example
file: examples/Grouped.ts
html: examples/Grouped.html
title: Grouped
description: Options grouped into sections.
```

## Multiple

Multi-select dropdown.

```example
file: examples/Multiple.ts
html: examples/Multiple.html
title: Multiple
description: Multi-select dropdown.
```

## Async Options

Options loaded asynchronously with a loading state.

```example
file: examples/AsyncOptions.ts
html: examples/AsyncOptions.html
title: Async Options
description: Loads options after a fetch, swapping a loading placeholder for a live select.
```

## Custom Render

Rich option rows with a logo, label and grouped sections.

```example
file: examples/CustomRender.ts
html: examples/CustomRender.html
title: Custom Render
description: Brand logo + label rows organised into groups, with the logo echoed in the trigger.
```

## Disabled Options

Some options disabled with the reason shown inline.

```example
file: examples/DisabledOptions.ts
html: examples/DisabledOptions.html
title: Disabled Options
description: A plan picker where sold-out and sales-gated tiers stay visible but unselectable.
```

## Form Field

A labeled, required select inside a form with validation.

```example
file: examples/FormField.ts
html: examples/FormField.html
title: Form Field
description: Submitting with no selection shows an inline error; picking a value clears it.
```

```api
```